|
|
|
PDFtoMusic enables to convert or hear PDF files
without using the graphical user interface (GUI).
It is ran through a command line.
This operating mode is especially intended to
be used by visually impaired people, who cannot
navigate within the interface.
On Macintosh
:
When the program is installed, a p2mp command is
created in the Applications folder.
Run the terminal and enter
/Applications/p2mp followed by the complete name of
the PDF file to process.
On Linux
:
When the program is installed, a p2mp command is
created in the /usr/bin folder.
Run the terminal and enter
p2mp followed by the complete name of
the PDF file to process.
On Windows :
A command called p2mp is available in the program
install folder ("PDFtoMusic Pro" subfolder in
"C:\Program Files" or "C:\Program Files (x86)").
From an MS/DOS command window, move to this folder
then enter p2mp followed by the complete
name of the PDF file to process.
By default, the result file is created at
the same level as the PDF file.
This way of working
is provided for your personal purpose only. Using
it in an automated system for the benefit of a
third party is strictly forbidden.
Here are the available options:
-h,
--help |
display this
help |
|
-v
language
|
(EN,FR) turn
verbose output on |
default: off
|
-firstpage nnn |
first page to
process
|
default: 1
|
-lastpage nnn |
last page to
process
|
default:
document's last
|
-password
pass
|
password for
protected PDF
|
default: none
|
-signal unique_id
|
provide an unique ID for
slave computing (see below for all details)
|
default: none
|
-pathdest target_folder |
path where to
create result files
|
default: same
as the PDF file |
-pathtemp
target_folder
|
path where to create
temporary files
|
default: temp system folder
|
-format name |
XML,MXL,MYR,MID,KAR,
WAV,AIFF,MP3,OGG,BMP,
MYRWEB,SVG,SVGM,NONE |
default: XML
for PDFtoMusic Pro, MYR for PDFtoMusic
|
-multivoices n |
0 or 1
|
default: 1 |
-chords n
|
0 or 1
|
default: 1
|
-enhancedchords n |
0 or
1
|
default: 1 |
-tuplets
n
|
0 or 1 |
default: 1 |
-fingering
n |
0 or 1 |
default: 1 |
-keychanges
n
|
0 or 1 |
default: 1 |
-timesignaturechanges n |
0 or 1 |
default: 1 |
-lyrics n |
0 or 1 |
default: 1 |
-sharedlyrics
|
0 or 1
|
default: 1
|
-clefshift
n |
0 or 1 |
default: 1 |
-complexlines n
|
0 or 1
|
default: 0
|
-thinbeams n
|
0 or 1
|
default: 0
|
-breakadjust n
|
0 or 1
|
default: 1
|
-multirest n |
0 or 1 |
default: 1 |
-shortbar n |
0 or 1 |
default: 0 |
-leadgerlines n
|
0 or 1 |
default: 1 |
-tempi n |
0 or 1 |
default: 1 |
-dynamics n |
0 or 1 |
default: 1 |
-groupname n |
0 or 1 |
default: 1 |
-bracketgroup |
0 or 1 |
default: 0
|
-modernnotation n |
0 or 1 |
default: 0
|
-matchlevel n |
0 to 3
|
default: 2
|
-highdef
n |
0 or 1 |
default: 0
|
-register
xxxx |
xxxx is your
personal registration number |
|
-vs n
|
Virtual Singer activity, 0 or
1
|
default: 1
|
-play |
the result is
played once the PDF has
been processed |
default:
inactive
|
MyrWeb setup :
-mw_displayScore n: 0 or 1
|
(default 1) |
-mw_embedAllViews n: 0 or 1
|
(default 1) |
-mw_displayLyrics n: 0 or 1
|
(default 1) |
-mw_exportMp3 n: 0 or 1
|
(default 1) |
-mw_exportOgg n: 0 or 1
|
(default 0) |
-mw_exportWav n: 0 or 1
|
(default 0) |
-mw_seeKeyboard n: 0 or 1
|
(default 1) |
-mw_embedOriginal n: 0 or 1
|
(default 1) |
-mw_embedMXL n: 0 or 1
|
(default 0) |
-mw_embedXML n: 0 or 1
|
(default 0) |
-mw_embedMID n: 0 or 1
|
(default 0) |
-mw_embedMYR n: 0 or 1
|
(default 1) |
-mw_metronome n: 0 or 1
|
(default 1) |
-mw_compressData n: 0 or 1
|
(default 1) |
-mw_exportQuality n: 0 to 4
|
(default 2) |
-mw_autoGroups n: 0 or 1
|
(default 0) |
-mw_commands string
|
|
Slave Mode :
The "-signal" option allow to launch PDFtoMusic or
PDFtoMusic PRO from an external program, called
Father.
From the PDF file name provided (with a full path) a
result file will be generated.
Additionnaly, an additional file will be created to
inform the father about the computation status.
The parameter unique_id guaranteed multiple
simultaneous tasks using PDFtoMusic as Son, will not
collide.
Unique_id will determine the name of the additional
file created. The path to this file will be
-pathdest.
For example, if unique_id is "1962", PDFtoMusic will
create a file "C2F_1962.txt" and log every step of
the process. It is up to the caller to regularly
scan the presence of this file and delete it
immediately after reading.
It contains either :
- !DONE!=xxx to indicate that the processing is
ended
xxx value
can be:
0 Result file succesfully created
1 Document is password protected
2 Copy is not allowed
3 Can't extract text encoding
4 This is not a PDF file or the file is
damaged
5 There is no exploitable music data in this
file
|
-!PID! = xxxx, where xxxx is the PDFtoMusic PID
- The caption of the step
|
|
|