prefuse.visual
Interface VisualItem

All Superinterfaces:
Tuple
All Known Subinterfaces:
AggregateItem, DecoratorItem, EdgeItem, NodeItem
All Known Implementing Classes:
TableAggregateItem, TableDecoratorItem, TableEdgeItem, TableNodeItem, TableVisualItem

public interface VisualItem
extends Tuple

Base interface for representing a visual item, a data object with a visual interactive form. VisualItems are Tuple instances, and so can support any number of data fields in a backing data table. VisualItems also support data fields specific to visualization, such as a location, bounding box, colors, size, and font. The VisualItem interface provides convenience methods for accessing these common visual properties, but the underlying mechanism is the same as any Tuple -- data stored in a tabular format. Just as all Tuple instances are backed by a data Table, each VisualItem is backed by a VisualTable. Additionally, each VisualItem is associated with one and only one Visualization.

VisualItems are only responsible for storing their visual data properties. The final visual appearance of an item is determined by a Renderer, which contains instructions for drawing the item. The Renderer to use for a given item is decided by the RendererFactory associated with the item's backing Visualization.

Finally, actually setting the visual properties of VisualItems is commonly done by the many Action modules available for processing visual data. This includes spatial layout as well as color, size, and font assignment.

Author:
jeffrey heer

Field Summary
static java.lang.String BOUNDS
          The bounds data field
static java.lang.String DOI
          The doi data field
static java.lang.String ENDFILLCOLOR
          The end fill color data field
static java.lang.String ENDFONT
          The end font data field
static java.lang.String ENDPOLYGON
          The end polygon data field.
static java.lang.String ENDSIZE
          The end size data field
static java.lang.String ENDSTROKECOLOR
          The end stroke color data field
static java.lang.String ENDTEXTCOLOR
          The end text color data field
static java.lang.String ENDVISIBLE
          The end visible data field
static java.lang.String ENDX
          The end x data field
static java.lang.String ENDX2
          The end x2 data field.
static java.lang.String ENDY
          The end y data field
static java.lang.String ENDY2
          The end y2 data field.
static java.lang.String EXPANDED
          The expanded data field
static java.lang.String FILLCOLOR
          The fill color data field
static java.lang.String FIXED
          The fixed data field
static java.lang.String FONT
          The font data field
static java.lang.String HIGHLIGHT
          The highlight data field
static java.lang.String HOVER
          The hover data field
static int IDX_VALIDATED
          The column index of the validated data field.
static java.lang.String INTERACTIVE
          The interactive data field
static java.lang.String LABEL
          The label data field.
static java.lang.String POLYGON
          The polygon data field.
static Schema SCHEMA
          A permanent, locked copy of the base VisualItem schema
static java.lang.String SHAPE
          The shape data field
static java.lang.String SIZE
          The size data field
static java.lang.String STARTFILLCOLOR
          The start fill color data field
static java.lang.String STARTFONT
          The start font data field
static java.lang.String STARTPOLYGON
          The start polygon data field.
static java.lang.String STARTSIZE
          The start size data field
static java.lang.String STARTSTROKECOLOR
          The start stroke color data field
static java.lang.String STARTTEXTCOLOR
          The start text color data field
static java.lang.String STARTVISIBLE
          The start visible data field
static java.lang.String STARTX
          The start x data field
static java.lang.String STARTX2
          The start x2 data field.
static java.lang.String STARTY
          The start y data field
static java.lang.String STARTY2
          The start y2 data field.
static java.lang.String STROKE
          The stroke data field
static java.lang.String STROKECOLOR
          The stroke color data field
static java.lang.String TEXTCOLOR
          The text color data field
static java.lang.String VALIDATED
          The validated data field
static java.lang.String VALUE
          The value data field.
static java.lang.String VISIBLE
          The visible data field
static java.lang.String X
          The x data field
static java.lang.String X2
          The x2 data field.
static java.lang.String Y
          The y data field
static java.lang.String Y2
          The y2 data field.
 
