Package heronarts.glx.ui.component

Class UIParameterControl

java.lang.Object

heronarts.glx.ui.UIEventHandler

heronarts.glx.ui.UIObject

heronarts.glx.ui.UI2dComponent

heronarts.glx.ui.component.UIParameterComponent

heronarts.glx.ui.component.UIInputBox

heronarts.glx.ui.component.UIParameterControl

All Implemented Interfaces:

UIContextActions, UIControlTarget, UICopy, UIFocus, UIKeyFocus, UIModulationSource, UIModulationTarget, UIMouseFocus, UIPaste, UITabFocus, LXLoopTask, LXParameterListener

Direct Known Subclasses:

UICompoundParameterControl, UISwitch

public abstract class UIParameterControl
extends UIInputBox
implements UIControlTarget, UIModulationTarget, UIModulationSource, LXParameterListener, UICopy, UIPaste

Nested Class Summary

Nested classes/interfaces inherited from class heronarts.glx.ui.component.UIInputBox

UIInputBox.EditState, UIInputBox.FillStyle, UIInputBox.ProgressIndicator

Nested classes/interfaces inherited from class heronarts.glx.ui.UI2dComponent

UI2dComponent.Scissor, UI2dComponent.Scissored, UI2dComponent.UIDragReorder

Nested classes/interfaces inherited from interface heronarts.glx.ui.UIContextActions

UIContextActions.Action, UIContextActions.ContextAction

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	enabled
protected boolean	keyEditable
protected static final int	LABEL_HEIGHT
protected static final int	LABEL_MARGIN
protected LXNormalizedParameter	parameter
protected LXParameter.Polarity	polarity
static final int	TEXT_MARGIN

Fields inherited from class heronarts.glx.ui.component.UIInputBox

editable, editing, fillColor, fillStyle, hasFill, mouseEditable, returnKeyEdit

Fields inherited from class heronarts.glx.ui.component.UIParameterComponent

DEFAULT_HEIGHT, useCommandEngine

Fields inherited from class heronarts.glx.ui.UI2dComponent

borderRoundingBottomLeft, borderRoundingBottomRight, borderRoundingTopLeft, borderRoundingTopRight, debug, debugName, hasBorderRounding, height, marginBottom, marginLeft, marginRight, marginTop, redraw, scissor, textAlignHorizontal, textAlignVertical, textOffsetX, textOffsetY, width, x, y

Fields inherited from class heronarts.glx.ui.UIObject

children, hasFocus, visible

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	UIParameterControl(float x, float y, float w, float h)

Method Summary

Modifier and Type	Method	Description
protected void	decrementValue(KeyEvent keyEvent)	Subclasses may optionally override to decrement value in response to arrows.
void	dispose()
static void	drawParameterLabel(UI ui, VGraphics vg, UI2dComponent component, String labelText)
protected double	getBaseNormalized()
LXNormalizedParameter	getControlTarget()
String	getDescription()	Objects are encouraged to override this method providing a helpful String displayed to the user explaining the function of this UI component.
static String	getDescription(LXParameter parameter)
protected UIColor	getFocusColor(UI ui)
static int	getModulatedValueColor(int baseColor)	Given a base color for a control, return the color used to display the modulated component of its value.
LXNormalizedParameter	getModulationSource()
LXCompoundModulation.Target	getModulationTarget()
LXNormalizedParameter	getParameter()
protected String	getValueString()
protected void	incrementValue(KeyEvent keyEvent)	Subclasses may optionally override to decrement value in response to arrows.
boolean	isEnabled()
boolean	isShowLabel()
protected boolean	isTriggerParameter()
protected boolean	isValidCharacter(char keyChar)
protected boolean	isWrappable()
protected void	onBlur()	Subclasses override when element loses focus
LXClipboardItem	onCopy()
protected void	onDraw(UI ui, VGraphics vg)	Subclasses should override this method to perform their drawing functions.
protected void	onKeyPressed(KeyEvent keyEvent, char keyChar, int keyCode)	Subclasses override to receive key events
protected void	onKeyReleased(KeyEvent keyEvent, char keyChar, int keyCode)	Subclasses override to receive key events
protected void	onMousePressed(MouseEvent mouseEvent, float mx, float my)	Subclasses override to receive mouse events
protected void	onMouseReleased(MouseEvent mouseEvent, float mx, float my)	Subclasses override to receive mouse events
void	onParameterChanged(LXParameter parameter)	Invoked when the value of a parameter is changed.
void	onPaste(LXClipboardItem item)
protected void	saveEditBuffer(String editBuffer)
UIInputBox	setEditable(boolean editable)
UIParameterControl	setEnabled(boolean enabled)
UIParameterControl	setLabel(String label)
protected UIParameterControl	setNormalized(double normalized)
UIParameterControl	setParameter(LXNormalizedParameter parameter)
UIParameterControl	setPolarity(LXParameter.Polarity polarity)
UIParameterControl	setShowLabel(boolean showLabel)

