Bar Metadata

This page documents the bar metadata scope — the metadata tags that apply to a single bar or master bar. Time signatures, clefs, key signatures, repeats, and similar per-bar settings live here.

\ts

Scope: Bar metadata

Syntax

// [1]: Specifies a common (4/4) time signature using the special C symbol
\ts common
// [2]: 
\ts (numerator denominator)

Description: Defines the time signature for this and subsequent bars.

AlphaTab does not yet support polytempo notation where instruments might use different time signatures. Therefore be sure to only specify the timesignatures once as part of the first track/staff or ensure they are consistent across the whole document.

Parameters:

Overload	Name	Description	Type	Required
[1]	common	Specifies a common (4/4) time signature using the special C symbol	common	yes
[2]	numerator	The time signature numerator	Number	yes
[2]	denominator	The time signature denominator	Number	yes

Parameter Values:

Following parameters have value limitations

Overload	Name	Values
[1]	common	Value Description common Specifies a common (4/4) time signature using the special C symbol

Example:

00:00

00:00

\ts 3 4 | \ts 4 4 | \ts 6 8 | \ts common

\ro

Scope: Bar metadata

Syntax

\ro ()

Description: Start a repeat

Example:

00:00

00:00

\ro 1.3 2.3 3.3 4.3 | 5.3 6.3 7.3 8.3 | \rc 2 1.3 2.3 3.3 4.3 |
\ro \rc 3 1.3 2.3 3.3 4.3

\rc

Scope: Bar metadata

Syntax

\rc repeats

Description: Marks the end of a repeat.

Parameters:

Name	Description	Type	Required
repeats	The number of repeats which should be played	Number	yes

Example:

00:00

00:00

\ro 1.3 2.3 3.3 4.3 | 5.3 6.3 7.3 8.3 | \rc 2 1.3 2.3 3.3 4.3 |
\ro \rc 3 1.3 2.3 3.3 4.3

\ae

Scope: Bar metadata

Syntax

\ae (ending)

Description: Specifies on which repeats a bar should be played (to build alternate endings).

Parameters:

Name	Description	Type	Required
ending	The repeats on which the bar should be played	Number[]	yes

Example:

00:00

00:00

\ro 1.3 2.3 3.3 4.3 | \ae (1 2 3) 5.3 6.3 7.3 8.3 | \ae 4 
c 4 5.3 8.3 7.3 6.3

\ks

Scope: Bar metadata

Syntax

\ks key

Description: Specifies the key signature for this and subsequent bars.

Parameters:

Name	Description	Type	Required
key	The key signature	Ident	yes

Parameter Values:

Following parameters have value limitations

Name	Values
key	Value Description cb gb db ab eb bb f c g d a e b f# c# cbmajor abminor gbmajor ebminor dbmajor bbminor abmajor fminor ebmajor cminor bbmajor gminor fmajor dminor cmajor aminor gmajor eminor dmajor bminor amajor f#minor emajor c#minor bmajor g#minor f#major d#minor f# c#major a#minor c#

Example:

00:00

00:00

\ks Cb | \ks C | \ks C# |
\ks Aminor | \ks Dmajor | \ks Bminor

\clef

Scope: Bar metadata

Syntax

\clef clef

Description: Changes the clef for this and subsequent bars.

Parameters:

Name	Description	Type	Required
clef	The clef	Ident|Number	yes

Parameter Values:

Following parameters have value limitations

Name	Values
clef	Value Description neutral c3 c4 f4 g2 n alto tenor bass treble

Example:

00:00

00:00

\clef G2 | \clef F4 | \clef C3 | \clef C4 | \clef N |
\clef Treble | \clef Bass | \clef Tenor | \clef Alto | \clef Neutral |

\ottava

Scope: Bar metadata

Syntax

\ottava ottava

Description: Changes the clef ottave for this and subsequent bars.

Parameters:

Name	Description	Type	Required
ottava	The clef ottava	Ident	yes

Parameter Values:

Following parameters have value limitations

Name	Values
ottava	Value Description 15ma Quindicesima (+2 octaves) 8va Ottava (+1 octave) regular Regular 8vb Ottava Bassa (-1 octave) 15mb Quindicesima bassa (-2 octaves) 15ma Quindicesima (+2 octaves) 8va Ottava (+1 octave) 8vb Ottava Bassa (-1 octave) 15mb Quindicesima bassa (-2 octaves)