Method Summary
 java.awt.geom.Rectangle2D getBounds()
          Get the bounding box for this VisualItem.
 double getDOI()
          Get the degree-of-interest (DOI) value.
 int getEndFillColor()
          Get the ending fill color of this item.
 java.awt.Font getEndFont()
          Get the ending font for the item.
 double getEndSize()
          Get the ending size value of the item.
 int getEndStrokeColor()
          Get the ending stroke color of this item.
 int getEndTextColor()
          Get the ending text color of this item.
 double getEndX()
          Get the ending x-coordinate of this item.
 double getEndY()
          Get the ending y-coordinate of this item.
 int getFillColor()
          Get the current fill color of this item.
 java.awt.Font getFont()
          Get the current font for the item.
 java.lang.String getGroup()
          Get the primary data group of which this VisualItem is a member.
 Renderer getRenderer()
          Get the Renderer instance for drawing this VisualItem.
 int getShape()
          Get the current shape value of the item.
 double getSize()
          Get the current size value of the item.
 TupleSet getSourceData()
          Returns the original backing data set from which this VisualItem is derived.
 Tuple getSourceTuple()
          Returns the original backing data tuple from which this VisualItem is derived.
 int getStartFillColor()
          Get the starting fill color of this item.
 java.awt.Font getStartFont()
          Get the starting font for the item.
 double getStartSize()
          Get the starting size value of the item.
 int getStartStrokeColor()
          Get the starting stroke color of this item.
 int getStartTextColor()
          Get the starting text color of this item.
 double getStartX()
          Get the starting x-coordinate of this item.
 double getStartY()
          Get the starting y-coordinate of this item.
 java.awt.BasicStroke getStroke()
          Get the current stroke used to draw lines and shape outlines.
 int getStrokeColor()
          Get the current stroke color of this item.
 int getTextColor()
          Get the current text color of this item.
 Visualization getVisualization()
          Get the backing Visualization of which this VisualItem is a part.
 double getX()
          Get the current x-coordinate of this item.
 double getY()
          Get the current y-coordinate of this item.
 boolean isEndVisible()
          Indictes if the end visible flag is set to true.
 boolean isExpanded()
          Indicates this item is expanded.
 boolean isFixed()
          Indicates if the item is fixed, and so will not have its position changed by any layout or distortion actions.
 boolean isHighlighted()
          Indicates if the item is highlighted.
 boolean isHover()
          Indicates if the item currently has the mouse pointer over it.
 boolean isInGroup(java.lang.String group)
          Indicates if this item is a member of a given group.
 boolean isInteractive()
          Indicates if this item is interactive, meaning it can potentially respond to mouse and keyboard input events.
 boolean isStartVisible()
          Indicates if the start visible flag is set to true.
 boolean isValidated()
          Indicates if this VisualItem is currently validated.
 boolean isVisible()
          Indicates if this VisualItem is currently set to be visible.
 void render(java.awt.Graphics2D g)
          Render this item to the given graphics context.
 void setBounds(double x, double y, double w, double h)
          Set the bounding box for this item.
 void setDOI(double doi)
          Set the degree-of-interest (DOI) value.
 void setEndFillColor(int color)
          Set the ending fill color of this item.
 void setEndFont(java.awt.Font font)
          Set the ending font for the item.
 void setEndSize(double size)
          Set the ending size value of the item.
 void setEndStrokeColor(int color)
          Set the ending stroke color of this item.
 void setEndTextColor(int color)
          Set the ending text color of this item.
 void setEndVisible(boolean value)
          Set the end visible flag.
 void setEndX(double x)
          Set the ending x-coordinate of this item.
 void setEndY(double y)
          Set the ending y-coordinate of this item.
 void setExpanded(boolean value)
          Set the expanded flag.
 void setFillColor(int color)
          Set the current fill color of this item.
 void setFixed(boolean value)
          Sets if the item is fixed in its position.
 void setFont(java.awt.Font font)
          Set the current font for the item.
 void setHighlighted(boolean value)
          Set the highlighted status of this item.
 void setHover(boolean value)
          Set the hover flag.
 void setInteractive(boolean value)
          Set the interactive status of this VisualItem.
 void setShape(int shape)
          Set the current shape value of the item.
 void setSize(double size)
          Set the current size value of the item.
 void setStartFillColor(int color)
          Set the starting fill color of this item.
 void setStartFont(java.awt.Font font)
          Set the starting font for the item.
 void setStartSize(double size)
          Set the starting size value of the item.
 void setStartStrokeColor(int color)
          Set the starting stroke color of this item.
 void setStartTextColor(int color)
          Set the starting text color of this item.
 void setStartVisible(boolean value)
          Set the start visible flag.
 void setStartX(double x)
          Set the starting x-coordinate of this item.
 void setStartY(double y)
          Set the starting y-coordinate of this item.
 void setStroke(java.awt.BasicStroke stroke)
          Set the current stroke used to draw lines and shape outlines.
 void setStrokeColor(int color)
          Set the current stroke color of this item.
 void setTextColor(int color)
          Set the current text color of this item.
 void setValidated(boolean value)
          Set this item's validated flag.
 void setVisible(boolean value)
          Set this item's visibility.
 void setX(double x)
          Set the current x-coordinate of this item.
 void setY(double y)
          Set the current y-coordinate of this item.
 java.awt.geom.Rectangle2D validateBounds()
          Validate the bounds of this VisualItem.
 
