Ubuntu Feisty 7.04 manual page repository

Ubuntu is a free computer operating system based on the Linux kernel. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

Provided by: abcmidi-yaps_20060422-1_i386

 

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][-ver] [-x] [-OCC]
 

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 are not 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
               bar is 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 Letter or
               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. Other‐
               wise they are interleaved.
 
        -ver   Prints version number and exits.
 
        -x     Print tune number in X: field
 
        -OCC   Required  if  the tune uses the old convention for chords delin‐
               eated with +..+ instead of [...].
 

FEATURES

        * Uses the abc2midi  parsing  code,  so  hopefully  compatibility  with
        abc2midi will be good.
 
        * Measures the width of lyric text for lyric typesetting.
 
        *  Uses  dynamically  extensible data structures in most places, so you
        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.   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
 
        * 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  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
 
        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 automati‐
        cally 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.
 
        * Produces boxed part labels.
 
        * 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.
 
        *  Supports the !red! and !black! instructions for switching from black
        to red or vice-versa.
 
        * 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.Allwright@westminster.ac.uk>
 

SUPPORTED

        Seymour Shlien <seymour.shlien@crc.ca>
 
        More  complete  documentation  can be found in abcguide.txt which comes
        with the abcMIDI distribution package.
 

VERSION

        This man page describes version 1.39 August 13 2005.
 
YAPS(1)
 

Sections

What does Ubuntu mean?
Ubuntu is an African word meaning 'Humanity to others', or 'I am what I am because of who we all are'. The Ubuntu distribution brings the spirit of Ubuntu to the software world.