Methods inherited from class heronarts.glx.ui.component.UIInputBox

disableImmediateAppend, disableImmediateEdit, disableReturnKeyEdit, edit, edit, editAppend, enableImmediateAppend, enableImmediateEdit, enableReturnKeyEdit, getEditBuffer, getEditRange, getFillWidthNormalized, getInitialEditBufferValue, incrementMouseValue, isEditable, onDrawText, onEditChange, onEditFinished, onMouseDragged, setMouseEditable, setProgressColor, setProgressColor, setProgressColor, setProgressIndicator, setValueCommand

Methods inherited from class heronarts.glx.ui.component.UIParameterComponent

getContextActions, getOscAddress, setEnableContextActions, setModulationRangeCommand, setNormalizedCommand, setUseCommandEngine

Methods inherited from class heronarts.glx.ui.UI2dComponent

addAfterSibling, addBeforeSibling, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, assertValidContainer, clipTextToWidth, clipTextToWidth, contains, dbch, drawBackground, drawBorder, drawComponentBackground, drawFocus, drawFocusCorners, drawFocusCorners, drawParentBackground, getAbsoluteX, getAbsoluteY, getBackgroundColor, getBorderColor, getBorderWeight, getBottomMargin, getContainer, getDebugClassHierarchy, getDebugClassHierarchy, getFocusSize, getFont, getFontColor, getHeight, getLeftMargin, getMappableParameter, getNextSibling, getNextSibling, getParent, getPrevSibling, getPrevSibling, getRightMargin, getTopMargin, getWidth, getX, getY, hasBackground, hasBorder, hasFont, hasFontColor, isMappable, onResize, redraw, removeFromContainer, removeFromContainer, setBackground, setBackgroundColor, setBackgroundColor, setBorder, setBorderColor, setBorderColor, setBorderRounding, setBorderRounding, setBorderWeight, setBottomMargin, setContainerIndex, setContainerPosition, setDebug, setDebug, setDescription, setFocusBackground, setFocusBackgroundColor, setFocusBackgroundColor, setFocusColor, setFocusColor, setFocusCorners, setFont, setFontColor, setFontColor, setFontColor, setHeight, setLeftMargin, setMappable, setMargin, setMargin, setMargin, setPosition, setPosition, setPosition, setPosition, setRightMargin, setSize, setTextAlignment, setTextAlignment, setTextOffset, setTopMargin, setVisible, setWidth, setX, setY, vgRoundedRect, vgRoundedRect, vgRoundedRect

Methods inherited from class heronarts.glx.ui.UIObject

addListener, addListener, addLoopTask, addLoopTask, blur, bringToFront, focus, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, isVisible, loop, onFocus, onUIResize, removeLoopTask, requireUIThread, setConsumeMousePress, setDebugId, setMouseCursor, toggleVisible, toString

Methods inherited from class heronarts.glx.ui.UIEventHandler

onGamepadAxisChanged, onGamepadButtonPressed, onGamepadButtonReleased, onMouseMoved, onMouseOut, onMouseOver, onMouseScroll

Methods inherited from class java.lang.Object

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

Field Details

LABEL_MARGIN

protected static final int LABEL_MARGIN

See Also:

• Constant Field Values

LABEL_HEIGHT

protected static final int LABEL_HEIGHT

See Also:

• Constant Field Values

TEXT_MARGIN

public static final int TEXT_MARGIN

See Also:

• Constant Field Values

parameter

protected LXNormalizedParameter parameter

polarity

protected LXParameter.Polarity polarity

enabled

protected boolean enabled

keyEditable

protected boolean keyEditable

Constructor Details

UIParameterControl

protected UIParameterControl(float x,
 float y,
 float w,
 float h)

Method Details

setEnabled

public UIParameterControl setEnabled(boolean enabled)

Overrides:

setEnabled in class UIInputBox

getDescription

public static String getDescription(LXParameter parameter)

getDescription

public String getDescription()

Description copied from class: UIObject

Objects are encouraged to override this method providing a helpful String displayed to the user explaining the function of this UI component. If no help is available, return null rather than an empty String.

Overrides:

getDescription in class UIObject

Returns:

Helpful contextual string explaining function of this element