Example:

00:00

00:00

\clef F4 \ottava 15ma | | \ottava regular | | \clef C3 \ottava 8vb | |

\tempo

Scope: Bar metadata

Syntax

// [1]: 
\tempo (tempo label)
// [2]: 
\tempo (tempo label position hide)

Description: Adds a tempo change to the bar.

A bar can have multiple tempo changes. They can either be relatively positioned using this metadata tag or applied via the tempo property as beat effect.

Tempo changes affect the whole song and not only an individual track. To avoid unexpected side effects, we recomment to specify the tempo changes only once on the first track/staff.

Parameters:

Overload	Name	Description	Type	Required
[1]	tempo	The new tempo in BPM	Number	yes
[1]	label	A textual label for the tempo	String	no ""
[2]	tempo	The new tempo in BPM	Number	yes
[2]	label	A textual label for the tempo	String	yes ""
[2]	position	A relative (ratio) position where within the bar the tempo change should happen	Number	no 0
[2]	hide	If specified the tempo change is not visually shown	hide	no

Parameter Values:

Following parameters have value limitations

Overload	Name	Values
[2]	hide	Value Description hide If specified the tempo change is not visually shown

Example:

00:00

00:00

\tempo 30
C4 D4 E4 F4 |
\tempo (120 "Moderate")
\tempo (60 "" 0.5 hide)
C4 D4 E4 F4 |

\tf

Scope: Bar metadata

Syntax

\tf tripletFeel

Description: Changes the triplet feel (aka. swing) play style.

Parameters:

Name	Description	Type	Required
tripletFeel	The triplet feel style	Ident|Number	yes

Parameter Values:

Following parameters have value limitations

Name

Values

tripletFeel

Value Description none No triplet feel triplet16th Triplet 16th triplet8th Triplet 8th dotted16th Dotted 16th dotted8th Dotted 8th scottish16th Scottish 16th scottish8th Scottish 8th none No triplet feel no No triplet feel noTripletFeel No triplet feel t16 Triplet 16th triplet-16th Triplet 16th t8 Triplet 8th triplet-8th Triplet 8th d16 Dotted 16th dotted-16th Dotted 16th d8 Dotted 8th dotted-8th Dotted 8th s16 Scottish 16th scottish-16th Scottish 16th s8 Scottish 8th scottish-8th Scottish 8th

Example:

00:00

00:00

\tf none 3.3*4 |
\tf triplet16th 3.3*4 | \tf triplet8th 3.3*4 |
\tf dotted16th 3.3*4 | \tf dotted8th 3.3*4 |
\tf scottish16th 3.3*4 | \tf scottish8th 3.3*4 |

\ac

Scope: Bar metadata

Syntax

\ac ()

Description: Marks the bar as an anacrusis (pick-up) bar.

By default bars follow a strict timing defined by the time signature and tempo. Anacrusis (aka. pickup bars) do not follow this rule. The length of those bars is defined by the actual beats/notes in the bar.

Example:

00:00

00:00

\ks D \ts 24 16 \ac r.16 6.3 7.3 9.3 7.3 6.3 | r.16 5.4 7.4 9.4 7.4 5.4 6.3.4{d} 9.6.16 10.6 12.6 10.6 9.6 14.6.4{d} r.16

\section

Scope: Bar metadata

Syntax

// [1]: 
\section text
// [2]: 
\section (marker text)

Description: Starts a new section

Parameters:

Overload	Name	Description	Type	Required
[1]	text	The text/description of the new section	String	yes
[2]	marker	The marker for the section, typically a single letter	String	yes
[2]	text	The text/description of the new section	String	yes

Example:

00:00

00:00

\section "Intro" // simple section
1.1 1.1 1.1 1.1 | 1.1 1.1 1.1 1.1 |
\section "S" "Solo" // with marker and section name differently
1.1 1.1 1.1 1.1

\jump

Scope: Bar metadata

Syntax

\jump direction

Description: Adds a direction/jump instruction to the bar.

Parameters:

Name	Description	Type	Required
direction	The direction to add	Ident	yes

Parameter Values:

Following parameters have value limitations

Name

Values

direction

