1YAPS(1) General Commands Manual YAPS(1)
2
6 YAPS - converts an abc file to a PostScript file
7
9 yaps abc file [-d] [-e <list>] [-E] [-l] [-M XXXxYYY] [-N] [-k nn] [-o
10 file name] [-P -ss] [-s XX] [-V][-ver] [-x] [-OCC]
11
15 -d For debugging only. Displays the internal data structures used
16 in the program.
17 -e <list>
19 Draws tunes with reference numbers in a comma separated list.
20 Spaces are not allowed but a range of reference numbers can be
21 specified. For example, 1,3,7-10.
22 -E Generates Encapsulated Postscript output.
24 -M XXXxYYY
26 Set margin sizes in points where 28.3 points = 1cm and 72 points
27 = 1 inch.
28 -N Adds page numbering.
30 -k [nn]
32 Adds bar numbering. If number nn is included, then every nn'th
33 bar is numbered. Otherwise all bars are numbered.
34 -o filename
36 Specifies the output postscript file name.
37 -P ss Specifies the paper size where 0 is A4 and 1 is US Letter or
39 XXXxYYY sets the paper size in point units.
40 units.
41 -s XX Specifies the scaling factor (default is 0.7)
43 -V Voices are printed out seperately for a multi-voice tune. Other‐
45 wise they are interleaved.
46 -ver Prints version number and exits.
48 -x Print tune number in X: field
50 -OCC Required if the tune uses the old convention for chords delin‐
52 eated with +..+ instead of [...].
53
56 * Uses the abc2midi parsing code, so hopefully compatibility with
57 abc2midi will be good.
58 * Measures the width of lyric text for lyric typesetting.
60 * Uses dynamically extensible data structures in most places, so you
62 should not be restricted by compiled-in limits.
63 * Multiple voices drawn with notes played at the same time aligned.
65 * Supports special characters using ISO latin 1 font. Special charac‐
67 ters are created with a TeX-like code e.g. ´E or a 3 digit octal code
68 e.g. 315 .
69 * Supports the following clefs : baritone, tenor, alto, mezzo, soprano,
71 treble, bass. Recommended use is
72 * Invisible rests (x) are displayed like normal rests.
74 * Nonnumeric voice id's, eg. V: soprano are accepted.
76 I:clef=bass
78 To make it easier to enter tunes in clefs othan than treble clef, yaps
80 supports I:octave=-1 to indicate that a C in the tune represents the
81 note one octave below the pitch defined in the abc standard. These may
82 be combined in one I: statement e.g.
83 I:clef=bass octave=-2
85 You can also use clefs that are one, two or three octaves higher or
87 lower than normal using e.g. treble-8, treble+15, treble-22. The clef
88 is drawn with a small 8, 15 or 22 above or below the clef symbol. The
89 clef= and octave= commands may also go in the K: field e.g.
90 K:G clef=bass-8 octave=-3
92 Note that there is an incompatibility between the behaviour of yaps and
94 the behaviour of abc2ps 1.3.3. abc2ps 1.3.3 does not support the
95 I:octave=N command, but selecting certain clefs causes it to automati‐
96 cally transpose by several octaves. You can produce abc that works for
97 both by following the clef change with an I:octave=N command to do the
98 transpose that abc2ps does automatically.
99 * Produces boxed part labels.
101 * Supports the segno symbol with !segno! and coda with !coda! . Other
103 musical instructions such as !fine! and !D.C.! come out as text. *
104 Supports the U: field for abbreviating symbols to single characters.
105 e.g.
106 U:S = !segno!
108 allows S to be used to produce the segno symbol. Currently this only
110 allows new symbols to be defined and does not allow the existing pre-
111 defined symbols M,L,R,H and T to be altered.
112 * Supports the !red! and !black! instructions for switching from black
114 to red or vice-versa.
115 * Supports the following abc2ps extensions to abc :
117 %%newpage - start a new page,
119 %%vskip N - adds vertical space of N points. If N is followed by
120 'cm' or 'in' the units are taken as centimetres or
121 inches instead of points e.g. 4cm.
122 %%text - print text
123 %%centre (or %%center for Americans) - print centred text.
124 If %%text or %%centre appear in the header, the text appears above
125 the tune.
126 %%staffsep SIZE - set the vertical blank space between 2 consecutive
128 music staves.
129 %%titleleft N - select title placed to the left or centred. N = 1
131 places the title on the left while N = 0 centres it.
132 %%titlecaps - title is displayed in upper case (capital) letters.
133 %%textfont NAME SIZE - select font called NAME and point size SIZE
134 for text produced by %%text or %%centre. If only NAME is given, the
135 font stays the same size. Likewise, if '-' is given as the NAME,
136 only the font size changes.
137 %%titlefont NAME SIZE - select font for title.
138 %%subtitlefont NAME SIZE - select font for titles after the first
139 title.
140 %%composerfont NAME SIZE - select font for words in C: and O: fields
141 and part specifier (P: in header).
142 %%wordsfont NAME SIZE - select font for words in W: fields.
143 %%partsfont NAME SIZE - select font for boxed parts and
144 !instruction! .
145 %%vocalfont NAME SIZE - select font for words in w: fields.
146 %%gchordfont NAME SIZE - select font for guitar chords in the music.
147 (It is advisable not to change the font name for the last two, since
148 the program calculates the width of strings using default fonts)
149 %%titlespace, %%subtitlespace, %%textspace, %%composerspace,
150 %%wordsspace, %%partsspace, %%vocalspace and %%gchordspace
151 determine the amount of space left above the relevant type
152 of text. Each of these should be followed by a size in points
153 or value in centrimetres or inches.
154 e.g. %%composerfont 3
155 %%titlefont 2cm
156 * Supports placing of accompaniment chords either above or below the
158 stave.
159 %%chordsabove - places accompaniment chords above the stave
161 (default).
162 %%chordsbelow - places accompaniment chords below the stave.
163 * Supports optional text enclosed in quotes before and after the
165 tempo specification in the Q: field. This extension comes from
166 abc2ps.
167
170 James Allwright <J.R.Allwright@westminster.ac.uk>
171
173 Seymour Shlien <seymour.shlien@crc.ca>
174 More complete documentation can be found in abcguide.txt which comes
176 with the abcMIDI distribution package.
177
179 This man page describes version 1.39 August 13 2005.
180 13 August 2005 YAPS(1)