A newer version of Max is available. Click here to access the latest version of the documentation

thispoly~ Reference

Control poly~ voice allocation and muting

thispoly~

Description

Use the thispoly~ object to control poly~ voice allocation and muting. When placed inside a patcher loaded by the poly~ object, it sends and receives messages from the poly~ object that loads it.

Examples

thispoly~ reports the instance number of its poly~ subpatcher

Arguments

None.

Attributes

Common Box Attributes

Messages

bang

Reports the instance number of the patch. The first instance is reported as 1.

int

Arguments

busy-state [int]
Toggles the "busy" state for the patcher instance when the message busy 1 is received. The object will not receive messages generated by a note or midinote message to the left inlet of the parent poly~ object when the "busy" state is on.

mute

Arguments

mute-flag [int]
Disables DSP processing for the loaded instance of the patcher when the message mute 1 is received. This message can be combined with an int message which toggles the "busy" state of the patcher to create voices in a patcher which are only on while they play a "note".

signal

Sets the "busy" state of the patcher instance. The busy state for the patcher instance is set to 1 when the thispoly~ object receives a non-zero input signal. The busy state is set to 0 otherwise.

Output

instance

Out left outlet: The instance number, starting at 1, reported when thispoly~ receives the bang message. If the patcher containing thispoly~ was not loaded within a poly~ object, 0 is output.

mute

Out middle outlet: If the loaded instance of the patcher is muted, a 1 is output. If the instance is not muted, a 0 is output.

voice count

Out right outlet: The total poly~ voice count, reported when thispoly~ receives the bang message. If the patcher containing thispoly~ was not loaded within a poly~ object, 1 is output.

See Also

Name Description
Polyphony Polyphony
in
in~
out
out~
poly~
MSP Polyphony Tutorial 1: Using the poly~ Object MSP Polyphony Tutorial 1: Using the poly~ Object