Previous page    PDFtoMusic Pro    Next page 
 

Introduction
How to generate a PDF?
Menus
Document
Preferences
Expert mode
Kooplet search
Command Line version
Amendments
Mixer
Virtual Keyboard
Lyrics following
Annotations
What's new?
Limits
FAQ
Appendices
Problem report
Software license
Order
Greetings
Printable manual


symbol marks changed chapters.

 

Command line version


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 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


(c) Myriad 2007-2017 - All rights reserved