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 arrangementsbestand gebruikt kan worden, arrangementsnaam 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 arpeggioUpDown 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 arrangementsbestand 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

Als een arrangementsbestand niet bestaat maar een vergelijkbaar bestand met -xx- wel, dan wordt dat laatste gebruikt. (Hierdoor kan het aantal arrangementsbestanden een klein beetje beperkt worden; 40+ begeleidingen × 10+ maatsoorten × 4 partijijen.)

In plaats van een conditie zoals hierboven kun je OPTIONAL en NONDEFAULT gebruiken:

• OPTIONAL maakt het aanwezig zijn van het arrangementsbestand voor de maatsoort 'optioneel', er volgt geen waarschuwing. Dit is nuttig als je voor een bepaalde maatsoort een extra partij kunt genereren met een arrangementsbestand maar dit (nog) niet voor alle mogelijke maatsoorten hebt gerealiseerd.
• NONDEFAULT voorkomt het gebruik van het -xx- bestand als het gevraagde arrangementsbestand niet gevonden werd.

Beide opties kun je combineren met een '|' teken: NONDEFAULT|OPTIONAL

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( sStyle, [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|#patWorldBS";
!# REQUIRE( sMeter=4/4, OR );
!# REQUIRE( sMeter=3/4, OR );
!# REQUIRE( sMeter=2/4, #errMeter );
!# DELETEPART( AUTO ); 
!# USEPATTERN(sevdah-guitar, OPTIONAL);
!# USEPATTERN(xx-bas, OPTIONAL);
!# USEPATTERN(sevdah-snare, OPTIONAL);
!# USEPATTERN(sevdah-accordion, OPTIONAL);
!# SET( sStyle=[BS] );

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