Value Description fine Fine (Target) segno Segno (Target) segnoSegno SegnoSegno (Target) coda Coda (Target) doubleCoda DoubleCoda (Target) daCapo DaCapo (Jump) daCapoAlCoda DaCapoAlCoda (Jump) daCapoAlDoubleCoda DaCapoAlDoubleCoda (Jump) daCapoAlFine DaCapoAlFine (Jump) dalSegno DalSegno (Jump) dalSegnoAlCoda DalSegnoAlCoda (Jump) dalSegnoAlDoubleCoda DalSegnoAlDoubleCoda (Jump) dalSegnoAlFine DalSegnoAlFine (Jump) dalSegnoSegno DalSegnoSegno (Jump) dalSegnoSegnoAlCoda DalSegnoSegnoAlCoda (Jump) dalSegnoSegnoAlDoubleCoda DalSegnoSegnoAlDoubleCoda (Jump) dalSegnoSegnoAlFine DalSegnoSegnoAlFine (Jump) daCoda DaCoda (Jump) daDoubleCoda DaDoubleCoda (Jump)

Example:

00:00

00:00

\ro \rc 2 3.3*4 | 
  3.3*4 | 
  \jump Segno 3.3*4 |
  \ro 
c 2 3.3*4 | 
  \jump DaCoda 3.3*4 |
  3.3*4 | 3.3*4
  \jump DalSegnoAlCoda 3.3*4 |
  3.3*4 |
  \jump Coda 3.3*4 |
  3.3*4 |
  3.3*4

\ft

Scope: Bar metadata

Syntax

\ft ()

Description: Marks the bar as a free-time bar where players are free to vary the timing.

Example:

00:00

00:00

:2 
C4*2 |
\ft C4*2 |
\ft C4*2 |
C4*2 |

\simile

Scope: Bar metadata

Syntax

\simile mark

Description: Adds a simile mark to the bar indicating that the content of the last, or previous two bars should be repeated.

Parameters:

Name	Description	Type	Required
mark	The mark to add	none|simple|firstOfDouble|secondOfDouble	yes

Parameter Values:

Following parameters have value limitations

Name	Values
mark	Value Description none No simile mark is applied simple A simple simile mark. The previous bar is repeated. firstOfDouble A double simile mark. This value is assigned to the first bar of the 2 repeat bars. secondOfDouble A double simile mark. This value is assigned to the second bar of the 2 repeat bars.

Example:

00:00

00:00

3.3*4 | \simile simple | 3.3*4 | 4.3*4 | \simile firstofdouble | \simile secondofdouble

\barlineLeft

Scope: Bar metadata

Syntax

\barlineLeft style

Description: Adjusts the lines which will be shown left on the bar.

For some special notation needs, the default bar line can be adjusted on every bar. The bar line styles are aligned with the ones from MusicXML.

alphaTab attempts to reuse lines on overlapping styles across bars.

Parameters:

Name	Description	Type	Required
style	The line style to use	Ident	yes

Parameter Values:

Following parameters have value limitations

Name	Values
style	Value Description automatic Auto detect line to show dashed dotted heavy heavyHeavy heavyLight lightHeavy lightLight none regular short tick

Example:

00:00

00:00

\instrument piano
\track "Overlapping"
\staff 
    \barlineleft dashed 
    \barlineright dotted 
    | 
    \barlineleft heavyheavy
    \barlineright heavyheavy
    
\staff 
    \barlineleft lightlight 
    \barlineright lightheavy 
    | 
    \barlineleft heavylight
    \barlineright dashed
\track "All Styles"
\staff 
    \barlineright dashed |
    \barlineright dotted |
    \barlineright heavy |
    \barlineright heavyHeavy |
    \barlineright heavyLight |
    \barlineright lightHeavy |
    \barlineright lightlight |
    \barlineright none |
    \barlineright regular |
    \barlineright short |
    \barlineright tick |

\barlineRight

Scope: Bar metadata

Syntax

\barlineRight style

Description: Adjusts the lines which will be shown right on the bar.

For some special notation needs, the default bar line can be adjusted on every bar. The bar line styles are aligned with the ones from MusicXML.

alphaTab attempts to reuse lines on overlapping styles across bars.

Parameters:

Name	Description	Type	Required
style	The line style to use	Ident	yes

Parameter Values:

Following parameters have value limitations

Name	Values
style	Value Description automatic Auto detect line to show dashed dotted heavy heavyHeavy heavyLight lightHeavy lightLight none regular short tick

Example:

00:00

00:00

\instrument piano
\track "Overlapping"
\staff 
    \barlineleft dashed 
    \barlineright dotted 
    | 
    \barlineleft heavyheavy
    \barlineright heavyheavy
    