Methods inherited from interface prefuse.data.Tuple
canGet, canGetBoolean, canGetDate, canGetDouble, canGetFloat, canGetInt, canGetLong, canGetString, canSet, canSetBoolean, canSetDate, canSetDouble, canSetFloat, canSetInt, canSetLong, canSetString, get, get, getBoolean, getBoolean, getColumnCount, getColumnIndex, getColumnName, getColumnType, getColumnType, getDate, getDate, getDefault, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getLong, getLong, getRow, getSchema, getString, getString, getTable, isValid, revertToDefault, set, set, setBoolean, setBoolean, setDate, setDate, setDouble, setDouble, setFloat, setFloat, setInt, setInt, setLong, setLong, setString, setString
 

Field Detail

VALIDATED

public static final java.lang.String VALIDATED
The validated data field


VISIBLE

public static final java.lang.String VISIBLE
The visible data field


STARTVISIBLE

public static final java.lang.String STARTVISIBLE
The start visible data field


ENDVISIBLE

public static final java.lang.String ENDVISIBLE
The end visible data field


INTERACTIVE

public static final java.lang.String INTERACTIVE
The interactive data field


EXPANDED

public static final java.lang.String EXPANDED
The expanded data field


FIXED

public static final java.lang.String FIXED
The fixed data field


HIGHLIGHT

public static final java.lang.String HIGHLIGHT
The highlight data field


HOVER

public static final java.lang.String HOVER
The hover data field


X

public static final java.lang.String X
The x data field


Y

public static final java.lang.String Y
The y data field


STARTX

public static final java.lang.String STARTX
The start x data field


STARTY

public static final java.lang.String STARTY
The start y data field


ENDX

public static final java.lang.String ENDX
The end x data field


ENDY

public static final java.lang.String ENDY
The end y data field


BOUNDS

public static final java.lang.String BOUNDS
The bounds data field


STROKECOLOR

public static final java.lang.String STROKECOLOR
The stroke color data field


STARTSTROKECOLOR

public static final java.lang.String STARTSTROKECOLOR
The start stroke color data field


ENDSTROKECOLOR

public static final java.lang.String ENDSTROKECOLOR
The end stroke color data field


FILLCOLOR

public static final java.lang.String FILLCOLOR
The fill color data field


STARTFILLCOLOR

public static final java.lang.String STARTFILLCOLOR
The start fill color data field


ENDFILLCOLOR

public static final java.lang.String ENDFILLCOLOR
The end fill color data field


TEXTCOLOR

public static final java.lang.String TEXTCOLOR
The text color data field


STARTTEXTCOLOR

public static final java.lang.String STARTTEXTCOLOR
The start text color data field


ENDTEXTCOLOR

public static final java.lang.String ENDTEXTCOLOR
The end text color data field


SIZE

public static final java.lang.String SIZE
The size data field


STARTSIZE

public static final java.lang.String STARTSIZE
The start size data field


ENDSIZE

public static final java.lang.String ENDSIZE
The end size data field


SHAPE

public static final java.lang.String SHAPE
The shape data field


STROKE

public static final java.lang.String STROKE
The stroke data field


FONT

public static final java.lang.String FONT
The font data field


STARTFONT

