com.simsilica.lemur

Class Panel

java.lang.Object

com.jme3.scene.Spatial

com.jme3.scene.Node

com.simsilica.lemur.Panel

All Implemented Interfaces:

com.jme3.asset.CloneableSmartAsset, com.jme3.collision.Collidable, com.jme3.export.Savable, com.jme3.util.clone.JmeCloneable, java.lang.Cloneable

Direct Known Subclasses:

Container, Label, ProgressBar, RollupPanel, Slider, TabbedPanel, TextField

public class Panel
extends com.jme3.scene.Node

A panel is the most basic GUI element consisting only of a background and insets. This is a convenient base class for every other GUI element as it sets up the proper relationships between Node, a GuiControl, and style attributes.

"Panels" are often thought about in 2D terms but the Lemur default Panel is not limited to 2D. It's behavior depends entirely on the background component, which could be a simple 2D quad using a QuadComponent or something more complicated that is fully 3D.

By default, Lemur GUI elements are setup so that their local translation determines the position of their top-left corner in x/y space. In other words, the y-axis acts a little differently than other axes in that it grows down instead of up. Within an element, the coordinate system is still the standard JME coordinate system. It's just how the elements are are arranged relative to their own local translation that is different. This makes multi-element layouts more sensible or consistent with other GUI libraries.

Note: the layout code currently assumes that rotation and scale are their default values.

Nested Class Summary

Nested classes/interfaces inherited from class com.jme3.scene.Spatial

com.jme3.scene.Spatial.BatchHint, com.jme3.scene.Spatial.CullHint

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EFFECT_CLOSE
static java.lang.String	EFFECT_OPEN
static java.lang.String	ELEMENT_ID
static java.lang.String	LAYER_BACKGROUND
static java.lang.String	LAYER_BORDER
static java.lang.String	LAYER_INSETS

Fields inherited from class com.jme3.scene.Node

children

Fields inherited from class com.jme3.scene.Spatial

batchHint, controls, cullHint, frustrumIntersects, key, localLights, localOverrides, localTransform, name, parent, queueBucket, queueDistance, refreshFlags, RF_BOUND, RF_CHILD_LIGHTLIST, RF_LIGHTLIST, RF_MATPARAM_OVERRIDE, RF_TRANSFORM, shadowMode, userData, worldBound, worldLights, worldOverrides, worldTransform

Constructor Summary

Constructors

Modifier	Constructor and Description
	Panel()
protected	Panel(boolean applyStyles, ElementId elementId, java.lang.String style) This is the constructure that subclasses should call as it allows them to bypass the default style application and apply styles themselves.
protected	Panel(boolean applyStyles, float width, float height, ElementId elementId, java.lang.String style)
	Panel(ElementId elementId, java.lang.String style)
	Panel(float width, float height)
	Panel(float width, float height, com.jme3.math.ColorRGBA backgroundColor)
	Panel(float width, float height, com.jme3.math.ColorRGBA backgroundColor, java.lang.String style)
	Panel(float width, float height, ElementId elementId, java.lang.String style)
	Panel(float width, float height, java.lang.String style)
	Panel(java.lang.String style)

Method Summary

Modifier and Type	Method and Description
void	addEffect(java.lang.String effectName, Effect<? super Panel> effect) Adds the specified effect to this GUI element.
void	addMouseListener(MouseListener l)
float	getAlpha() Returns an estimate of the current alpha multiplier for the child components.
GuiComponent	getBackground()
GuiComponent	getBorder()
protected EffectControl<Panel>	getEffectControl() Provides convenient access to the EffectControl...
java.util.Map<java.lang.String,Effect<? super Panel>>	getEffects() Returns a read-only view of the entire map of effects for this GUI element.
ElementId	getElementId()
Insets3f	getInsets()
InsetsComponent	getInsetsComponent()
com.jme3.math.Vector3f	getPreferredSize()
com.jme3.math.Vector3f	getSize()
java.lang.String	getStyle()
boolean	hasEffect(java.lang.String effectName) Returns true if this GUI element has the specified effect configured.
static void	initializeDefaultStyles(Attributes attrs)
Effect<? super Panel>	removeEffect(java.lang.String effectName) Removes a previously registered effect if it exists.
void	removeMouseListener(MouseListener l)
boolean	runEffect(java.lang.String effectName) Runs the specified effect if configured for this GUI element.
void	setAlpha(float alpha) Sets the alpha multiplier for all ColoredComponents in this panels component stack, including things like QuadBackgroundComponent, TextComponent, etc..
void	setAlpha(float alpha, boolean recursive) Sets the alpha multiplier for all ColoredComponents in this panels component stack, including things like QuadBackgroundComponent, TextComponent, etc..
void	setBackground(GuiComponent bg)
void	setBorder(GuiComponent bg)
protected void	setChildAlpha(com.jme3.scene.Spatial child, float alpha)
void	setEffects(java.util.Map<java.lang.String,Effect<? super Panel>> map) Adds multiple effects at once through a stylable attribute.
void	setInsets(Insets3f i)
void	setInsetsComponent(InsetsComponent ic)
void	setPreferredSize(com.jme3.math.Vector3f size)
void	setSize(com.jme3.math.Vector3f size)
java.lang.String	toString()

