tablature ["#"int] [pitch=pitch] [[unit-1] unit-2] unit-3 head-func note-func [bar-func]

Define a tablature.

"#"int gives a number to the tablature (from #1 to #8 only for abcm2ps).
This number is used to memorize a set of different tablatures at the global level. It is used in the tunes with no other parameter.

pitch is the pitch of the instrument.
It looks like a normal ABC note (starting with an accidental - ^ or _) or a key signatureending with an accidental # or b).
When present, the pitch of each note is given as argument to the note function. When absent, the information about the note(s) is given by one or many lyrics (w:).

unit-1 specifies the width of the header (left side of the music line).

unit-2 specifies the tablature height above the staff (ascent).

unit-3 specifies the tablature height under the staff (descent).

head-func is the PostScript function thst is called at start of a new music line.

note-func is the PostScript function called at each note.

bar-func is the PostScript function called at each bar.

The arguments of the PostScript functions depend on the presence of the pitch.
When the pitch is absent, the value of tablature is defined in the lyric line (w:) and the arguments are:

head function:

• the music line width,
• the x and y offsets,
• the number of w: lines.

note function:

• the string as defined by the 'w:' line,
• the x and y offsets,
• the w: line number (0 .. n-1).

bar function:

• the ABC bar type as a string.
• the x and y offsets,
• the w: line number (0 .. n-1).

head function:

• the instrument pitch as a single uppercase letter and a sharp or a flat.

note function:

• the octave (0 is 'C') letting pitch >= 0 and < 36
• the pitch in 12th of octave on 3 octaves (0..35 - it may be not a whole number with microtone)
• the x offset

bar function:

• the bar function is not used.

txtmus/abc2svg/abc2svg documentation abc2svg source author - page hosted by Free