public static final java.lang.String STARTFONT
The start font data field


ENDFONT

public static final java.lang.String ENDFONT
The end font data field


DOI

public static final java.lang.String DOI
The doi data field


SCHEMA

public static final Schema SCHEMA
A permanent, locked copy of the base VisualItem schema


IDX_VALIDATED

public static final int IDX_VALIDATED
The column index of the validated data field. This should be safe to do because a unique (non-inherited) validated field is required of all VisualItems, and should always be the first field included.


LABEL

public static final java.lang.String LABEL
The label data field. Not included in the VisualItem schema by default


VALUE

public static final java.lang.String VALUE
The value data field. Not included in the VisualItem schema by default


POLYGON

public static final java.lang.String POLYGON
The polygon data field. Not included in the VisualItem schema by default


STARTPOLYGON

public static final java.lang.String STARTPOLYGON
The start polygon data field. Not included in the VisualItem schema by default


ENDPOLYGON

public static final java.lang.String ENDPOLYGON
The end polygon data field. Not included in the VisualItem schema by default


X2

public static final java.lang.String X2
The x2 data field. Not included in the VisualItem schema by default


Y2

public static final java.lang.String Y2
The y2 data field. Not included in the VisualItem schema by default


STARTX2

public static final java.lang.String STARTX2
The start x2 data field. Not included in the VisualItem schema by default


STARTY2

public static final java.lang.String STARTY2
The start y2 data field. Not included in the VisualItem schema by default


ENDX2

public static final java.lang.String ENDX2
The end x2 data field. Not included in the VisualItem schema by default


ENDY2

public static final java.lang.String ENDY2
The end y2 data field. Not included in the VisualItem schema by default

Method Detail

getVisualization

public Visualization getVisualization()
Get the backing Visualization of which this VisualItem is a part.

Returns:
the backing Visualization

getGroup

public java.lang.String getGroup()
Get the primary data group of which this VisualItem is a member. Returns the name of the group of this item's backing VisualTable.

Returns:
the item's primary group

isInGroup

public boolean isInGroup(java.lang.String group)
Indicates if this item is a member of a given group. This includes both the item's primary group (that of it's backing VisualTable) and any number of additional focus groups associated with the Visualization.

Parameters:
group - the group to check for membership.
Returns:
true if this item is in the group, false otherwise.

getSourceData

public TupleSet getSourceData()
Returns the original backing data set from which this VisualItem is derived. This could be a Table, Graph, or Tree instance. This method returns null if this VisualItem is not derived from backing data.

Returns:
the backing data set from which this VisualItem is derived, or null if none.

getSourceTuple

public Tuple getSourceTuple()
Returns the original backing data tuple from which this VisualItem is derived. This could be a Tuple, Node, or Edge instance. This method returns null if this VisualItem is not derived from backing data.

Returns:
the backing data tuple from which this VisualItem is derived, or null if none.

render

public void render(java.awt.Graphics2D g)
Render this item to the given graphics context. This is typically done by requesting the appropriate Renderer from the backing Visualization's RendererFactory, and then using the Renderer to draw this item.

Parameters:
g - the graphics context to render into.

getRenderer

public Renderer getRenderer()
Get the Renderer instance for drawing this VisualItem. The Renderer is retrieved by requesting it from the backing Visualization's RendererFactory.

Returns:
the Renderer for this VisualItem

validateBounds

public java.awt.geom.Rectangle2D validateBounds()
Validate the bounds of this VisualItem. When a data value for a VisualItem is updated, it's bounds are invalidated, as the data change may have changed to appearance of the item. Revalidating the bounds causes the bounds of the item to be recomputed and made current.

Returns:
the validated boundig box of this item

isValidated

public boolean isValidated()
Indicates if this VisualItem is currently validated. If not, validateBounds() must be run to update the bounds to a current value.

Returns:
true if validated, false otherwise
See Also:
VALIDATED

setValidated

public void setValidated(boolean value)
Set this item's validated flag. This is for internal use by prefuse and, in general, should not be called by application code.

Parameters:
value - the value of the validated flag to set.
See Also:
VALIDATED

isVisible

public boolean isVisible()
Indicates if this VisualItem is currently set to be visible. Items with the visible flag set false will not be drawn by a display. Invisible items are also by necessity not interactive, regardless of the value of the interactive flag.

