YAPS(1)

💖 YAPS(1) 💖

General Commands Manual energy, but make it ✨aesthetic✨. This is the manual for YAPS, and bestie, it is literally the girl who turns your abc files into PostScript. Obsessed.

---

✨ NAME ✨

YAPS — converts an abc file to a PostScript file 🎀

No cap, that's the whole gig. You feed it abc, it hands you PostScript. Slay.

---

🌸 SYNOPSIS 🌸

yaps abc file [-d] [-e <list>] [-E] [-l] [-M XXXxYYY] [-N] [-k nn] [-o file name] [-P -ss] [-s XX] [-V][-ver] [-x] [-OCC]

That's the vibe check right there. All the flags, all lined up. Let's go through them one by one because you deserve to know 💅

---

💅 OPTIONS 💅

• -d — debugging only, bestie. It dumps the internal data structures the program is using, so you can peek inside its brain. Only for when things are giving chaos.
• -e <list> — draws only the tunes whose reference numbers are in a comma separated list. No spaces allowed (fr fr, none), but you can do a range of reference numbers. Example: 1,3,7-10. Chef's kiss.
• -E — generates Encapsulated Postscript output. Iconic for when you need to drop it into other docs.
• -M XXXxYYY — sets margin sizes in points, where 28.3 points = 1cm and 72 points = 1 inch. Do the math or don't, either way it works.
• -N — adds page numbering. You're welcome.
• -k [nn] — adds bar numbering. If you include the number nn, then every nn'th bar gets numbered. If you don't, all the bars get numbered. Main character bars, every single one.
• -o filename — specifies the output postscript file name. Name your baby.
• -P ss — specifies the paper size, where 0 is A4 and 1 is US Letter, or XXXxYYY sets the paper size in point units.
• -s XX — specifies the scaling factor. Default is 0.7.
• -V — voices get printed out separately for a multi-voice tune. Otherwise they are interleaved. Pick your fighter.
• -ver — prints the version number and exits. A little hello and goodbye, love that for it.
• -x — print tune number in the X: field.
• -OCC — required if the tune uses the old convention for chords, delineated with +..+ instead of [...]. Old-school chord notation, we respect her.

---

🦋 FEATURES 🦋

Okay this is the part where YAPS just keeps pulling things out of her bag and every single one is a serve:

• Uses the abc2midi parsing code, so hopefully compatibility with abc2midi will be good. Fingers crossed bestie 🤞
• Measures the width of lyric text for lyric typesetting. She's doing the math for your lyrics, respect.
• Uses dynamically extensible data structures in most places, so you should not be restricted by compiled-in limits. She grows 💖
• Multiple voices drawn with notes played at the same time aligned. Synchronised slay.
• Supports special characters using ISO latin 1 font. Special characters are created with a TeX-like code, e.g. ´E, or a 3 digit octal code, e.g. 315.
• Supports the following clefs: baritone, tenor, alto, mezzo, soprano, treble, bass. Recommended use is

I:clef=bass

• Invisible rests (x) are displayed like normal rests. Not invisible to her, periodt.
• Nonnumeric voice id's, eg. V: soprano are accepted. She's flexible like that 💁‍♀️

---

🎀 Clefs & octaves (iykyk) 🎀

To make it easier to enter tunes in clefs other than treble clef, yaps supports I:octave=-1 to indicate that a C in the tune represents the note one octave below the pitch defined in the abc standard. These may be combined in one I: statement, e.g.

I:clef=bass octave=-2

You can also use clefs that are one, two or three octaves higher or lower than normal, using e.g. treble-8, treble+15, treble-22. The clef is drawn with a small 8, 15 or 22 above or below the clef symbol. The clef= and octave= commands may also go in the K: field, e.g.

K:G clef=bass-8 octave=-3

⚠️ Heads up bestie — note that there is an incompatibility between the behaviour of yaps and the behaviour of abc2ps 1.3.3. abc2ps 1.3.3 does not support the I:octave=N command, but selecting certain clefs causes it to automatically transpose by several octaves. You can produce abc that works for both by following the clef change with an I:octave=N command to do the transpose that abc2ps does automatically.

---

🌈 Symbols, labels and colours 🌈

• Produces boxed part labels. Cute, framed, iconic.
• Supports the segno symbol with !segno! and coda with !coda!. Other musical instructions such as !fine! and !D.C.! come out as text. * Supports the U: field for abbreviating symbols to single characters, e.g.

U:S = !segno!

allows S to be used to produce the segno symbol. Currently this only allows new symbols to be defined and does not allow the existing pre-defined symbols M, L, R, H and T to be altered. Sorry girl, those five are off limits 🙈

• Supports the !red! and !black! instructions for switching from black to red or vice-versa. Colour change moment 🔥

---

💜 abc2ps extensions to abc 💜

Supports the following abc2ps extensions to abc:

%%newpage  - start a new page,
%%vskip N  - adds vertical space of N points. If N is followed by
             'cm' or 'in' the units are taken as centimetres or
             inches instead of points e.g. 4cm.
%%text     - print text
%%centre (or %%center for Americans) - print centred text.
If %%text or %%centre appear in the header, the text appears above
the tune.

%%staffsep SIZE - set the vertical blank space between 2 consecutive
                  music staves.

%%titleleft N - select title placed to the left or centred. N = 1
                places the title on the left while N = 0 centres it.
%%titlecaps - title is displayed in upper case (capital) letters.
%%textfont NAME SIZE - select font called NAME and point size SIZE
for text produced by %%text or %%centre. If only NAME is given, the
font stays the same size. Likewise, if '-' is given as the NAME,
only the font size changes.
%%titlefont NAME SIZE - select font for title.
%%subtitlefont NAME SIZE - select font for titles after the first
title.
%%composerfont NAME SIZE - select font for words in C: and O: fields
                          and part specifier (P: in header).
%%wordsfont NAME SIZE - select font for words in W: fields.
%%partsfont NAME SIZE - select font for boxed parts and
!instruction! .
%%vocalfont NAME SIZE - select font for words in w: fields.
%%gchordfont NAME SIZE - select font for guitar chords in the music.
(It is advisable not to change the font name for the last two, since
 the program calculates the width of strings using default fonts)
%%titlespace, %%subtitlespace, %%textspace, %%composerspace,
%%wordsspace, %%partsspace, %%vocalspace and %%gchordspace
determine the amount of space left above the relevant type
of text. Each of these should be followed by a size in points
or value in centrimetres or inches.
e.g. %%composerfont 3
     %%titlefont 2cm

---

🎵 Chords above or below 🎵

Supports placing of accompaniment chords either above or below the stave.

%%chordsabove - places accompaniment chords above the stave
(default).
%%chordsbelow - places accompaniment chords below the stave.

Above is the default, so if you want that under-stave drama you gotta ask for it 💅

---

🌟 Q: field glow-up 🌟

Supports optional text enclosed in quotes before and after the tempo specification in the Q: field. This extension comes from abc2ps.

---

👑 AUTHOR 👑

James Allwright <J.R.Allwright@westminster.ac.uk>

💖 SUPPORTED 💖

Seymour Shlien <fy733@ncf.ca>

More complete documentation can be found in abcguide.txt which comes with the abcMIDI distribution package. Go read it bestie, there's more where this came from 📖

⭐ VERSION ⭐

This man page describes version 1.39 August 13 2005.

---

and that's the whole page, no notes 💅 — brought to you by the YAPS(1) General Commands Manual, version 1.39, dated 13 August 2005. mwah, go convert something pretty ✨🎀🦋