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

hostcontrol~ Reference

Control a ReWire host's transport

hostcontrol~

Description

When you choose the ad_rewire driver in the Audio Status window, the hostcontrol~ object lets you send commands to the ReWire host to start and stop the transport, set the transport position, change the tempo, change the time signature, and set loop points.

Arguments

None.

Attributes

Common Box Attributes

Messages

int

Arguments

playback-flag (1 or 0) [int]
1 starts playing from the beginning. 0 stops playing and resets the position to the beginning.

bpm

Arguments

host-tempo [float]
The word bpm, followed by a number (in beats per minute), changes the host's tempo.

loop

Arguments

state (0 or nonzero), start (1-PPQ-ticks), and end (1-PPQ-ticks) [list]
The word loop, followed by one or three numbers, controls the host's loop state. If the first number is non-zero, looping will be enabled; otherwise, it will be turned off. An optional second and third number may be used to specify the loop start and end points, expressed in 1 PPQ ticks. If the second and third numbers are not present, the loop points are not changed.

pause

The word pause stops playback without changing the current position.

resume

The word resume starts playback from the current position.

seek

Arguments

transport-position (1-PPQ-ticks) [float]
The word seek, followed by a number specifying ticks (in 1 PPQ), sets the current transport position. For example, to seek to the start of the fifth measure if the time signature is 4/4 the send the message "seek 16".

tempo

Arguments

host-tempo [float]
The word tempo, followed by a number (in samples per beat), changes the host's tempo.

timesig

Arguments

host-time-signature (numerator) [int]
host-time-signature (denominator) [int]
The word timesig, followed by two numbers that specify numerator and denominator values, changes the host's time signature. For example, to set the time signature to 3/4 send the message timesig 3 4.

Output

Rewire

Controls a Rewire host.

See Also

Name Description
hostphasor~
hostsync~