org.deepsymmetry.beatlink

Class MixerStatus

java.lang.Object

org.deepsymmetry.beatlink.DeviceUpdate

org.deepsymmetry.beatlink.MixerStatus

public class MixerStatus
extends DeviceUpdate

Represents a status update sent by a mixer on a DJ Link network.

Author:

James Elliott

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATUS_FLAGS The byte within the packet which contains useful status information, labeled F in Figure 10 of the Packet Analysis document.

Fields inherited from class org.deepsymmetry.beatlink.DeviceUpdate

address, deviceName, deviceNumber, packetBytes, timestamp

Constructor Summary

Constructors

Constructor and Description
MixerStatus(DatagramPacket packet) Constructor sets all the immutable interpreted fields based on the packet content.

Method Summary

Modifier and Type	Method and Description
int	getBeatWithinBar() Get the position within a measure of music at which the most recent beat occurred (a value from 1 to 4, where 1 represents the down beat).
int	getBpm() Get the BPM at the time of the update.
double	getEffectiveTempo() Get the effective tempo reflected by this update, which reflect both its track BPM and pitch as needed.
boolean	isBeatWithinBarMeaningful() Returns true if this beat is coming from a device where getBeatWithinBar() can reasonably be expected to have musical significance, because it respects the way a track was configured within rekordbox.
boolean	isTempoMaster() Is this mixer reporting itself to be the current tempo master?
String	toString()

Methods inherited from class org.deepsymmetry.beatlink.DeviceUpdate

getAddress, getDeviceName, getDeviceNumber, getPacketBytes, getTimestamp

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

STATUS_FLAGS

public static final int STATUS_FLAGS

The byte within the packet which contains useful status information, labeled F in Figure 10 of the Packet Analysis document.

See Also:

Constant Field Values

Constructor Detail

MixerStatus

public MixerStatus(DatagramPacket packet)

Constructor sets all the immutable interpreted fields based on the packet content.

Parameters:

packet - the beat announcement packet that was received

Method Detail

getBpm

public int getBpm()

Get the BPM at the time of the update. This is an integer representing the BPM times 100, so 120.5 BPM would be represented by the value 12050.

Returns:

the current BPM to two decimal places multiplied by 100

getBeatWithinBar

public int getBeatWithinBar()

Get the position within a measure of music at which the most recent beat occurred (a value from 1 to 4, where 1 represents the down beat). The mixer makes no effort to synchronize down beats with players, however, so this value is of little use.

Specified by:

getBeatWithinBar in class DeviceUpdate

Returns:

the beat number within the current measure of music, as far as the mixer knows

isBeatWithinBarMeaningful

public boolean isBeatWithinBarMeaningful()

Returns true if this beat is coming from a device where getBeatWithinBar() can reasonably be expected to have musical significance, because it respects the way a track was configured within rekordbox.

Specified by:

isBeatWithinBarMeaningful in class DeviceUpdate

Returns:

false because mixers make no effort to line up their beats with rekordbox-identified measures

isTempoMaster

public boolean isTempoMaster()

Is this mixer reporting itself to be the current tempo master?

Specified by:

isTempoMaster in class DeviceUpdate

Returns:

true if the mixer that sent this update is the master

getEffectiveTempo

public double getEffectiveTempo()

Description copied from class: DeviceUpdate

Get the effective tempo reflected by this update, which reflect both its track BPM and pitch as needed.

Specified by:

getEffectiveTempo in class DeviceUpdate

Returns:

the beats per minute this device is reporting

toString

public String toString()

Overrides:

toString in class Object