Returns:
true if visible, false if invisible
See Also:
VISIBLE

setVisible

public void setVisible(boolean value)
Set this item's visibility.

Parameters:
value - true to make the item visible, false otherwise.
See Also:
VISIBLE

isStartVisible

public boolean isStartVisible()
Indicates if the start visible flag is set to true. This is the visibility value consulted for the staring value of the visibility field at the beginning of an animated transition.

Returns:
true if this item starts out visible, false otherwise.
See Also:
STARTVISIBLE

setStartVisible

public void setStartVisible(boolean value)
Set the start visible flag.

Parameters:
value - true to set the start visible flag, false otherwise
See Also:
STARTVISIBLE

isEndVisible

public boolean isEndVisible()
Indictes if the end visible flag is set to true. This is the visibility value consulted for the ending value of the visibility field at the end of an animated transition.

Returns:
true if this items ends visible, false otherwise.
See Also:
ENDVISIBLE

setEndVisible

public void setEndVisible(boolean value)
Set the end visible flag.

Parameters:
value - true to set the end visible flag, false otherwise
See Also:
ENDVISIBLE

isInteractive

public boolean isInteractive()
Indicates if this item is interactive, meaning it can potentially respond to mouse and keyboard input events.

Returns:
true if the item is interactive, false otherwise
See Also:
INTERACTIVE

setInteractive

public void setInteractive(boolean value)
Set the interactive status of this VisualItem.

Parameters:
value - true for interactive, false for non-interactive
See Also:
INTERACTIVE

isExpanded

public boolean isExpanded()
Indicates this item is expanded. Only used for items that are part of a graph structure.

Returns:
true if expanded, false otherwise
See Also:
EXPANDED

setExpanded

public void setExpanded(boolean value)
Set the expanded flag.

Parameters:
value - true to set as expanded, false as collapsed.
See Also:
EXPANDED

isFixed

public boolean isFixed()
Indicates if the item is fixed, and so will not have its position changed by any layout or distortion actions.

Returns:
true if the item has a fixed position, false otherwise
See Also:
FIXED

setFixed

public void setFixed(boolean value)
Sets if the item is fixed in its position.

Parameters:
value - true to fix the item, false otherwise
See Also:
FIXED

isHighlighted

public boolean isHighlighted()
Indicates if the item is highlighted.

Returns:
true for highlighted, false for not highlighted
See Also:
HIGHLIGHT

setHighlighted

public void setHighlighted(boolean value)
Set the highlighted status of this item. How higlighting values are interpreted by the system depends on the various processing actions set up for an application (e.g., how a ColorAction might assign colors based on the flag).

Parameters:
value - true to highlight the item, false for no highlighting.
See Also:
HIGHLIGHT

isHover

public boolean isHover()
Indicates if the item currently has the mouse pointer over it.

Returns:
true if the mouse pointer is over this item, false otherwise
See Also:
HOVER

setHover

public void setHover(boolean value)
Set the hover flag. This is set automatically by the prefuse framework, so should not need to be set explicitly by application code.

Parameters:
value - true to set the hover flag, false otherwise
See Also:
HOVER

getX

public double getX()
Get the current x-coordinate of this item.

Returns:
the current x-coordinate
See Also:
X

setX

public void setX(double x)
Set the current x-coordinate of this item.

Parameters:
x - the new current x-coordinate
See Also:
X

getY

public double getY()
Get the current y-coordinate of this item.

Returns:
the current y-coordinate
See Also:
Y

setY

public void setY(double y)
Set the current y-coordinate of this item.

Parameters:
y - the new current y-coordinate
See Also:
Y

getStartX

public double getStartX()
Get the starting x-coordinate of this item.

Returns:
the starting x-coordinate
See Also:
STARTX

setStartX

public void setStartX(double x)
Set the starting x-coordinate of this item.

Parameters:
x - the new starting x-coordinate
See Also:
STARTX

getStartY

public double getStartY()
Get the starting y-coordinate of this item.

Returns:
the starting y-coordinate
See Also:
STARTY

setStartY

public void setStartY(double y)
Set the starting y-coordinate of this item.

