USEPATTERN

USEPATTERN is a command you can use in a layout template to provide the current tune with a new part based on an arrangement file.

Syntax

  USEPATTERN( arname );

Arrangement files require a specific name to be used as an arrangement:

  pat-#-#-arname.arr

The part #-# represents the time signature for which the arrangement file is intended, arname is the name to be used in the USEPATTERN command and .arr is the extension for arrangement files. For example, you can use for an arrangement called arpeggio-up-down to define arpeggios for different time signatures.

When executing the USEPATTERN instruction in the arrangement layout template, the corresponding arrangement file is used, depending on the time signature of the piece of music to be arranged.

Example

  melody "pattern-bossanova";
  !%TemplateNL: Begeleidingsarrangement|Bossanova begeleiding}}
  !%TemplateUK: Accompaniment arrangement|Bossa nova accompaniment}}
  !%TemplateDE: Begleitungsarrangement|Bossa nova Begleitung}}
  !# USEPATTERN( bossanova-bass );
  !# USEPATTERN( bossanova-claves );
  !# USEPATTERN( bossanova-guitar );

If the time signature was 4/4 of the opened music to arrange, the arrangement files pat-4-4-bossanova-bass.arr, pat-4-4-bossanova-claves.arr and pat-4-4-bossanova-guitar.arr will be applied (if present).

Example

see also