Sjabloonfuncties

Met sjabloonfuncties kun je slimme opmaaksjablonen maken die allerlei functies uitvoeren zoals het selecteren van partijen, transponeren van een partij/partituur, toevoegen en bewerken van partijen en het opslaan van muziek in andere formaten (.mid, .pdf).

• ADDPART( autopartij );
• CONFIRM( melding [ [, yessjabloon], nosjabloon] );
• ERROR( melding );
• MESSAGE( melding );
• MODIFYPART( partijbewerking );
• OPENLIST( speellijstnaam );
• OPENFILE( PREV|NEXT|FIRST|LAST|naam );
• PROMPT( melding, variabele );
• REQUIRE( conditie [ [, melding], opdracht] ) );
• SAVEFILE( extensie );
• SELECTPART( MAIN|PREV|NEXT|FULL|LAST|naam );
• SET( parameter, waarde );
• SETPART( partijparameter, waarde );
• TRANSPOSE( aantal halve tonen );
• USEPATTERN( arrangementnaam );
• USETEMPLATE( sjabloonnaam [, conditie[, andersjabloon] ] );

Voor een alfabetisch overzicht van mogelijk te gebruiken parameters zie: sjabloonparameters

Voorbeelden

---

Een opmaaksjabloon dat een tweestemmige partij splitst heeft ongeveer als inhoud:

melodie "#gTools|#splitIntoSeparate";
!# SELECTPART(MAIN);  
!# SETPART(sVoicename,Bovenstem);  
!# ADDPART(COPY1);
!# SETPART(sVoiceName,Onderstem);
!# MODIFYPART(RemoveHighvoice);
!# SETPART(iInstrument,65);
!# SETPART(sMelodyName,AltSax);
!# SETPART(sAbbreviation,Ax);
!# SELECTPART(Bovenstem);
!# MODIFYPART(RemoveLowvoice);

---

Een sjabloon dat de plaats van liedtekst en akkoordsymbolen onder resp. boven de balk wisselt ziet eruit als:

melodie "#gLayout|#toggleChordpos";
!# REQUIRE( nChords>0, #noChordsFound ); 
!# USETEMPLATE( mc-textbelow, fLyrics1.y>0, mc-textabove );

Het sjabloon gebruikt de functie REQUIRE() om te testen of er überhaupt akkoordsymbolen gebruikt zijn in de muziek. Als dat niet het geval is is wordt de melding #noChordsFound gegeven, en worden volgende sjabloonfuncties niet meer uitgevoerd. Als zo'n melding begint met een hashtag (#) wordt deze opgezocht in het vertalingsbestand. De hier gebruikte sjabloonfunctie USETEMPLATE() test of liedtekst-1 boven het midden van de balk staat met fLyrics1.y>0. Als dat het geval is wordt vervolgens sjabloon mc-tekstbelow opgezocht en uitgevoerd. In het andere geval wordt mc-textabove uitgevoerd.

---

Het sjabloon mc-patFolk-CYG heeft inhoud:

melodie "#gAccomp|#patFolkCYG";
!# REQUIRE( nChords>0, errNoChordsFound ); 
!# REQUIRE( sMeter=4/4, #errNeed4-4 ); 
!# USEPATTERN(cocek-acc);
!# USEPATTERN(cocek-bas);
!# USEPATTERN(cocek-darabuka);
!# SET( sInfo, Cocek);
!# SET( bAutoBass, 0 );
!# SET( bAutoChords, 0 ); 

De eerste regel maakt dat het sjabloon in de groep begeleidingspatronen zichtbaar wordt als 'Folk - Zigeuner'. Om bruikbaar te zijn moeten akkoordsymbolen aanwezig zijn en moet de maatsoort 4/4 zijn. Als aan beide voorwaarden voldaan is (REQUIRE), worden drie arrangementspatronen toegepast (USEPATTERN), de Info tekst op Cocek gezet, en de bestaande automatische begeleidingspartijen uitgeschakeld.

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