Methods inherited from class com.jme3.scene.Node

attachChild, attachChildAt, breadthFirstTraversal, clone, cloneFields, collideWith, deepClone, depthFirstTraversal, descendantMatches, descendantMatches, descendantMatches, detachAllChildren, detachChild, detachChildAt, detachChildNamed, getChild, getChild, getChildIndex, getChildren, getQuantity, getTriangleCount, getVertexCount, hasChild, oldDeepClone, read, setLightListRefresh, setLodLevel, setMaterial, setMatParamOverrideRefresh, setModelBound, setParent, setTransformRefresh, swapChildren, updateGeometricState, updateLogicalState, updateModelBound, updateWorldBound, write

Methods inherited from class com.jme3.scene.Spatial

addControl, addLight, addMatParamOverride, breadthFirstTraversal, center, checkCulling, clearMatParamOverrides, clone, forceRefresh, getBatchHint, getControl, getControl, getCullHint, getKey, getLastFrustumIntersection, getLocalBatchHint, getLocalCullHint, getLocalLightList, getLocalMatParamOverrides, getLocalQueueBucket, getLocalRotation, getLocalScale, getLocalShadowMode, getLocalToWorldMatrix, getLocalTransform, getLocalTranslation, getName, getNumControls, getParent, getQueueBucket, getShadowMode, getUserData, getUserDataKeys, getWorldBound, getWorldLightList, getWorldMatParamOverrides, getWorldRotation, getWorldScale, getWorldTransform, getWorldTranslation, hasAncestor, jmeClone, localToWorld, lookAt, matches, move, move, oldClone, removeControl, removeControl, removeFromParent, removeLight, removeMatParamOverride, rotate, rotate, rotateUpTo, runControlRender, scale, scale, setBatchHint, setBoundRefresh, setCullHint, setKey, setLastFrustumIntersection, setLocalRotation, setLocalRotation, setLocalScale, setLocalScale, setLocalScale, setLocalTransform, setLocalTranslation, setLocalTranslation, setName, setQueueBucket, setRequiresUpdates, setShadowMode, setUserData, updateMatParamOverrides, updateWorldLightList, updateWorldTransforms, worldToLocal

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT_ID

public static final java.lang.String ELEMENT_ID

See Also:

Constant Field Values

LAYER_BACKGROUND

public static final java.lang.String LAYER_BACKGROUND

See Also:

Constant Field Values

LAYER_INSETS

public static final java.lang.String LAYER_INSETS

See Also:

Constant Field Values

LAYER_BORDER

public static final java.lang.String LAYER_BORDER

See Also:

Constant Field Values

EFFECT_OPEN

public static final java.lang.String EFFECT_OPEN

See Also:

Constant Field Values

EFFECT_CLOSE

public static final java.lang.String EFFECT_CLOSE

See Also:

Constant Field Values

Constructor Detail

Panel

public Panel()

Panel

public Panel(java.lang.String style)

Panel

public Panel(ElementId elementId,
             java.lang.String style)

Panel

public Panel(float width,
             float height)

Panel

public Panel(float width,
             float height,
             ElementId elementId,
             java.lang.String style)

Panel

public Panel(float width,
             float height,
             com.jme3.math.ColorRGBA backgroundColor)

Panel

public Panel(float width,
             float height,
             com.jme3.math.ColorRGBA backgroundColor,
             java.lang.String style)

Panel

public Panel(float width,
             float height,
             java.lang.String style)

Panel

protected Panel(boolean applyStyles,
                float width,
                float height,
                ElementId elementId,
                java.lang.String style)

Panel

protected Panel(boolean applyStyles,
                ElementId elementId,
                java.lang.String style)

