Definin' Chords

OnSong be havin' th' ability t' display chord diagrams fer chords found in text-based chord charts, savvy? By default, OnSong finds th' default variation o' th' chord in th' Chord Diagram Library. In some cases ye want t' use a specific chord variation fer a song, matey. T' do this, ye define a chord usin' th' ChordPro syntax as follows:

{define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - - key E}

This expression can be divided into th' followin' parts, Arrr!:

• Define begins th' declaration o' a new chord diagram.
• E5 be th' name o' th' chord that be declared. Chords matchin' this name will use th' specified diagram.
• base-fret declares that th' followin' number will be th' fret on which th' chord diagram begins. All frets be relative t' this base fret.
• frets declares that th' followin' will be a space-delimited list o' th' frets t' play. In th' example given, 0 means an open string be t' be played, 1 and 3 be th' first and third fret relative t' th' base fret and "x" means t' not play that string, ye scallywag.
• fingers declares a space-delimited list o' th' fingers t' use on each string. In this particular example, th' - symbol indicates that th' strings be not played with fingers. Th' 1, 2 and 3 indicate th' fingers t' be used fer playin' th' chord.
• key be th' key in which th' chord should be played. Not currently supported.

If th' chord definition does not exist in th' Chord Diagram Library, it be added and set as th' default variation fer th' song, Blimey! OnSong applies th' chord t' th' guitar instrument when six strings be defined, th' 5-string bass when five strings be defined, and th' default instrument when 4 or another number o' strings be used, matey!