\staff 
    \barlineleft lightlight 
    \barlineright lightheavy 
    | 
    \barlineleft heavylight
    \barlineright dashed
\track "All Styles"
\staff 
    \barlineright dashed |
    \barlineright dotted |
    \barlineright heavy |
    \barlineright heavyHeavy |
    \barlineright heavyLight |
    \barlineright lightHeavy |
    \barlineright lightlight |
    \barlineright none |
    \barlineright regular |
    \barlineright short |
    \barlineright tick |

\scale

Scope: Bar metadata

Syntax

\scale scale

Description: Adjusts the relative scale of the bar when using systemsLayoutMode: 'UseModelLayout' with the page layout.

Parameters:

Name	Description	Type	Required
scale	The scale of the bar within the system	Number	yes

Example:

00:00

00:00

\track { defaultSystemsLayout 3 }
\scale 0.25 :1 c4 | \scale 0.5 c4 | \scale 0.25 c4 | 
\scale 0.5 c4 | \scale 2 c4 | \scale 0.5 c4 |
c4 | c4

\width

Scope: Bar metadata

Syntax

\width width

Description: Adjusts the absolute of the bar when using systemsLayoutMode: 'UseModelLayout' with the horizontal layout.

Parameters:

Name	Description	Type	Required
width	The absolute width of the bar	Number	yes

Example:

00:00

00:00

\track
  \width 100 :1 c4 | \width 300 c4 | \width 350 c4

\sync

Scope: Bar metadata

Syntax

\sync (barIndex occurence millisecondOffset ratioPosition)

Description: Adds a new sync point for synchronizing the music sheet with an external media source like a backing track or video player.

alphaTex support specifying sync points for the synchronization with external media.

It is recommended to add the sync points at the very end of the song but it is also possible to define them inbetween.

The barIndex, occurence, ratioPosition parameters define the absolute position within the music sheet. The millisecondOffset defines the absolute position within the external media.

With this information known, alphaTab can synchronize the external media with the music sheet.

Parameters:

Name	Description	Type	Required
barIndex	The index of the bar being synced	Number	yes
occurence	The occurence of the bar for which this sync point applies (on repeats)	Number	yes
millisecondOffset	The absolute millisecond offset within the external media	Number	yes
ratioPosition	The relative position within the bar where the synchronization happens	Number	no 0

Example:

\title "Prelude in D Minor"
\artist "J.S. Bach (1685-1750)"
\copyright "Public Domain"
\tempo 80
.
\ts 3 4
0.4.16 (3.2 -.4) (1.1 -.4) (5.1 -.4) 1.1 3.2 1.1 3.2 2.3.8 (3.2 3.4) |
(3.2 0.4).16 (3.2 -.4) (1.1 -.4) (5.1 -.4) 1.1 3.2 1.1 3.2 2.3.8 (3.2 3.4) |
(3.2 0.4).16 (3.2 -.4) (3.1 -.4) (6.1 -.4) 3.1 3.2 3.1 3.2 3.3.8 (3.2 0.3) |
(3.2 0.4).16 (3.2 -.4) (3.1 -.4) (6.1 -.4) 3.1 3.2 3.1 3.2 3.3.8 (3.2 0.3) |
.
\sync 0 0 0
\sync 0 0 1500 0.666
\sync 1 0 4075 0.666
\sync 2 0 6475 0.333
\sync 3 0 10223 1

\accidentals

Scope: Bar metadata

Syntax

\accidentals mode

Description: Changes the mode how alphaTab should treat accidentals when writing pitched notes.

alphaTab can use the accidentals as specified in alphaTex, or apply accidentals automatically based on the note pitch.

Parameters:

Name	Description	Type	Required
mode	The mode which should be active	auto|explicit	yes

Parameter Values:

Following parameters have value limitations

Name	Values
mode	Value Description auto Automatic (Based on Pitch) explicit Explicit (as Written)

Example:

00:00

00:00

\accidentals explicit
C#4 C4 Eb4 Ax4 |
\accidentals auto
C#4 C4 Eb4 Ax4 |

\spd

Scope: Bar metadata

Syntax

\spd position

Description: Specifies how the sustain petal should be pressed down (spd), held (sph) or lifted up (spu).

This tag allows specifying the sustain pedal relative to the bar. The sustain pedal can also be applied via beat properties.

Parameters:

