Sjabloonfuncties: verschil tussen versies
Geen bewerkingssamenvatting |
Geen bewerkingssamenvatting |
||
Regel 43: | Regel 43: | ||
De hier gebruikte sjabloonfunctie [[USETEMPLATE]]() test of [[Liedtekst|liedtekst-1]] boven het midden van de balk staat met {{literal|fLyrics1.y>0}}. Als dat het geval is wordt vervolgens sjabloon {{literal|mc-tekstbelow}} opgezocht en uitgevoerd. In het andere geval wordt {{literal|mc-textabove}} uitgevoerd. | De hier gebruikte sjabloonfunctie [[USETEMPLATE]]() test of [[Liedtekst|liedtekst-1]] boven het midden van de balk staat met {{literal|fLyrics1.y>0}}. Als dat het geval is wordt vervolgens sjabloon {{literal|mc-tekstbelow}} opgezocht en uitgevoerd. In het andere geval wordt {{literal|mc-textabove}} uitgevoerd. | ||
---- | |||
Het sjabloon {{literal|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 betsaande [[automatische begeleidingspartij]]en uitgeschakeld. | |||
Versie van 1 mrt 2024 12:53
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 betsaande automatische begeleidingspartijen uitgeschakeld.
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