Parameters:
y - the new starting y-coordinate
See Also:
STARTY

getEndX

public double getEndX()
Get the ending x-coordinate of this item.

Returns:
the ending x-coordinate
See Also:
ENDX

setEndX

public void setEndX(double x)
Set the ending x-coordinate of this item.

Parameters:
x - the new ending x-coordinate
See Also:
ENDX

getEndY

public double getEndY()
Get the ending y-coordinate of this item.

Returns:
the ending y-coordinate
See Also:
ENDY

setEndY

public void setEndY(double y)
Set the ending y-coordinate of this item.

Parameters:
y - the new ending y-coordinate
See Also:
ENDY

getBounds

public java.awt.geom.Rectangle2D getBounds()
Get the bounding box for this VisualItem. If necessary, the bounds will be validated before returning the bounding box.

Returns:
the item's bounding box
See Also:
BOUNDS

setBounds

public void setBounds(double x,
                      double y,
                      double w,
                      double h)
Set the bounding box for this item. This method is used by Renderer modules when the bounds are validated, or set by processing Actions used in conjunction with Renderers that do not perform bounds management.

Parameters:
x - the minimum x-coordinate
y - the minimum y-coorindate
w - the width of this item
h - the height of this item
See Also:
BOUNDS

getStrokeColor

public int getStrokeColor()
Get the current stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Returns:
the current stroke color, represented as an integer
See Also:
ColorLib, STROKECOLOR

setStrokeColor

public void setStrokeColor(int color)
Set the current stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the current stroke color, represented as an integer
See Also:
ColorLib, STROKECOLOR

getStartStrokeColor

public int getStartStrokeColor()
Get the starting stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Returns:
the starting stroke color, represented as an integer
See Also:
ColorLib, STARTSTROKECOLOR

setStartStrokeColor

public void setStartStrokeColor(int color)
Set the starting stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the starting stroke color, represented as an integer
See Also:
ColorLib, STARTSTROKECOLOR

getEndStrokeColor

public int getEndStrokeColor()
Get the ending stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Returns:
the ending stroke color, represented as an integer
See Also:
ColorLib, ENDSTROKECOLOR

setEndStrokeColor

public void setEndStrokeColor(int color)
Set the ending stroke color of this item. The stroke color is used to draw lines and the outlines of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the ending stroke color, represented as an integer
See Also:
ColorLib, ENDSTROKECOLOR

getFillColor

public int getFillColor()
Get the current fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Returns:
the current fill color, represented as an integer
See Also:
ColorLib, FILLCOLOR

setFillColor

public void setFillColor(int color)
Set the current fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the current fill color, represented as an integer
See Also:
ColorLib, FILLCOLOR

getStartFillColor

public int getStartFillColor()
Get the starting fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with zero alpha component is fully transparent and will not be drawn.

Returns:
the starting fill color, represented as an integer
See Also:
ColorLib, STARTFILLCOLOR

setStartFillColor

public void setStartFillColor(int color)
Set the starting fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the starting fill color, represented as an integer
See Also:
ColorLib, STARTFILLCOLOR

getEndFillColor

public int getEndFillColor()
Get the ending fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with zero alpha component is fully transparent and will not be drawn.

Returns:
the ending fill color, represented as an integer
See Also:
ColorLib, ENDFILLCOLOR

setEndFillColor

public void setEndFillColor(int color)
Set the ending fill color of this item. The fill color is used to fill the interior of shapes. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the ending fill color, represented as an integer
See Also:
ColorLib, ENDFILLCOLOR

getTextColor

public int getTextColor()
Get the current text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with zero alpha component is fully transparent and will not be drawn.

Returns:
the current text color, represented as an integer
See Also:
ColorLib, TEXTCOLOR

setTextColor

public void setTextColor(int color)
Set the current text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the current text color, represented as an integer
See Also:
ColorLib, TEXTCOLOR

getStartTextColor

public int getStartTextColor()
Get the starting text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with zero alpha component is fully transparent and will not be drawn.

Returns:
the starting text color, represented as an integer
See Also:
ColorLib, STARTTEXTCOLOR

setStartTextColor

public void setStartTextColor(int color)
Set the starting text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the starting text color, represented as an integer
See Also:
ColorLib, STARTTEXTCOLOR

