METRIC-ACCENTS

[FUNCTION]


Cluster-Rules
Function Reference
ARGUMENTS:
&key
 
  - voices    
  - metric-structure    
  - accent-rule    
  - strictness    
  - format    
  - gracenote-mode    
  - rule-type    
  - weight    

Description:

Restricts where metric accents occur depending on the underlying meter. If an accent occurs, then it is on the position defined.


Args:
metric-structure: Position where accents are controlled (on any beat or the first beat of a measure).

accent-rule (menu item or function): A function returning true if an accent is expressed and nil otherwise. The function expects one of more arguments, all by default (if format is :d_offs) in the form (dur offs), where dur is the duration of a note and offs is the offset to the following accent (i.e. the duration until the following accent). Example: '(1/4 -1/8). A note is 'on' the accent if its offset = 0.
Some accent rules are predefined and can be simply selected in the menu of the argument. Other predefined accent rules expect additional arguments controlling their effect. These are available under the Cluster Rules sub menu rhythm - accent rules.

When accent-rule expects multiple arguments (data for multiple consecutive notes), on which note the metric accent is forced to occur depends on the number of arguments expected by accent-rule.
- 1 argument: that note
- 2 arguments: the second note
- 3 arguments: the second note
- 4 arguments: the fourth note
More arguments are currently not supported.

Some accent rules are predefined and can be simply selected in the menu of the argument.
:longer-than-predecessor: Accented notes are longer than the preceeding note and at least as long as the succeeding note. BUG: not constrained for first and last 2 notes! (fixing that needs more flexible rule applicators)
:longer-than-neighbours: Accented notes are longer than the preceeding and the succeeding note. BUG: not constrained for first and last 2 notes!

Other predefined accent rules expect additional arguments controlling their effect. These are available under the Cluster Rules sub menu rhythm - accent rules.

strictness: Controls how events are constrained. There are three different cases.
:note: if an event meets the accent-rule, then it must be on a specified metric position (see metric-structure). However, there can be such metric positions without notes meeting the accent-rule.
:position: if an event is on a specified metric position (see metric-structure) then it must meet the accent-rule. However, there can be accentuated notes at other metric positions. Also, if a note continues sounding at the specified position that started earlier (syncopation) then no accent at that position can be enforced (because only notes are checked, not metric positions).
:note-n-position: if an event meets the accent-rule, then it must be on a specified metric position -- and vice versa.

Other arguments are inherited from r-note-meter.




Auto doc generation by OpenMusic 7.4 © 2024 IRCAM