ilog.views.util.java2d

Class IlvBlinkingMultiPaint

java.lang.Object

ilog.views.util.java2d.IlvBlinkingMultiPaint

All Implemented Interfaces:

IlvAdaptablePaint, IlvBlinkingDrawingResource, Paint, Transparency

public class IlvBlinkingMultiPaint
extends Object
implements Paint, IlvAdaptablePaint, IlvBlinkingDrawingResource

This class defines a blinking paint consisting of multiple subpaints. In each stage of the blinking, it displays one of the subpaints. It can be used in classes as paints, if the corresponding property is documented to support blinking paints. Several subclasses of IlvGraphic support blinking paints.

Limitation: For technical reasons, the period duration is limited from 1 to max integer (not max long). It is recommended to use the same durations whenever possible for all objects, and to choose the durations not too small (e.g. not smaller than 100 ms), because otherwise the performance of the system will degrade dramatically.

Since:

JViews 8.5

Field Summary

Fields inherited from interface ilog.views.util.java2d.IlvAdaptablePaint

KEY_USER_BOUNDS

Fields inherited from interface java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

Constructor Summary

Constructors

Constructor and Description
IlvBlinkingMultiPaint(long period, Paint... paint) Creates a new multi blinking paint.
IlvBlinkingMultiPaint(Paint... paint) Creates a new multi blinking paint.

Method Summary

Modifier and Type	Method and Description
PaintContext	createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints) Creates and returns a PaintContext.
boolean	equals(Object obj) Determines whether another object is equal to this IlvBlinkingPaint.
Paint	getCurrentPaint() Returns current paint.
long	getOffPeriod() Returns the duration, in milliseconds, of the "off" period.
long	getOnPeriod() Returns the duration, in milliseconds, of the "on" period.
Paint[]	getPaints() Returns the paints used in the different phases.
long	getPeriod() Returns the duration, in milliseconds, of the "on" and "off" period.
int	getTransparency() Returns the transparency mode for this Paint.
int	hashCode() Returns the hash code of this object.
boolean	isAdapting() Returns true if the createContext method of this object may rely on its userBounds argument.
boolean	isOn() Returns true if this paint displays like the "on" state, and false if this paint displays like the "off" state.
void	notifyUsed(IlvBlinkingObject obj, boolean used) Called by IlvGraphic if this paint is used.
void	setOn(boolean flag) Sets whether this paint displays like the "on" or "off" state.
void	setTemporarilyDisabled(boolean flag) Temporarily disable the blinking.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IlvBlinkingMultiPaint

public IlvBlinkingMultiPaint(Paint... paint)

Creates a new multi blinking paint.

Parameters:

paint - A number of paints (at least 2) used during the periods.

IlvBlinkingMultiPaint

public IlvBlinkingMultiPaint(long period,
                             Paint... paint)

Creates a new multi blinking paint.

Parameters:

period - Duration, in milliseconds, of each period

paint - A number of paints (at least 2) used during the periods.

Method Detail

equals

public boolean equals(Object obj)

Determines whether another object is equal to this IlvBlinkingPaint.

Overrides:

equals in class Object

hashCode

public int hashCode()

Returns the hash code of this object.

Overrides:

hashCode in class Object

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle r,
                                  Rectangle2D r2d,
                                  AffineTransform xform,
                                  RenderingHints hints)

Creates and returns a PaintContext. If the current state is on, it returns a context representing the "on paint", otherwise the "off paint".

Specified by:

createContext in interface Paint

Parameters:

cm - the specified ColorModel

r - the specified Rectangle

r2d - the specified Rectangle2D

xform - the specified AffineTransform

hints - the specified RenderingHints

Returns:

a PaintContext that is used to generate a solid color pattern.

See Also:

Paint.createContext(java.awt.image.ColorModel, java.awt.Rectangle, java.awt.geom.Rectangle2D, java.awt.geom.AffineTransform, java.awt.RenderingHints), Paint, PaintContext

getTransparency

public int getTransparency()

Returns the transparency mode for this Paint. If the current state is on, it returns a transparency of the "on paint", otherwise of the "off paint".

Specified by:

getTransparency in interface Transparency

Returns:

This Paint object's transparency mode.

See Also:

Paint, Transparency

isAdapting

public boolean isAdapting()

Returns true if the createContext method of this object may rely on its userBounds argument.

Specified by:

isAdapting in interface IlvAdaptablePaint

Since:

JViews 8.8

getCurrentPaint

public Paint getCurrentPaint()

Returns current paint.

Returns:

current paint

getPaints

public Paint[] getPaints()

Returns the paints used in the different phases.

Returns:

The paints

getPeriod

public long getPeriod()

Returns the duration, in milliseconds, of the "on" and "off" period.

Returns:

The blinking duration

getOnPeriod

public long getOnPeriod()

Returns the duration, in milliseconds, of the "on" period. This returns the same value like getPeriod().

Specified by:

getOnPeriod in interface IlvBlinkingDrawingResource

Returns:

The "on" duration

getOffPeriod

public long getOffPeriod()

Returns the duration, in milliseconds, of the "off" period. This returns the same value like getPeriod().

Specified by:

getOffPeriod in interface IlvBlinkingDrawingResource

Returns:

The "off" duration

setOn

public void setOn(boolean flag)

Sets whether this paint displays like the "on" or "off" state.

Specified by:

setOn in interface IlvBlinkingDrawingResource

Parameters:

flag - true means it displays like the "on" state

isOn

public boolean isOn()

Returns true if this paint displays like the "on" state, and false if this paint displays like the "off" state.

Specified by:

isOn in interface IlvBlinkingDrawingResource

Returns:

Whether it is on or off.

setTemporarilyDisabled

public void setTemporarilyDisabled(boolean flag)

Temporarily disable the blinking. When the blinking is temporarily disabled, the state displays the first paint. When the blinking gets reenabled later, it restores the old state.

Specified by:

setTemporarilyDisabled in interface IlvBlinkingDrawingResource

Parameters:

flag - true if temporarily disabled.

notifyUsed

public void notifyUsed(IlvBlinkingObject obj,
                       boolean used)

Called by IlvGraphic if this paint is used. You should not call this method.

Specified by:

notifyUsed in interface IlvBlinkingDrawingResource

Parameters:

obj - The blinking object.

used - Whether the paint is used.