Name	Description	Type	Required
position	The relative position within the bar for the marker (0-1)	Number	yes

Example:

00:00

00:00

\spd 0
\spu 0.25
\spd 0.5
\sph 0.75
\spu 1
:8 C4 * 8

\sph

Scope: Bar metadata

Syntax

\sph position

Description: Specifies how the sustain petal should be pressed down (spd), held (sph) or lifted up (spu).

This tag allows specifying the sustain pedal relative to the bar. The sustain pedal can also be applied via beat properties.

Parameters:

Name	Description	Type	Required
position	The relative position within the bar for the marker (0-1)	Number	yes

Example:

00:00

00:00

\spd 0
\spu 0.25
\spd 0.5
\sph 0.75
\spu 1
:8 C4 * 8

\spu

Scope: Bar metadata

Syntax

\spu position

Description: Specifies how the sustain petal should be pressed down (spd), held (sph) or lifted up (spu).

This tag allows specifying the sustain pedal relative to the bar. The sustain pedal can also be applied via beat properties.

Parameters:

Name	Description	Type	Required
position	The relative position within the bar for the marker (0-1)	Number	yes

Example:

00:00

00:00

\spd 0
\spu 0.25
\spd 0.5
\sph 0.75
\spu 1
:8 C4 * 8

\voiceMode

Scope: Bar metadata

Syntax

\voiceMode mode

Description: Changes the mode how alphaTab should treat voices when adding \voice.

You can either choose to write voice-by-voice where each voice has all bars defined. You write bar-by-bar where a new voice is only added to the current bar.

Parameters:

Name	Description	Type	Required
mode	The mode which should be active	staffWise|barWise	yes

Parameter Values:

Following parameters have value limitations

Name	Values
mode	Value Description staffWise Staff-Wise voices barWise Bar-Wise voices

Example:

00:00

00:00

\title "Staff Wise Voices"
\voiceMode staffWise
// Voice 1
\voice
  // Bar 1 Voice 1
  C4*4 | 
  // Bar 2 Voice 1
  C5*4 | 
  // Bar 3 Voice 1
  C6*4
// Voice 2
\voice
  // Bar 1 Voice 2
  C3*4 | 
  // Bar 2 Voice 2
  C4*4 | 
  // Bar 3 Voice 2
  C5 * 4

00:00

00:00

\title "Bar Wise Voices"
\voiceMode barWise
// Bar 1
  // Bar 1 Voice 1
  \voice
  C4*4 
  // Bar 1 Voice 2
  \voice 
  C3*4 
| 
// Bar 2
  // Bar 2 Voice 1
  \voice
  C5*4 
  // Bar 2 Voice 2
  \voice
  C4*4 
| 
// Bar 3
  // Bar 3 Voice 1
  \voice
  C6*4
  // Bar 3 Voice 2
  \voice 
  C5 * 4

\barNumberDisplay

Scope: Bar metadata

Syntax

\barNumberDisplay mode

Description: Sets the display mode for bar numbers.

Parameters:

Name	Description	Type	Required
mode	The mode to use	allBars|firstOfSystem|hide	yes

Parameter Values:

Following parameters have value limitations

Name	Values
mode	Value Description allBars All bars firstOfSystem First bar of every system hide Hide

Example:

00:00

00:00

\defaultBarNumberDisplay hide
\track { defaultsystemslayout 3 }
  C4.1 | \barNumberDisplay allBars C4.1 | C4.1 |
  \barNumberDisplay firstOfSystem C4.1 | \barNumberDisplay firstOfSystem C4.1 | C4.1

00:00

00:00

\defaultBarNumberDisplay firstOfSystem
\track { defaultsystemslayout 3 }
  C4.1 | \barNumberDisplay allBars C4.1 | C4.1 |
  \barNumberDisplay hide C4.1 | C4.1 | C4.1

\beaming

Scope: Bar metadata

Syntax

\beaming (duration groups)

Description: Defines a custom beaming rule defining how beams of certain durations should be beamed.

To define how beats should be beamed we need 2 parts:

1. A duration with which we splitup the bars
2. A list of group sizes defining how many split-parts should be beamed together.

The beaming rules go hand-in-hand with the time signature as the rules need to properly define the groups for the whole beat.

Let's take a simple example of a 4/4 time signature. If we want to ensure that the beats within the quarter notes are beamed together we can write variants like this:

