org.jvnet.substance.api
Class SubstanceColorSchemeBundle

java.lang.Object
  extended by org.jvnet.substance.api.SubstanceColorSchemeBundle
All Implemented Interfaces:
java.lang.Cloneable

public class SubstanceColorSchemeBundle
extends java.lang.Object
implements java.lang.Cloneable

Color scheme bundle. Defines the visual appearance of a single decoration area of a skin.

Author:
Kirill Grouchnikov
See Also:
DecorationAreaType, ColorSchemeAssociationKind, SubstanceSkin

Field Summary
protected  SubstanceColorScheme activeColorScheme
          The active color scheme of this bundle.
protected  java.util.Map<ColorSchemeAssociationKind,java.util.Map<ComponentState,SubstanceColorScheme>> colorSchemeMap
          Maps from color scheme association kinds to the map of color schemes.
protected  SubstanceColorScheme defaultColorScheme
          The default color scheme of this bundle.
protected  SubstanceColorScheme disabledColorScheme
          The disabled color scheme of this bundle.
protected  SubstanceColorScheme disabledSelectedScheme
          If there is no explicitly registered color scheme for the disabled selected component states, this field will contain a synthesized color scheme for the disabled selected state.
protected  SubstanceColorScheme pressedScheme
          If there is no explicitly registered color scheme for pressed component states, this field will contain a synthesized color scheme for a pressed state.
protected  java.util.Map<ComponentState,java.lang.Float> stateAlphaMap
          Maps from component state to the alpha channel applied on color scheme.
protected  java.util.Map<ComponentState,java.lang.Float> stateHighlightSchemeAlphaMap
          Maps from component state to the alpha channel applied on highlight color scheme.
 
Constructor Summary
SubstanceColorSchemeBundle(SubstanceColorScheme activeColorScheme, SubstanceColorScheme defaultColorScheme, SubstanceColorScheme disabledColorScheme)
          Creates a new color scheme bundle.
 
Method Summary
protected  java.lang.Object clone()
           
 SubstanceColorScheme getActiveColorScheme()
          Returns the active color scheme of this bundle.
 float getAlpha(java.awt.Component comp, ComponentState componentState)
          Returns the alpha channel of the color scheme of the component.
 SubstanceColorScheme getBorderColorScheme(java.awt.Component comp, ComponentState componentState)
          Deprecated. Use #getColorScheme(Component, ColorSchemeAssociationKind, ComponentState) with ColorSchemeAssociationKind.BORDER instead. This method will be removed in version 6.0.
 SubstanceColorScheme getColorScheme(ColorSchemeAssociationKind associationKind, ComponentState componentState)
          Returns the color scheme to be used for painting the specified visual area of the component under the specified component state.
 SubstanceColorScheme getColorScheme(ComponentState componentState)
          Returns the color scheme of the specified component in the specified component state.
 SubstanceColorScheme getDefaultColorScheme()
          Returns the default color scheme of this bundle.
 SubstanceColorScheme getDisabledColorScheme()
          Returns the disabled color scheme of this bundle.
 float getHighlightAlpha(java.awt.Component comp, ComponentState componentState)
          Returns the alpha channel of the highlight color scheme of the component.
 SubstanceColorScheme getHighlightColorScheme(java.awt.Component comp, ComponentState componentState)
          Deprecated. Use #getColorScheme(Component, ColorSchemeAssociationKind, ComponentState) with ColorSchemeAssociationKind.HIGHLIGHT instead. This method will be removed in version 6.0.
 void registerBorderColorScheme(SubstanceColorScheme scheme, ComponentState... states)
          Deprecated. Use registerColorScheme(SubstanceColorScheme, ColorSchemeAssociationKind, ComponentState...) with ColorSchemeAssociationKind.BORDER instead. This method will be removed in version 6.0.
 void registerColorScheme(SubstanceColorScheme scheme, ColorSchemeAssociationKind associationKind, ComponentState... states)
          Registers the color scheme to be used for the specified visual area of controls under the specified states.
 void registerColorScheme(SubstanceColorScheme stateColorScheme, ComponentState... states)
          Registers a color scheme for the specific component state.
 void registerColorScheme(SubstanceColorScheme stateColorScheme, float alpha, ComponentState... states)
          Registers a color scheme for the specific component state.
 void registerHighlightColorScheme(SubstanceColorScheme stateHighlightScheme, ComponentState... states)
          Registers a highlight color scheme for the specific component state if the component state is not null, or a global highlight color scheme otherwise.
 void registerHighlightColorScheme(SubstanceColorScheme highlightScheme, float alpha, ComponentState... states)
          Registers a highlight color scheme for the specific component state if the component state is not null, or a global highlight color scheme otherwise.
 SubstanceColorSchemeBundle transform(ColorSchemeTransform transform)
          Creates a new color scheme bundle that has the same settings as this color scheme bundle with the addition of applying the specified color scheme transformation on all the relevant color schemes
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

