USEPATTERN

USEPATTERN is een sjabloonfunctie die je kunt gebruiken in een opmaaksjabloon om daarmee het huidige muziekbestand te voorzien van een nieuwe partij op basis van een arrangementbestand.

Syntax

 USEPATTERN( arrangementnaam );
 USEPATTERN( arrangementnaam, conditie );

Arrangementbestanden vereisen een specifieke benaming om gebruikt te kunnen worden als arrangement:

 pat-#-#-arrangementnaam.arr

Het gedeelte #-# staat voor de maatsoort waarin het arrangementbestand gebruikt kan worden, arrangementnaam is de naam waarmee het arrangement wordt aangeroepen in het commando USEPATTERN() en .arr is de extensie voor arrangementsbestanden. Zo kun je voor een arrangement met naam arpeggio-up-down voor verschillende maatsoorten arrangementen definiëren. Bij het uitvoeren van de USEPATTERN instructie in het opmaaksjabloon wordt afhankelijk van de maatsoort van het te arrangeren muziekje het bijbehorende arrangementbestand gebruikt.

Een 'conditie' in een USEPATTERN commando maakt dat het patroon alleen wordt toegepast als aan de conditievoorwaarde is voldaan. Als het patroon alleen mag worden gebruikt voor een driekwartsmaat geef je als conditie mee: sMeter=3/4

Voorbeelden

melodie "#gAccomp|#patLatinBossa"
!# REQUIRE( sMeter=4/4, #errNeed4-4 ); 
!# REQUIRE( nChords>0, #errNoChordsFound ); 
!# DELETEPART( AUTO );
!# USEPATTERN(bossanova-gitaar);
!# USEPATTERN(bossanova-bas);
!# USEPATTERN(bossanova-perc);
!# SET( sInfo, Bossa-nova);

Als de maatsoort niet 4/4 is, of als geen akkoordsymbolen aanwezig zijn, wordt een foutmelding gegeven en stopt de sjabloonverwerking. Als voldaan was aan de eisen (REQUIRE) dan worden aanwezige automatische partijen verwijderd (DELETEPART) en worden zullen de arrangementbestanden pat-4-4-bossanova-gitaar.arr, pat-4-4-bossanova-bas.arr en pat-4-4-bossanova-perc.arr toegepast worden (mits aanwezig). Tot slot wordt in de kop aangegeven dat de begeleiding een 'Bossa-nova' betreft (SET)

melodie "#gAccomp|Balkan - Sevdah";
!# REQUIRE( sMeter=4/4, OR );
!# REQUIRE( sMeter=3/4, OR );
!# REQUIRE( sMeter=2/4, #errMeter );
!# DELETEPART( AUTO ); 
!# USEPATTERN(sevdah-guitar, sMeter=2/4);
!# USEPATTERN(sevdah-guitar, sMeter=4/4);
!# USEPATTERN(xx-bas, sMeter=2/4);
!# USEPATTERN(xx-bas, sMeter=3/4);
!# USEPATTERN(xx-bas, sMeter=4/4);
!# USEPATTERN(sevdah-snare, TRUE);
!# USEPATTERN(sevdah-accordion, sMeter=4/4);
!# USEPATTERN(sevdah-accordion, sMeter=3/4);
!# SET( sInfo=[Sevdah] );

De conditie TRUE maakt dat het patroon altijd wordt gebruikt afgebroken of aangevuld tot de gevraagde maatsoort.

zie ook

• Begeleidingsarrangement

Sjabloonfuncties

ADDPART • CALCULATE • COMMAND • CONFIRM • DELETEPART • ERROR • MESSAGE • MODIFYPART • OPENFILE • OPENLIST • PROMPT • REQUIRE • SAVEFILE • SELECTPART • SET • SETPART • TRANSPOSE • USEPATTERN • USETEMPLATE

FAQ • gereedschapskist • speciale constructies • condities • maken • parameters • speellijst • variabelen • vertaling