a. \beaming (4 1 1 1 1) b. \beaming (8 2 2 2 2) c. \beaming (16 4 4 4 4)

We slice the bar into 4, 8 or 16 parts. Then we add "groups" to those parts. If two beats start in the same group, they can be beamed together. Simple as that.

There are some common guidelines on how beaming "should be done" and alphaTab ships a wide range of defaults. But in case of more specialized time signatures, you can also customize the beaming as you need by slicing the bar and grouping the beats as needed.

Parameters:

Name	Description	Type	Required
duration	The note duration defining the smallest group size	Number	yes
groups	For every group the number of notes contained in the group.	Number[]	no

Example:

00:00

00:00

\ts (4 4)
\beaming (8 4 2 2)
C4.8 * 8 |

\ts (4 4)
\beaming (8 4 4)
C4.8 * 8

\barNumber

Scope: Bar metadata

Syntax

// [1]: 
\barNumber text
// [2]: 
\barNumber number

Description: Sets the bar number display.

Parameters:

Overload	Name	Description	Type	Required
[1]	text	THe custom text shown instead of the number	String	yes
[2]	number	The new number (affects subsequent counting)	Number	yes

Example:

00:00

00:00

// anacrusis (no number)
\ac 
  C4.1 
| 
// standard bar number 1
  C4 
| 
// custom text instead of bar number 2
\barNumber "Hello" 
  C4
|
// a jump to 10 
\barNumber 10
  C4
|
// now becomes 11 after the customization before
  C4

\barDisplay

Scope: Bar metadata

Syntax

\barDisplay (staffTypes)

Description: Defines the display of elements like clefs, key signatures, time signatures and bar numbers for the current bar.

The arguments select the staff types to which the properties apply. If no staff types are specified, every property applies to all staff types supporting the related element.

All properties are optional. Properties which are not specified are inherited from \staffDisplay and \defaultStaffDisplay. The values only apply to the bar they are specified on.

Parameters:

Name	Description	Type	Required
staffTypes	The staff types to which the properties apply. If omitted, every property applies to all staff types supporting it.	score|tabs|slash|numbered[]	no

Parameter Values:

Following parameters have value limitations

Name	Values
staffTypes	Value Description score Standard notation tabs Guitar tablature slash Slash notation numbered Numbered notation (Jianpu)

Example:

00:00

00:00

\track
  \staff {score tabs}
  \ks D 3.3.4 3.3 3.3 3.3 |
  \barDisplay score { ksVisibility false } \ks A 3.3 3.3 3.3 3.3 |
  3.3 3.3 3.3 3.3

Properties:

clefVisibility

Scope: Bar metadata

Syntax

// [1]: 
clefVisibility ()
// [2]: 
clefVisibility visibility
// [3]: 
clefVisibility visibility
// [4]: 
clefVisibility visibility

Description: Show or hide the clef. Supported staff types: score, tabs.

Parameters:

Overload	Name	Description	Type	Required
[2]	visibility	Whether the clef is shown	"true"|"false"	yes
[3]	visibility	Whether the clef is shown	true|false	yes
[4]	visibility	Whether the clef is shown	1|0	yes

Parameter Values:

Following parameters have value limitations

Overload	Name	Values
[2]	visibility	Value Description "true" Show the clef "false" Hide the clef
[3]	visibility	Value Description true Show the clef false Hide the clef
[4]	visibility	Value Description 1 Show the clef 0 Hide the clef

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { clefVisibility false } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

clefPlacement

Scope: Bar metadata

Syntax

clefPlacement placement

Description: Show the clef on all staves or only on the primary (topmost) staff. Supported staff types: score, tabs.

Parameters:

Name	Description	Type	Required
placement	On which staves the clef is shown	allStaves|primary	yes

Parameter Values:

Following parameters have value limitations

Name	Values
placement	Value Description allStaves All staves primary Only the primary (topmost) staff

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { clefPlacement primary } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

clefSystems

Scope: Bar metadata

Syntax

clefSystems systems

Description: Show the clef on all systems or only on the first system. Supported staff types: score, tabs.

Parameters:

Name	Description	Type	Required
systems	On which systems the clef is shown	allSystems|firstSystemOnly	yes

Parameter Values:

Following parameters have value limitations

Name	Values
systems	Value Description allSystems All systems firstSystemOnly Only the first system

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { clefSystems firstSystemOnly } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

ksVisibility

Scope: Bar metadata

