NUMBER-OF-SIM-PCS

[FUNCTION]


Cluster-Rules
Function Reference
ARGUMENTS:
&key
 
  - pc-number    
  - condition    
  - rests-mode    
  - voices    
  - timepoints    
  - input-mode    
  - gracenotes?    
  - rule-type    
  - weight    

Description:

Controls the number of simultaneous pitch classes. Useful, for example, to require that some underlying harmony is expressed.

Args:
PC-number (int): the number of the simultaneous PCs. The meaning of this setting depends on the argument condition.
condition: Whether the number of simultaneous pitch classes should be at least the given PC-number (:min), or exactly that number (:equal), or at most that number (:max).
rests-mode: If set to :reduce-no, then the number of simultaneous pitch classes is subtracted from PC-number. For example, if there is only a single tone at a certain time and all other voices have rests, this rule can still be fulfilled. By contrast, if rests-mode is set to :ignore, then the remaining simultaneous pitch classes must still fullfil the condition expressed by the arguments PC-number and condition.
voices: the list of voices to which the rule is applied.


Other arguments are inherited from r-pitch-pitch.



Auto doc generation by OpenMusic 7.4 © 2024 IRCAM