activeColorScheme

protected SubstanceColorScheme activeColorScheme
The active color scheme of this bundle.


defaultColorScheme

protected SubstanceColorScheme defaultColorScheme
The default color scheme of this bundle.


disabledColorScheme

protected SubstanceColorScheme disabledColorScheme
The disabled color scheme of this bundle.


stateAlphaMap

protected java.util.Map<ComponentState,java.lang.Float> stateAlphaMap
Maps from component state to the alpha channel applied on color scheme. This map doesn't have to contain entries for all ComponentState instances.


stateHighlightSchemeAlphaMap

protected java.util.Map<ComponentState,java.lang.Float> stateHighlightSchemeAlphaMap
Maps from component state to the alpha channel applied on highlight color scheme. This map doesn't have to contain entries for all ComponentState instances.


pressedScheme

protected SubstanceColorScheme pressedScheme
If there is no explicitly registered color scheme for pressed component states, this field will contain a synthesized color scheme for a pressed state.


disabledSelectedScheme

protected SubstanceColorScheme disabledSelectedScheme
If there is no explicitly registered color scheme for the disabled selected component states, this field will contain a synthesized color scheme for the disabled selected state.


colorSchemeMap

protected java.util.Map<ColorSchemeAssociationKind,java.util.Map<ComponentState,SubstanceColorScheme>> colorSchemeMap
Maps from color scheme association kinds to the map of color schemes. Different visual parts of controls in the specific decoration are can be painted with different color schemes. For example, a rollover button can use a light orange scheme for the gradient fill and a dark gray scheme for the border. In this case, this map will have:

Constructor Detail

SubstanceColorSchemeBundle

public SubstanceColorSchemeBundle(SubstanceColorScheme activeColorScheme,
                                  SubstanceColorScheme defaultColorScheme,
                                  SubstanceColorScheme disabledColorScheme)
Creates a new color scheme bundle.

Parameters:
activeColorScheme - The active color scheme of this bundle.
defaultColorScheme - The default color scheme of this bundle.
disabledColorScheme - The disabled color scheme of this bundle.
Method Detail

registerColorScheme

public void registerColorScheme(SubstanceColorScheme stateColorScheme,
                                float alpha,
                                ComponentState... states)
Registers a color scheme for the specific component state.

Parameters:
stateColorScheme - Color scheme for the specified component state.
alpha - Alpha channel for the color scheme.
states - Component states.

registerColorScheme

public void registerColorScheme(SubstanceColorScheme stateColorScheme,
                                ComponentState... states)
Registers a color scheme for the specific component state.

Parameters:
stateColorScheme - Color scheme for the specified component state.
states - Component states.

registerHighlightColorScheme

public void registerHighlightColorScheme(SubstanceColorScheme stateHighlightScheme,
                                         ComponentState... states)
Registers a highlight color scheme for the specific component state if the component state is not null, or a global highlight color scheme otherwise.

Parameters:
stateHighlightScheme - Highlight color scheme for the specified component state.
states - Component states. If null, the specified color scheme will be applied for all states left unspecified.

registerHighlightColorScheme

public void registerHighlightColorScheme(SubstanceColorScheme highlightScheme,
                                         float alpha,
                                         ComponentState... states)
Registers a highlight color scheme for the specific component state if the component state is not null, or a global highlight color scheme otherwise.

Parameters:
highlightScheme - Highlight color scheme for the specified component states.
alpha - Alpha channel for the highlight color scheme.
states - Component states. If null, the specified color scheme will be applied for all states left unspecified.

getColorScheme

public SubstanceColorScheme getColorScheme(ComponentState componentState)
Returns the color scheme of the specified component in the specified component state.