getEndTextColor

public int getEndTextColor()
Get the ending text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with zero alpha component is fully transparent and will not be drawn.

Returns:
the ending text color, represented as an integer
See Also:
ColorLib, ENDTEXTCOLOR

setEndTextColor

public void setEndTextColor(int color)
Set the ending text color of this item. The text color is used to draw text strings for the item. Color values as represented as an integer containing the red, green, blue, and alpha (transparency) color channels. A color with a zero alpha component is fully transparent and will not be drawn.

Parameters:
color - the ending text color, represented as an integer
See Also:
ColorLib, ENDTEXTCOLOR

getSize

public double getSize()
Get the current size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Returns:
the current size value
See Also:
SIZE

setSize

public void setSize(double size)
Set the current size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Parameters:
size - the current size value
See Also:
SIZE

getStartSize

public double getStartSize()
Get the starting size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Returns:
the starting size value
See Also:
STARTSIZE

setStartSize

public void setStartSize(double size)
Set the starting size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Parameters:
size - the starting size value
See Also:
STARTSIZE

getEndSize

public double getEndSize()
Get the ending size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Returns:
the ending size value
See Also:
ENDSIZE

setEndSize

public void setEndSize(double size)
Set the ending size value of the item. Size values are typically used to scale an item, either in one-dimension (e.g., a bar chart length) or two-dimensions (e.g., using pixel area to encode a quantitative value).

Parameters:
size - the ending size value
See Also:
ENDSIZE

getShape

public int getShape()
Get the current shape value of the item. One of the SHAPE constants included in the Constants class. This value only has an effect if a Renderer that supports different shapes is used (e.g., ShapeRenderer.

Returns:
the current shape value
See Also:
SHAPE

setShape

public void setShape(int shape)
Set the current shape value of the item. One of the SHAPE constants included in the Constants class. This value only has an effect if a Renderer that supports different shapes is used (e.g., ShapeRenderer.

Parameters:
shape - the shape value to use
See Also:
SHAPE

getStroke

public java.awt.BasicStroke getStroke()
Get the current stroke used to draw lines and shape outlines.

Returns:
the stroke used to draw lines and shape outlines

setStroke

public void setStroke(java.awt.BasicStroke stroke)
Set the current stroke used to draw lines and shape outlines.

Parameters:
stroke - the stroke to use to draw lines and shape outlines

getFont

public java.awt.Font getFont()
Get the current font for the item. The font is used as the default typeface for drawing text for this item.

Returns:
the current font value
See Also:
FONT

setFont

public void setFont(java.awt.Font font)
Set the current font for the item. The font is used as the default typeface for drawing text for this item.

Parameters:
font - the current font value
See Also:
FONT

getStartFont

public java.awt.Font getStartFont()
Get the starting font for the item. The font is used as the default typeface for drawing text for this item.

Returns:
the starting font value
See Also:
STARTFONT

setStartFont

public void setStartFont(java.awt.Font font)
Set the starting font for the item. The font is used as the default typeface for drawing text for this item.

Parameters:
font - the starting font value
See Also:
STARTFONT

getEndFont

public java.awt.Font getEndFont()
Get the ending font for the item. The font is used as the default typeface for drawing text for this item.

Returns:
the ending font value
See Also:
ENDFONT

setEndFont

public void setEndFont(java.awt.Font font)
Set the ending font for the item. The font is used as the default typeface for drawing text for this item.

Parameters:
font - the ending font value
See Also:
ENDFONT

getDOI

public double getDOI()
Get the degree-of-interest (DOI) value. The degree-of-interet is an optional value that can be used to sort items by importance, control item visibility, or influence particular visual encodings. A common example is to use the DOI to store the graph distance of a node from the nearest selected focus node.

Returns:
the DOI value of this item
See Also:
DOI

setDOI

public void setDOI(double doi)
Set the degree-of-interest (DOI) value. The degree-of-interet is an optional value that can be used to sort items by importance, control item visibility, or influence particular visual encodings. A common example is to use the DOI to store the graph distance of a node from the nearest selected focus node.

Parameters:
doi - the DOI value of this item
See Also:
DOI


Copyright ? 2007 Regents of the University of California