USEPATTERN: verschil tussen versies

Huidige versie van 15 apr 2024 om 20:41

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 );

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.

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)

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

@@ Regel 1: / Regel 1: @@
-'''USEPATTERN''' is een commando dat je kunt gebruiken in een [[opmaaksjablonen|opmaaksjabloon]] om daarmee het huidige bestand uit te breiden met een arrangement op basis van een [[arrangementbestanden|arrangementbestand]]
+'''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
@@ Regel 5: / Regel 5: @@
 Arrangementbestanden vereisen een specifieke benaming om gebruikt te kunnen worden als arrangement:
-   pat-#-#-{{Literal|arrangementnaam}}.arr
+   pat-#-#-arrangementnaam.arr
-Het gedeelte {{Literal|#-#}} staat voor de maatsoort waarin het arrangementbestand gebruikt kan worden, {{Literal|arrangementnaam}} is de naam waarmee het arrangement wordt aangeroepen in het commando USEPATTERN() en {{Literal|.arr}} is de extensie voor arrangementsbestanden. Zo kun je met 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.
+Het gedeelte {{Literal|#-#}} staat voor de [[maatsoort]] waarin het arrangementbestand gebruikt kan worden, {{Literal|arrangementnaam}} is de naam waarmee het arrangement wordt aangeroepen in het commando USEPATTERN() en {{Literal|.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.
-Voorbeeld:
+==Voorbeelden==
-  melodie "patroon-bossanova"
+ melodie "#gAccomp|#patLatinBossa"
-  !%TemplateNL: Begeleidingspatronen|Bossanova begeleiding}}
+ !# REQUIRE( sMeter=4/4, #errNeed4-4 );
-  !%TemplateUK: Accompaniment patterns|Bossa nova accompaniment}}
+ !# REQUIRE( nChords>0, #errNoChordsFound );
-  !%TemplateDE: Begleitungspatronen|Bossa nova Begleitung}}
+ !# DELETEPART( AUTO );
-  !# USEPATTERN(bossanova);
+ !# 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 {{Literal|pat-4-4-bossanova-gitaar.arr}}, {{Literal|pat-4-4-bossanova-bas.arr}} en {{Literal|pat-4-4-bossanova-perc.arr}} toegepast worden (mits aanwezig).  Tot slot wordt in de [[kop en voet|kop]] aangegeven dat de begeleiding een 'Bossa-nova' betreft ([[SET]])
-Als de maatsoort 4/4 van het geopende te arrangeren muziekje was zal het arrangementbestand {{Literal|pat-4-4-bossanova.arr}} toegepast worden (mits aanwezig).
+==zie ook==
+* [[Begeleidingsarrangement]]
-==zie ook==
-* [[ADDPART]]
+{{NavTemplates}}
-* [[SELECTPART]]
+[[en:USEPATTERN]]
-* [[MODIFYPART]]
-* [[SETPART]]
-* [[TRANSPOSE]]
-* [[OPENLIST]]
-* [[SAVEFILE]]
-* [[OPENFILE]]
-* [[USEPATTERN]]