plugsync~ Reference

Report host synchronization information

plugsync~

Description

The plugsync~ object provides information about the current state of Ableton Live host applicaiton.

Discussion

Sample count information is available in any host; even Max. The validity of the other information output by the object is dependent upon what synchronization capabilities the host implements; the value from the flags (9th) outlet tells you what information is valid. Output from plugsync~ is continuous when the scheduler is running. Note: plug-in building for hosts other than Ableton Live is no longer supported. For more information to help you make the transition to creating plug-ins in Max for Live, see Max for Live for Pluggo Developers.

Arguments

None.

Attributes

Common Box Attributes

Messages

bang

bang message may be used to manually poll the plugsync~ object that cause it to output timing information.

Output

float

Out 4nd outlet: The current beat fraction, from 0 to 1.0. If the host does not support synchronization, the output is 0. If the host does not support synchronization, there is no output from this outlet.

float

Out 6th outlet: The current tempo in samples per beat. This number can be converted to beats per minute using the following formula: (sampling-rate / samples-per-beat) * 60. If the host does not support synchronization, there is no output from this outlet.

float

Out 7th outlet: The current number of beats, expressed in 1 PPQ. This number will contain a fractional part between beats. If the host does not support synchronization, there is no output from this outlet.

int

Out left outlet: 1 if the host's transport is currently running; 0 if it is stopped or paused.

int

Out 2nd outlet: The current bar count in the host sequence, starting at 1 for the first bar. If the host does not support synchronization, there is no output from this outlet.

int

Out 3rd outlet: The current beat count in the host sequence, starting at 1 for the first beat. If the host does not support synchronization, there is no output from this outlet.

int

Out 8th outlet: The current sample count, as defined by the host.

int

Out 9th outlet: A number representing the validity of the other information coming from plugsync~. Mask with the following values to determine if the information from plugsync~ will be valid.

Sample Count Valid - 1 (always true)

Beats Valid - 2 (2nd, 3rd, 4th, and 7th outlets valid)

Time Signature Valid - 4 (5th outlet valid)

Tempo Valid - 8 (6th outlet valid)

Transport Valid - 16 (left outlet valid)

list

Out 5th outlet: The current time signature as a list containing numerator followed by denominator. For instance, 3/4 time would be output as the list 3 4. If the host does not support time signature information, there is no output from this outlet.

See Also

Name Description
plugphasor~