Beat Effects
There are various effects that can be applied to a beat. All beat
effects are specified in braces after the beat: Beat{Effects}.
Multiple effects are simply separated by spaces, like 3.3{f v}.
Simple Effects​
Please find the list of supported effects in the example below.
// fade in, fade out and volume swell
3.3{f} 3.3{fo} 3.3{vs} |
// vibrato (slight and wide)
3.3{v} 3.3{vw} |
// tap
3.3{tt}
// slap
3.3{s}
// pop
3.3{p}
|
// dotted
3.3{d}
// double dotted
3.3{dd}
// pick stroke (su => up, sd => down)
3.3{su}
3.3{sd}
|
// grace (on beat)
3.3{gr ob}
3.3
// grace (before beat)
3.3{gr}
3.3
|
// Tuplets (supported variants: 3, 5, 6, 7, 9, 10, 11, 12 or custom)
3.3{tu 3} 3.3{tu 3} 3.3{tu 3} |
3.3{tu 5} 3.3{tu 5} 3.3{tu 5} 3.3{tu 5} 3.3{tu 5} |
3.3{tu 4 3} 3.3{tu 4 3} 3.3{tu 4 3} 3.3{tu 4 3}
|
// tremolo picking (tp duration - where duration can be 8, 16 or 32)
3.3{tp 8} 3.3{tp 16} 3.3{tp 32}
|
// Crescendo / Decrescendo
3.3{cre} 3.3{cre} 3.3{dec} 3.3{dec}
Dynamics​
Dynamics are beat effects with the indicator dy followed by one of the supported dynamics values FFF, FF, F, MF, MP, P, PP or PPP.
1.1.8{dy ppp} 1.1{dy pp} 1.1{dy p} 1.1{dy mp} 1.1{dy mf} 1.1{dy f} 1.1{dy ff} 1.1{dy fff}
Tuplet Ranges​
You can also specify the tuplet as part of a ranged duration. This makes writing tuplets a bit easier if there are many.
To reset the tuplet range, a new duration range can be started. For individual notes other tuplets can be specified too.
{tu 1} can be used to specify no tuplet while a tuplet range is active.
:4{tu 3} 3.3 3.3 3.3 :8 3.3 3.3 3.3 3.3 |
:8{tu 3} 3.3 3.3 3.3 3.3.16 3.3.16 3.3.16 3.3.2{tu 1} 3.3.16{tu 1} 3.3.4 3.3.4 3.3.4
Tremolo / Whammy Bar​
The tremolo/whammy bar effect is a bit more complex than the others.
You can specify a number of values which are evenly distributed over the
time when the note is played with the format tb (value1 value2 ...).
The values indicate the number of quarter notes increased or decreased while playing (use decimals for quarter notes).
3.3.1{tb (0 4 0 8)} |
3.3.1{tb (0 -4 0 -8)} |
To specify a whammy with exact positions (not evenly distributed) you can use tbe (offset1 value1 offset2 value2).
The offset is ranging from 0 to 60.
3.3.1{tbe (0 0 5 4 30 8 60 0)}
Additionally the exact whammy type and style can be specified for both kinds after before the value list.
tb type (value1 value2)tb type style (value1 value2)tbe type (value1 value2)tbe type style (value1 value2)
It is recommended to rely on the auto-detection of the type and only specify the type explicitly if something is wrong:
custom- use this for non standard custom whammys with multiple pointsdive- use this when having a gradual change between two pointsdip- use this when you have a A->B->A whammy pattern.hold- use this when holding whammys (on tied notes)predive- use this when whammy bar is pressed/pulled before playing the note and then kept.predivedive- use this when whammy bar is pressed/pulled before playing the note and then released again.
The style can be one of these values:
default- No additional text is shown, the bend offsets and values are respected as specified.gradual- Will show an additional "grad." on the whammy line. The audio is generated according to the type spread evenly across the play duration.fast- No additional text is shown. The audio is generated according to the type spread evenly across the fixed duration set viasettings.player.songBookBendDuration.
Brushes / Arpeggio​
Brush stroke effects are: brush down bd, brush up bu, arpeggio down ad, and arpeggio up au.
By default, the duration between notes is calculated based on the number of notes in the beat (the chord).
A custom duration (in MIDI ticks) can also be specified with, for example bd 120.
:2 (0.1 0.2 0.3 2.4 2.5 0.6){bd} (0.1 0.2 0.3 2.4 2.5 0.6){bu} |
(0.1 0.2 0.3 2.4 2.5 0.6){ad} (0.1 0.2 0.3 2.4 2.5 0.6){au} |
(0.1 0.2 0.3 2.4 2.5 0.6){bd 360} (0.1 0.2 0.3 2.4 2.5 0.6){bu 60}
Chords​
If you want to specify chords on top of your beats this can be done via the ch "ChordName" effect.
This will annotate the chord name above the beat.
(1.1 3.2 5.3 3.4 1.5){ch "A#add9"} (1.1 3.2 5.3 3.4 1.5)*3 |
(4.1 6.2 6.3 6.4 4.5){ch "C#"} (4.1 6.2 6.3 6.4 4.5)*3 |
(6.1 8.2 8.3 8.4 6.5){ch "D"} (6.1 8.2 8.3 8.4 6.5)*3 |
(0.1 0.2 1.3 2.4 2.5 0.6){ch "E"} (0.1 0.2 1.3 2.4 2.5 0.6)*3
Chord Diagrams
A global metadata tag \chord can define the chord diagram for each chord.
The format is \chord ChordName String1 String2 .... A value must be defined for all strings. x annotates that the string is not played.
Additionally there are 4 properties which adjust the chord details:
FirstFret Number- shifts the first fret shown in the diagram higher.Barre Fret1 Fret2 ...- defines on which frets a barré should be played (visually joins the dots to a bar).ShowDiagram True/False- enables/disables whether the chord diagram should be shown.ShowName True/False- enables/disables whether the chord name is shown above the diagram.
// Simple Chord
\chord "C" 0 1 0 2 3 x
// With barré
\chord{barre 1} "A#add9" 1 3 4 2 1 x
// First Fret higher
\chord{firstfret 6 barre 6} "D#" 6 8 8 8 6 x
// Hide diagram
\chord{showdiagram false} "E" 0 0 1 2 2 0
// Hide name and multiple barre
\chord{showname false barre 1 3} "Special" 3 3 3 1 1 1
.
\ts 2 4
(0.1 1.2 0.3 2.4 3.5){ch "C"} (0.1 1.2 0.3 2.4 3.5) |
(1.1 3.2 5.3 3.4 1.5){ch "A#add9"} (1.1 3.2 5.3 3.4 1.5)|
(6.1 8.2 8.3 8.4 6.5){ch "D#"} (6.1 8.2 8.3 8.4 6.5) |
(0.1 0.2 1.3 2.4 2.5 0.6){ch "E"} (0.1 0.2 1.3 2.4 2.5 0.6) |
(3.1 3.2 3.3 1.4 1.5 1.6){ch "Special"} (3.1 3.2 3.3 1.4 1.5 1.6)
Timer​
Timers are showing the exact timestamp when a beat is played the first time (respecting aspects like repeats).
To enable the display of timers add a timer to the beat effect list.
\tempo 120
.
3.3.4 { timer } 3.3.4*3 |
\ro 3.3.4 { timer } 3.3.4*3 |
3.3.4 { timer } 3.3.4*3 |
\jump fine 3.3.4 { timer } 3.3.4*3 |
\ae (1) 3.3.4 { timer } 3.3.4*3 |
\ae (2 3) \rc 3 3.3.4 { timer } 3.3.4*3 |
3.3.4 { timer } 3.3.4*3 |
\jump DaCapoAlFine 3.3.4 { timer } 3.3.4*3 |
3.3.4 { timer } 3.3.4*3
Tempo Changes​
With the support of multiple tempo changes within a single bar, tempo changes can now be applied on beat level to mark the exact spot when the tempo should be changed.
.
C4 {tempo 120} D4 E4 {tempo 140} F4 | C4.8 {tempo 80} C4 D4 {tempo 100} D4 E4 {tempo 120} E4 F4 {tempo 240} F4
Rasgueado​
Rasgueado patterns can be added to beats via rasg PATTERN where pattern is one of the following values dervived from the patterns
Guitar Pro supports:
IiMiMiiTripletMiiAnapaestPmpTripletPmpAnapaestPeiTripletPeiAnapaestPaiTripletPaiAnapaestAmiTripletAmiAnapaestPppAmiiAmipEamiEamiiPeami(1.1 3.2 2.3 0.4) * 4 {rasg amii}
Slashed Beats​
To use slash notation on beats add the slashed keyword to the effect list.
C4.4 {slashed} C4.8 {slashed} C4.8 {slashed} C4.4 {slashed}
Dead Slap​
To use dead slapped beats the ds keyword to the effect list. As no notes should be on such a beat,
simply use () to indicate the empty beat.
().4 {ds} ().4 {ds}
Beat Timer​
To show the time when a beat is played the first time add timer to the effect list.
:2 C4 { timer } C4 |
\ro C4 { timer } C4 |
\ae 1 C4 C4 { timer } |
\rc 3 \ae (2 3) C4 { timer } C4 { timer } |
C4 { timer } C4
Sustain Pedals​
To mark that on a beat the sustain pedal should be pressed add spd.
To release it again spu
3.3{string} 3.3{spd} 3.3 3.3 {spu}
Golpe​
To mark that on a beat a golpe should be performed with the thumb use glpt, to add a golpe played with a finger use glpf
3.3{glpf} 3.3{glpt}
Wah-Pedal​
To mark that on a beat a wah pedal should be opened waho, and indicate a close use wahc.
3.3 3.3{waho} 3.3 3.3 {wahc}
Barré​
To show barré chord notation, add barre fret mode to the effect list where
fretis the numeric fret of the barré chordmodeis eitherfull(default if no mode specified) orhalf
1.1 {barre 24} 2.1 {barre 24} 3.1 {barre 24} 4.1 |
1.1 {barre 4 half} 2.1 {barre 4 half} 3.1 {barre 4 half} 4.1 {barre 4 half} |
Ottava​
To mark octave changes on beats add ottava value to the effect list where value is one of:
15ma8varegular8vb15mb
3.3.4{ ot 15ma } 3.3.4{ ot 8vb }
Legato​
To indicate a beat starts a legato to the next beat mark it with legatoOrigin:
3.3.4{ legatoOrigin } 10.3.4
Instrument Changes​
To mark a change of the instrument used for playback use the instrument instrumentNumberOrName effect.
See Instrument for details on available instruments.
\instrument ElectricGuitarClean
1.1 2.1 3.1 4.1 | 1.1 { instrument DistortionGuitar txt Distortion } 2.1 3.1 4.1
Fermata​
To mark fermatas add fermata fermataType or fermata fermataType fermataLength to the beat effects.
fermataTypecan beshort,mediumorlongfermataLengthis currently ignored.
G4 G4 G4 { fermata medium 4 }
Beaming Modes​
The beaming modes allow adjusting allow overriding the default beam placement.
beam invert- Inverts the default stem direction.beam up- Forces the stem to point upwards.beam down- Forces the stem to point downwards.beam auto- Sets the beaming mode to automatic.beam split- Forces a split of the beam to the next beat (if there would be any)beam merge- Forces a merge of the beam to the next beat (even if there would be none)beam splitsecondary- Forces a split of the last bar connecting two beats (if there is any).
:8 3.3{ beam invert } 3.3 |
3.1{ beam up } 3.1 |
3.6{ beam down } 3.6 |
3.3{ beam auto } 3.3 |
3.3{ beam split } 3.3 |
3.3 3.3 { beam merge } 3.3 3.3 |
3.3.16 {beam splitsecondary} 3.3