Syntax

// [1]: 
ksVisibility ()
// [2]: 
ksVisibility visibility
// [3]: 
ksVisibility visibility
// [4]: 
ksVisibility visibility

Description: Show or hide the key signature. Supported staff types: score, slash.

Parameters:

Overload	Name	Description	Type	Required
[2]	visibility	Whether the key signature is shown	"true"|"false"	yes
[3]	visibility	Whether the key signature is shown	true|false	yes
[4]	visibility	Whether the key signature is shown	1|0	yes

Parameter Values:

Following parameters have value limitations

Overload	Name	Values
[2]	visibility	Value Description "true" Show the key signature "false" Hide the key signature
[3]	visibility	Value Description true Show the key signature false Hide the key signature
[4]	visibility	Value Description 1 Show the key signature 0 Hide the key signature

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { ksVisibility false } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

ksPlacement

Scope: Bar metadata

Syntax

ksPlacement placement

Description: Show the key signature on all staves or only on the primary (topmost) staff. Supported staff types: score, slash.

Parameters:

Name	Description	Type	Required
placement	On which staves the key signature is shown	allStaves|primary	yes

Parameter Values:

Following parameters have value limitations

Name	Values
placement	Value Description allStaves All staves primary Only the primary (topmost) staff

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { ksPlacement primary } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

ksSystems

Scope: Bar metadata

Syntax

ksSystems systems

Description: Show the key signature on all systems or only on the first system. Supported staff types: score, slash.

Parameters:

Name	Description	Type	Required
systems	On which systems the key signature is shown	allSystems|firstSystemOnly	yes

Parameter Values:

Following parameters have value limitations

Name	Values
systems	Value Description allSystems All systems firstSystemOnly Only the first system

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { ksSystems firstSystemOnly } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

tsVisibility

Scope: Bar metadata

Syntax

// [1]: 
tsVisibility ()
// [2]: 
tsVisibility visibility
// [3]: 
tsVisibility visibility
// [4]: 
tsVisibility visibility

Description: Show or hide the time signature. Supported staff types: score, tabs, slash, numbered.

Parameters:

Overload	Name	Description	Type	Required
[2]	visibility	Whether the time signature is shown	"true"|"false"	yes
[3]	visibility	Whether the time signature is shown	true|false	yes
[4]	visibility	Whether the time signature is shown	1|0	yes

Parameter Values:

Following parameters have value limitations

Overload	Name	Values
[2]	visibility	Value Description "true" Show the time signature "false" Hide the time signature
[3]	visibility	Value Description true Show the time signature false Hide the time signature
[4]	visibility	Value Description 1 Show the time signature 0 Hide the time signature

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { tsVisibility false } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

tsPlacement

Scope: Bar metadata

Syntax

tsPlacement placement

Description: Show the time signature on all staves or only on the primary (topmost) staff. Supported staff types: score, tabs, slash, numbered.

Parameters:

Name	Description	Type	Required
placement	On which staves the time signature is shown	allStaves|primary	yes

Parameter Values:

Following parameters have value limitations

Name	Values
placement	Value Description allStaves All staves primary Only the primary (topmost) staff

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { tsPlacement primary } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

tsSystems

Scope: Bar metadata

Syntax

tsSystems systems

Description: Show the time signature on all systems or only on the first system. Supported staff types: score, tabs, slash, numbered.

Parameters:

Name	Description	Type	Required
systems	On which systems the time signature is shown	allSystems|firstSystemOnly	yes

Parameter Values:

Following parameters have value limitations

Name	Values
systems	Value Description allSystems All systems firstSystemOnly Only the first system

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { tsSystems firstSystemOnly } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3

barNumber

Scope: Bar metadata

Syntax

barNumber mode

Description: Set how bar numbers are shown. Supported staff types: all.

Parameters:

Name	Description	Type	Required
mode	The mode to use	allBars|firstOfSystem|hide	yes

Parameter Values:

Following parameters have value limitations

Name	Values
mode	Value Description allBars All bars firstOfSystem First bar of every system hide Hide

Example:

00:00

00:00

\track { defaultSystemsLayout 2 }
  \staff {score tabs}
  \ks D 3.3.4 r 3.3 3.3 | 3.3.4 3.3 r 3.3 | \barDisplay { barNumber allBars } \ts (3 4) \ks A 3.3.4 3.3 r | 3.3.4 r 3.3