isEnabled

public boolean isEnabled()

Overrides:

isEnabled in class UIInputBox

setEditable

public UIInputBox setEditable(boolean editable)

Overrides:

setEditable in class UIInputBox

setShowLabel

public UIParameterControl setShowLabel(boolean showLabel)

isShowLabel

public boolean isShowLabel()

setLabel

public UIParameterControl setLabel(String label)

getFocusColor

protected UIColor getFocusColor(UI ui)

Overrides:

getFocusColor in class UI2dComponent

onParameterChanged

public void onParameterChanged(LXParameter parameter)

Description copied from interface: LXParameterListener

Invoked when the value of a parameter is changed.

Specified by:

onParameterChanged in interface LXParameterListener

Parameters:

parameter - The parameter that has changed its value

getBaseNormalized

protected double getBaseNormalized()

setNormalized

protected UIParameterControl setNormalized(double normalized)

getParameter

public LXNormalizedParameter getParameter()

Specified by:

getParameter in class UIParameterComponent

setPolarity

public UIParameterControl setPolarity(LXParameter.Polarity polarity)

setParameter

public UIParameterControl setParameter(LXNormalizedParameter parameter)

getValueString

protected String getValueString()

Specified by:

getValueString in class UIInputBox

isWrappable

protected boolean isWrappable()

isValidCharacter

protected boolean isValidCharacter(char keyChar)

Specified by:

isValidCharacter in class UIInputBox

saveEditBuffer

protected void saveEditBuffer(String editBuffer)

Specified by:

saveEditBuffer in class UIInputBox

onDraw

protected void onDraw(UI ui,
 VGraphics vg)

Description copied from class: UI2dComponent

Subclasses should override this method to perform their drawing functions.

Overrides:

onDraw in class UIInputBox

Parameters:

ui - UI context

vg - Graphics context

drawParameterLabel

public static void drawParameterLabel(UI ui,
 VGraphics vg,
 UI2dComponent component,
 String labelText)

isTriggerParameter

protected boolean isTriggerParameter()

decrementValue

protected void decrementValue(KeyEvent keyEvent)

Subclasses may optionally override to decrement value in response to arrows. Decrement is invoked for the left or down arrow keys.

Overrides:

decrementValue in class UIInputBox

Parameters:

keyEvent - Key event in response to

incrementValue

protected void incrementValue(KeyEvent keyEvent)

Subclasses may optionally override to decrement value in response to arrows. Increment is invoked for the right or up keys.

Overrides:

incrementValue in class UIInputBox

Parameters:

keyEvent - Key event in response to

onKeyPressed

protected void onKeyPressed(KeyEvent keyEvent,
 char keyChar,
 int keyCode)

Description copied from class: UIEventHandler

Subclasses override to receive key events

Overrides:

onKeyPressed in class UIInputBox

Parameters:

keyEvent - Key event

keyChar - Key character

keyCode - Key code value

onKeyReleased

protected void onKeyReleased(KeyEvent keyEvent,
 char keyChar,
 int keyCode)

Description copied from class: UIEventHandler

Subclasses override to receive key events

Overrides:

onKeyReleased in class UIEventHandler

Parameters:

keyEvent - Key event

keyChar - Key character

keyCode - Key code value

onMousePressed

protected void onMousePressed(MouseEvent mouseEvent,
 float mx,
 float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMousePressed in class UIInputBox

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onMouseReleased

protected void onMouseReleased(MouseEvent mouseEvent,
 float mx,
 float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMouseReleased in class UIInputBox

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onBlur

protected void onBlur()

Description copied from class: UIObject

Subclasses override when element loses focus

Overrides:

onBlur in class UIInputBox

getControlTarget

public LXNormalizedParameter getControlTarget()

Specified by:

getControlTarget in interface UIControlTarget

getModulationSource

public LXNormalizedParameter getModulationSource()

Specified by:

getModulationSource in interface UIModulationSource

getModulationTarget

public LXCompoundModulation.Target getModulationTarget()

Specified by:

getModulationTarget in interface UIModulationTarget

getModulatedValueColor

public static int getModulatedValueColor(int baseColor)

Given a base color for a control, return the color used to display the modulated component of its value. Currently, just dims the base color.

Parameters:

baseColor - Base color to determine modulated color from

Returns:

Color to use for modulated value

onCopy

public LXClipboardItem onCopy()

Specified by:

onCopy in interface UICopy

onPaste

public void onPaste(LXClipboardItem item)

Specified by:

onPaste in interface UIPaste

dispose

public void dispose()

Overrides:

dispose in class UIObject