This is the constructure that subclasses should call as it allows them to bypass the default style application and apply styles themselves. In many cases, the default style processing will be fine but occasionally the subclasses may need to do some processing before style application. For example, if constructor paramaters will setup some components that a style would also define then it can create needless churn during construction if the styles are applied first. (Note: in reality, currently existing values are not checked during style application even though the design is that they should be. A solution for primitive values is still needed for this to work. FIXME) Subclasses that also want to be extension-friendly should consider providing a similar protected constructor.

Method Detail

getElementId

public ElementId getElementId()

getStyle

public java.lang.String getStyle()

setSize

public void setSize(com.jme3.math.Vector3f size)

getSize

public com.jme3.math.Vector3f getSize()

setPreferredSize

@StyleAttribute(value="preferredSize",
                lookupDefault=false)
public void setPreferredSize(com.jme3.math.Vector3f size)

getPreferredSize

public com.jme3.math.Vector3f getPreferredSize()

addMouseListener

public void addMouseListener(MouseListener l)

removeMouseListener

public void removeMouseListener(MouseListener l)

initializeDefaultStyles

public static void initializeDefaultStyles(Attributes attrs)

setBackground

@StyleAttribute(value="background",
                lookupDefault=false)
public void setBackground(GuiComponent bg)

getBackground

public GuiComponent getBackground()

setBorder

@StyleAttribute(value="border",
                lookupDefault=false)
public void setBorder(GuiComponent bg)

getBorder

public GuiComponent getBorder()

setInsets

@StyleAttribute(value="insets",
                lookupDefault=false)
public void setInsets(Insets3f i)

getInsets

public Insets3f getInsets()

setInsetsComponent

@StyleAttribute(value="insetsComponent",
                lookupDefault=false)
public void setInsetsComponent(InsetsComponent ic)

getInsetsComponent

public InsetsComponent getInsetsComponent()

setAlpha

@StyleAttribute(value="alpha",
                lookupDefault=false)
public void setAlpha(float alpha)

Sets the alpha multiplier for all ColoredComponents in this panels component stack, including things like QuadBackgroundComponent, TextComponent, etc.. This can be used to generally fade a GUI element in or out as needed as long as its visuals are ColoredComponent compliant.

setAlpha

public void setAlpha(float alpha,
                     boolean recursive)

Sets the alpha multiplier for all ColoredComponents in this panels component stack, including things like QuadBackgroundComponent, TextComponent, etc.. This can be used to generally fade a GUI element in or out as needed as long as its visuals are ColoredComponent compliant. If recursive is true then all child Spatials will also be checked and have their alpha set, and their children, and so on.

setChildAlpha

protected void setChildAlpha(com.jme3.scene.Spatial child,
                             float alpha)

getAlpha

public float getAlpha()

Returns an estimate of the current alpha multiplier for the child components. It scans the component children and returns the first alpha value found.

getEffectControl

protected EffectControl<Panel> getEffectControl()

Provides convenient access to the EffectControl... that also hides the Java-generic voodoo necessary to get it without an unchecked warning.

runEffect

public boolean runEffect(java.lang.String effectName)

Runs the specified effect if configured for this GUI element. If the effect referenced is on a channel that already has a running effect then that effect will be canceled and the new effect will be fastforwarded proportionally. This is to help facilitate reciprocal effects like open/close or activate/deactivate the undo one another and therefore if the previous effect is still running there may be less to do. This logic only happens if the effect has specified a channel. Otherwise all effects are run independently.

Returns:

True if the effect existed and was run. False if no effect was found.

addEffect

public void addEffect(java.lang.String effectName,
                      Effect<? super Panel> effect)

Adds the specified effect to this GUI element. Later calls to runEffect() will then be able to execute this effect.

removeEffect

public Effect<? super Panel> removeEffect(java.lang.String effectName)

Removes a previously registered effect if it exists. Returns the removed effect if it existed.

hasEffect

public boolean hasEffect(java.lang.String effectName)

Returns true if this GUI element has the specified effect configured.

setEffects

@StyleAttribute(value="effects",
                lookupDefault=false)
public void setEffects(java.util.Map<java.lang.String,Effect<? super Panel>> map)

Adds multiple effects at once through a stylable attribute.

getEffects

public java.util.Map<java.lang.String,Effect<? super Panel>> getEffects()

Returns a read-only view of the entire map of effects for this GUI element.

toString

public java.lang.String toString()

Overrides:

toString in class com.jme3.scene.Spatial