pmw

Langue: en

Version: 112980 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

Sommaire

NAME

pmw - a program for typesetting music

SYNOPSIS

pmw [options] [input file]

DESCRIPTION

PMW (Philip's Music Writer) is a program for typesetting music. It is not an interactive program; instead, it reads a description of the music from a textual input file, which can be prepared by any text editor. The output from PMW is a PostScript file of page images of typeset music. The output uses the PMW-Music PostScript font, which must therefore be avaiable for viewing or printing.

A full description of PMW and its markup language is given in the reference manual. This man page just summarizes the command line options.

OPTIONS

-a4ona3
The pages are A4-sized; print them 2-up, assuming A3 paper.
-a5ona4
The pages are A5-sized; print them 2-up, assuming A4 paper.
-a4sideways
The paper is A4, but the printer feeds it sideways, so rotate the page images before printing.
-c <number>
Print <number> copies.
-debug
Write debugging information to stderr (not currently very comprehensive).
-eps
Write the output as encapsulated PostScript (useful if this is an illustration that is going to be included in some other document).
-F <directory>
Use the given directory as the fontmetrics directory, instead of the default that was set up when PMW was built.
-f <name>
Specifies a format name, used when the input file is set up to output in several different formats.
-H <file>
Use the given file as the PostScript header file, instead of the default that was set up when PMW was built.
-help
Output a list of options, then stop. No file is read.
-MP <file>
Use the given file as the MIDIperc file, instead of the default that was set up when PMW was built. This file translates between names and "pitches" for untuned percussion voices.
-MV <file>
Use the given file as the MIDIvoices file, instead of the default that was set up when PMW was built. This file translates voice names to MIDI voice numbers.
-midi <file>
Write MIDI output to the given file (in addition to the normal PostScript output). The stave selection (see -s below) also applies to MIDI output.
-midibars <range>
If -midi is given, write only the given bars to the MIDI output. The range can be two numbers separated by a hyphen or a single number for just one bar. A single number followed by a hyphen plays from that bar to the end of the movement. -mb is an abbreviation for -midibars.
-midimovement <number
For a multi-movement input file, this specifies the movement that is to be output as MIDI when -midi is given. The default is the first movement. -mm is an abbreviation for -midimovement.
-norepeats
When generating a MIDI output file, do not repeat repeated sections of the music. -nr is an abbreviation for -norepeats.
-o <file>
Send the output to the given file, or, if "-" is given, to stdout. The default file name is the input file with the extension ".ps" replacing any existing extension, or being added if there is no extension. If there is no input file (input from stdin) the default output is to stdout.
-p <list>
Output only the specified pages. These can be individual page numbers, or pairs of numbers separated by a hyphen, to specify a range. Use commas to separate items in the list.
-pamphlet
Output pages in pamphlet order. This is usually used in conjunction with -a5ona4 or -a4ona3.
-printadjust <x> <y>
Move the image on the page by (x,y) points.
-printscale <n>
Scale the output image by <n>.
-printside <n>
Output only odd or only even pages; <n> must either be 1 or 2.
-reverse
Output the pages in reverse order.
-s <list>
Output only the specified staves. These can be individual stave numbers, or pair of numbers separated by a hyphen, to specify a range. Use commas to separate items in the list.
-t <number>
Specify a transposition, in semitones.
-V
Output the PMW version number to stdout, then stop. No file is read.
-v
Output verification information about the typesetting to stderr.

EXAMPLES


  pmw myscore
  pmw -format A5 -a5ona4 -pamphlet myscore 
  pmw -s 3 -o quartet.ps-viola quartet.pmw 

AUTHOR

Philip Hazel <ph10@cam.ac.uk>

Last updated: 06 March 2004
Copyright (c) 2004 Philip Hazel End of file