Parameters:
comp - Component.
componentState - Component state.
Returns:
The color scheme of the component in the specified component state.

getHighlightColorScheme

@Deprecated
public SubstanceColorScheme getHighlightColorScheme(java.awt.Component comp,
                                                               ComponentState componentState)
Deprecated. Use #getColorScheme(Component, ColorSchemeAssociationKind, ComponentState) with ColorSchemeAssociationKind.HIGHLIGHT instead. This method will be removed in version 6.0.

Returns the highlight color scheme of the component.

Parameters:
comp - Component.
componentState - Component state.
Returns:
Component highlight color scheme.

getHighlightAlpha

public float getHighlightAlpha(java.awt.Component comp,
                               ComponentState componentState)
Returns the alpha channel of the highlight color scheme of the component.

Parameters:
comp - Component.
componentState - Component state.
Returns:
Highlight color scheme alpha channel.

getAlpha

public float getAlpha(java.awt.Component comp,
                      ComponentState componentState)
Returns the alpha channel of the color scheme of the component.

Parameters:
comp - Component.
componentState - Component state.
Returns:
Color scheme alpha channel.

getActiveColorScheme

public SubstanceColorScheme getActiveColorScheme()
Returns the active color scheme of this bundle.

Returns:
The active color scheme of this bundle.

getDefaultColorScheme

public SubstanceColorScheme getDefaultColorScheme()
Returns the default color scheme of this bundle.

Returns:
The default color scheme of this bundle.

getDisabledColorScheme

public SubstanceColorScheme getDisabledColorScheme()
Returns the disabled color scheme of this bundle.

Returns:
The disabled color scheme of this bundle.

registerColorScheme

public void registerColorScheme(SubstanceColorScheme scheme,
                                ColorSchemeAssociationKind associationKind,
                                ComponentState... states)
Registers the color scheme to be used for the specified visual area of controls under the specified states. For example, if the light orange scheme has to be used for gradient fill of rollover selected and rollover controls, the parameters would be:

Parameters:
scheme - Color scheme.
associationKind - Color scheme association kind that specifies the visual areas of controls to be painted with this color scheme.
states - Component states that further restrict the usage of the specified color scheme.
Since:
version 5.1

getColorScheme

public SubstanceColorScheme getColorScheme(ColorSchemeAssociationKind associationKind,
                                           ComponentState componentState)
Returns the color scheme to be used for painting the specified visual area of the component under the specified component state.

Parameters:
comp - Component.
associationKind - Color scheme association kind.
componentState - Component state.
Returns:
Color scheme to be used for painting the specified visual area of the component under the specified component state.
Since:
version 5.1
See Also:
registerColorScheme(SubstanceColorScheme, ComponentState...)

registerBorderColorScheme

@Deprecated
public void registerBorderColorScheme(SubstanceColorScheme scheme,
                                                 ComponentState... states)
Deprecated. Use registerColorScheme(SubstanceColorScheme, ColorSchemeAssociationKind, ComponentState...) with ColorSchemeAssociationKind.BORDER instead. This method will be removed in version 6.0.

Registers a border color scheme for the specific component state if the component state is not null, or a global highlight color scheme otherwise.

Parameters:
scheme - Border color scheme for the specified component state.
states - Component states. If null, the specified color scheme will be applied for all states left unspecified.

getBorderColorScheme

@Deprecated
public SubstanceColorScheme getBorderColorScheme(java.awt.Component comp,
                                                            ComponentState componentState)
Deprecated. Use #getColorScheme(Component, ColorSchemeAssociationKind, ComponentState) with ColorSchemeAssociationKind.BORDER instead. This method will be removed in version 6.0.

Returns the border color scheme of the component.

Parameters:
comp - Component.
componentState - Component state.
Returns:
Component border color scheme.

clone

protected java.lang.Object clone()
                          throws java.lang.CloneNotSupportedException
Overrides:
clone in class java.lang.Object
Throws:
java.lang.CloneNotSupportedException

transform

public SubstanceColorSchemeBundle transform(ColorSchemeTransform transform)
Creates a new color scheme bundle that has the same settings as this color scheme bundle with the addition of applying the specified color scheme transformation on all the relevant color schemes

Parameters:
transform - Color scheme transformation.
Returns:
The new color scheme bundle.