Package com.bitwig.extension.controller.api

Interface AbsoluteHardwareControl

All Superinterfaces:

ContinuousHardwareControl<AbsoluteHardwareControlBinding>, HardwareBindingSource<AbsoluteHardwareControlBinding>, HardwareControl, HardwareElement

All Known Subinterfaces:

AbsoluteHardwareKnob, HardwareSlider

public interface AbsoluteHardwareControl
extends ContinuousHardwareControl<AbsoluteHardwareControlBinding>

Represents a hardware control that can input and absolute value (for example, a slider, knob or foot pedal).

Since:

API version 10

Method Summary

Modifier and Type	Method	Description
AbsoluteHardwareControlBinding	addBindingWithRange(AbsoluteHardwarControlBindable target, double minNormalizedValue, double maxNormalizedValue)	Adds a new binding from this hardware control to the supplied target.
void	disableTakeOver()	Determines if this hardware control should immediately take over the parameter it is bound to rather than respecting the user's current take over mode.
void	setAdjustValueMatcher(AbsoluteHardwareValueMatcher matcher)	Sets the AbsoluteHardwareValueMatcher that can be used to detect when the user adjusts the hardware control's value.
AbsoluteHardwareControlBinding	setBindingWithRange(AbsoluteHardwarControlBindable target, double minNormalizedValue, double maxNormalizedValue)	Convenience methods that ensures there is only a single binding to the supplied target.
DoubleValue	value()	The current value of this hardware control (0..1)

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

hardwareButton, hasTargetValue, isUpdatingTargetValue, modulatedTargetDisplayedValue, modulatedTargetValue, setHardwareButton, targetDisplayedValue, targetName, targetValue

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

addBinding, canBindTo, clearBindings, setBinding

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

backgroundLight, beginTouchAction, endTouchAction, getName, isBeingTouched, setBackgroundLight, setIndexInGroup, setName

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

getHeight, getId, getLabel, getLabelColor, getLabelPosition, getWidth, getX, getY, setBounds, setLabel, setLabelColor, setLabelPosition

Method Details

setAdjustValueMatcher

void setAdjustValueMatcher(AbsoluteHardwareValueMatcher matcher)

Sets the AbsoluteHardwareValueMatcher that can be used to detect when the user adjusts the hardware control's value.

See Also:

• MidiIn.createAbsoluteCCValueMatcher(int, int)
• MidiIn.createAbsoluteValueMatcher(String, String, int)

value

DoubleValue value()

The current value of this hardware control (0..1)

disableTakeOver

void disableTakeOver()

Determines if this hardware control should immediately take over the parameter it is bound to rather than respecting the user's current take over mode. This is useful for motorized sliders for example, where the slider is already at the value of the bound parameter.

addBindingWithRange

AbsoluteHardwareControlBinding addBindingWithRange(AbsoluteHardwarControlBindable target,
 double minNormalizedValue,
 double maxNormalizedValue)

Adds a new binding from this hardware control to the supplied target.

setBindingWithRange

AbsoluteHardwareControlBinding setBindingWithRange(AbsoluteHardwarControlBindable target,
 double minNormalizedValue,
 double maxNormalizedValue)

Convenience methods that ensures there is only a single binding to the supplied target. This is equivalent to calling HardwareBindingSource.clearBindings() and then addBindingWithRange(AbsoluteHardwarControlBindable, double, double)