SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Mandrake 10.X abcMIDI-2004_06_12-2.mdk10.1.thac.i586.rpm

YAPS

Section: User Commands (1)
Updated: 3 Jan 2004
Index 

NAME

YAPS- converts an abc file to a PostScript file 

SYNOPSIS

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

 

OPTIONS

-d
For debugging only. Displays the internal data structures used in the program.
-e <list>
Draws tunes with reference numbers in a comma separated list. Spaces arenot allowed but a range of reference numbers can be specified. For example,1,3,7-10.
-E
Generates Encapsulated Postscript output.
-M XXXxYYY
Set margin sizes in points where 28.3 points = 1cm and 72 points = 1 inch.
-N
Adds page numbering.
-k [nn]
Adds bar numbering. If number nn is included, then every nn'th baris numbered. Otherwise all bars are numbered.
-o filename
Specifies the output postscript file name.
-P ss
Specifies the paper size where 0 is A4 and 1 is US Letteror XXXxYYY sets the paper size in point units.
 units.
-s XX
Specifies the scaling factor (default is 0.7)
-V
Voices are printed out seperately for a multi-voice tune. Otherwise theyare interleaved.
-x
Print tune number in X: field

 

FEATURES

* Uses the abc2midi parsing code, so hopefully compatibility withabc2midi will be good.

* Measures the width of lyric text for lyric typesetting.

* Uses dynamically extensible data structures in most places, soyou should not be restricted by compiled-in limits.

* Multiple voices drawn with notes played at the same time aligned.

* Supports special characters using ISO latin 1 font. Specialcharacters are created with a TeX-like code e.g. 'E or a 3 digit octalcode e.g. 315 .

* Supports the following clefs : baritone, tenor, alto, mezzo, soprano,treble, bass. Recommended use is

* Invisible rests (x) are displayed like normal rests.

* Nonnumeric voice id's, eg. V: soprano are accepted.


  I:clef=bass

To make it easier to enter tunes in clefs othan than treble clef,yaps supports I:octave=-1 to indicate that a C in the tune representsthe note one octave below the pitch defined in the abc standard. Thesemay 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 orlower than normal using e.g. treble-8, treble+15, treble-22. The clef isdrawn 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

Note that there is an incompatibility between the behaviour of yaps andthe behaviour of abc2ps 1.3.3. abc2ps 1.3.3 does not support theI:octave=N command, but selecting certain clefs causes it to automaticallytranspose by several octaves. You can produce abc that works for both byfollowing the clef change with an I:octave=N command to do the transposethat abc2ps does automatically.

* Produces boxed part labels.

* Supports the segno symbol with !segno! and coda with !coda! . Othermusical 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 onlyallows new symbols to be defined and does not allow the existingpre-defined symbols M,L,R,H and T to be altered.

* 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

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

* 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.AllwrightAATTwestminster.ac.uk> 

SUPPORTED

Seymour Shlien <seymour.shlienAATTcrc.ca>

More complete documentation can be found in abcguide.txt whichcomes with the abcMIDI distribution package. 

VERSION

This man page describes version 1.21 Jan 03 2003.


 

Index

NAME
SYNOPSIS
OPTIONS
FEATURES
AUTHOR
SUPPORTED
VERSION

This document was created byman2html,using the manual pages.