Package com.bitwig.extension.controller.api

Interface BeatTimeValue

All Superinterfaces:

DoubleSupplier, DoubleValue, Subscribable, Value<DoubleValueChangedCallback>

All Known Subinterfaces:

SettableBeatTimeValue

public interface BeatTimeValue
extends DoubleValue

Instances of this interface represent beat time values. Beat time values are double-precision number representing the number of quarter notes, regardless of time-signature.

Since:

API version 1

Method Summary

Modifier and Type	Method	Description
void	addRawValueObserver(DoubleValueChangedCallback callback)	Deprecated. This exists for backwards compatibility.
void	addTimeObserver(String separator, int barsLen, int beatsLen, int subdivisionLen, int ticksLen, StringValueChangedCallback callback)	Deprecated. Use getFormatted(BeatTimeFormatter) instead.
String	getFormatted()	Gets the current beat time formatted according to the default beat time formatter.
String	getFormatted(BeatTimeFormatter formatter)	Gets the current beat time formatted according to the supplied formatter.

Methods inherited from interface com.bitwig.extension.controller.api.DoubleValue

get, getAsDouble

Methods inherited from interface com.bitwig.extension.controller.api.Subscribable

isSubscribed, setIsSubscribed, subscribe, unsubscribe

Methods inherited from interface com.bitwig.extension.controller.api.Value

addValueObserver, markInterested

Method Details

addRawValueObserver

@Deprecated
void addRawValueObserver(DoubleValueChangedCallback callback)

Deprecated.

This exists for backwards compatibility. Use Value.addValueObserver(ValueChangedCallback) instead.

Add an observer which receives the internal raw of the parameter as floating point.

Parameters:

callback - a callback function that receives a single numeric parameter with double precision.

Since:

API version 1

getFormatted

String getFormatted(BeatTimeFormatter formatter)

Gets the current beat time formatted according to the supplied formatter.

Since:

API version 2

getFormatted

String getFormatted()

Gets the current beat time formatted according to the default beat time formatter.

Since:

API version 2

See Also:

• ControllerHost.setDefaultBeatTimeFormatter(BeatTimeFormatter)

addTimeObserver

@Deprecated
void addTimeObserver(String separator,
 int barsLen,
 int beatsLen,
 int subdivisionLen,
 int ticksLen,
 StringValueChangedCallback callback)

Deprecated.

Use getFormatted(BeatTimeFormatter) instead.

Registers an observer that reports the internal beat time value as formatted text, for example "012:03:00:01".

Parameters:

separator - the character used to separate the segments of the formatted beat time, typically ":", "." or "-"

barsLen - the number of digits reserved for bars

beatsLen - the number of digits reserved for beats

subdivisionLen - the number of digits reserved for beat subdivisions

ticksLen - the number of digits reserved for ticks

callback - a callback function that receives a single string parameter

Since:

API version 1