Colors, Gradients, Textures, & Other Special Effects

get/setAltFmtFrameNumColors()

These methods get/set the number of colors/sections that will be used for alternate formatting of an axis. Alternate formatting can be used to apply different colors to sections of an axis and axis labels. You can also define a text label to show with an alternate formatted section.

SYNTAX:

int getAltFmtFrameNumColors(IdentObj idObj)
void setAltFmtFrameNumColors(IdentObj idObj, int newValue)

INPUT:

idObj; object id of an alternate formatting pseudo object (e.g., getO1AltFmtFrame(), getX1AltFmtFrame(),
getY1AltFmtFrame(), etc.)

newValue; For setAltFmtFrameNumColors(), number of colors/sections (0...100). The default value is 2.

RETURN:

int; For getAltFmtFrameNumColors(), number (0...100) of colors/sections defined for alternate formatting

EXAMPLE:


setDisplay(getY1AltFmtFrame(), true); 
setAltFmtFrameNumColors(getY1AltFmtFrame(), 2); 
setAltFmtFrameSeparator(getY1AltFmtFrame(0), 30.0); 
setDisplay(getY1AltFmtFrame(0), true); 
setDisplay(getY1AltFmtFrame(1), true); 
setFillColor(getY1AltFmtFrame(0), new Color(128,255,0)); 
setFillColor(getY1AltFmtFrame(1), new Color(255,255,0));
setGraphType(41);

ALSO SEE:

get/setAltFmtFrameSeparator(), getO1AltFmtFrame(), getO1AltFmtLabel(), getX1AltFmtFrame(), getX1AltFmtLabel(), getY1AltFmtFrame(), getY1AltFmtLabel(), getY2AltFmtFrame(), getY2AltFmtLabel(), getY3AltFmtFrame(), getY3AltFmtLabel(), getY4AltFmtFrame(), getY4AltFmtLabel(), getY5AltFmtFrame(), getY5AltFmtLabel(),

get/setAltFmtFrameSeparator()

These methods get/set the location on an axis where alternate formatting is applied.

SYNTAX:

double getAltFmtFrameSeparator(IdentObj idObj);
void setAltFmtFrameSeparator(IdentObj idObj, double dValue);

INPUT:

idObj; Object ID of an alternate formatting axis object (e.g., getY1AltFmtFrame(), getO1AltFmtFrame(), etc.).

newValue; For setAltFmtFrameSeparator(), the location on the axis where alternate formatting will be applied. For a numeric axis, specify a value that is within the range of values on the specified axis. For the ordinal (O1) axis, specify a group number that is within the range of groups on the ordinal axis.

RETURN:

double; For getAltFmtFrameSeparator(), the location on the axis where alternate formatting has been applied.

EXAMPLE:

setDisplay(getY1AltFmtFrame(), true); 
setAltFmtFrameNumColors(getY1AltFmtFrame(), 2); 
setAltFmtFrameSeparator(getY1AltFmtFrame(0), 25.0); 
setDisplay(getY1AltFmtFrame(0), true); 
setDisplay(getY1AltFmtFrame(1), true); 
setFillColor(getY1AltFmtFrame(0), new Color(128,128,0)); 
setFillColor(getY1AltFmtFrame(1), new Color(255,255,0));
setGraphType(41);

ALSO SEE:

get/setAltFmtFrameNumColors(), getO1AltFmtFrame(), getO1AltFmtLabel(), getX1AltFmtFrame(), getX1AltFmtLabel(), getY1AltFmtFrame(), getY1AltFmtLabel(), getY2AltFmtFrame(), getY2AltFmtLabel(), getY3AltFmtFrame(), getY3AltFmtLabel(), getY4AltFmtFrame(), getY4AltFmtLabel(), getY5AltFmtFrame(), getY5AltFmtLabel(),

get/setBorderColor()

These methods get/set the border color of a specified object.

SYNTAX:

color getBorderColor (IdentObj id);
void  setBorderColor (Color newValue);
void  setBorderColor (IdentObj id, Color newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

Color; value of color to be assigned to border (e.g., new Color (255, 0, 0) = Red)

RETURN:

color; A color value (e.g., new Color (255, 0, 0) = Red)

EXAMPLE:

setBorderColor (getSeries (4), new Color (255, 0, 0));
setFillColor (getSeries (4), new Color (0, 255, 255));

setBorderColor (getSeries (4), new Color (0, 0, 0));
setFillColor (getSeries (4), new Color (255, 255, 255));

NOTES:

If an object ID (id) is not specified, newValue is assigned to the first item in the selection list (if applicable).

ALSO SEE:

getSelectionBorderColor(), get/setTransparentBorderColor(), isSelectionBorderColorTransparent()

get/setBorderType()

These methods get/set the border type for a specified object. The default value is NONE. A border can be applied to an annotation box, beveled legend area, beveled legend marker, beveled riser, footnote box, subtitle box, or title box. The object must be enabled with the setDisplay() method (e.g., setDisplay(getTitleBox(), true);). For annotation, footnote, subtitle, and title box objects that use a border type other than BORDER_NONE or BORDER_LINE, border insets must also be specified with setBottom/Left/Right/TopInsets().

SYNTAX:

void setBorderType (IdentObj IdObj, int nBorderType);
 int getBorderType (IdentObj IdObj);

INPUT:

idObj; Object ID returned by getAnnotationBox(), getBeveledLegend(), getBeveledLegendMarker(), getBeveledRiser(), getFootnoteBox(), getSubtitleBox(), or getTitleBox().

nBorderType; One of the following border types

BORDER_NONE = 0;
BORDER_BEVEL = 1;
BORDER_BEVEL_RAISED = 2;
BORDER_BEVEL_LOWERED = 3;
BORDER_LINE = 4;
BORDER_LINE_DOUBLE = 5;

RETURN:

int; For getBorderType(), 0...5 identifies the border type applied to a specified object.

EXAMPLE:

setBorderType(getSubtitleBox(), 5);
setDisplay(getSubtitleBox(), true);
setTopInset(getSubtitleBox(), 250);
setBottomInset(getSubtitleBox(), 250);
setLeftInset(getSubtitleBox(), 250);
setRightInset(getSubtitleBox(), 250);
setDepthRadius(0);
setGraphType(41);

NOTES:

For getBeveledLegend(), getBeveledLegendMarker(), getBeveledRiser() objects, the border type cannot be set to BORDER_NONE (0), BORDER_LINE (4), OR BORDER_LINE_DOUBLE (5).

get/setBottom/Left/Right/TopInsets()

These methods get/set the top/bottom and right/left insets of borders of a specified object. The default value is 1 (which is essentially off). A border can be applied to an annotation box, beveled legend area, beveled legend marker, beveled riser, footnote box, subtitle box, or title box. Use setBorderType() to define the border style (beveled, line, double line).

SYNTAX:

int getBottomInset(IdentObj idObj);
void setBottomInset(IdentObj idObj, int newValue);
int getLeftInset(IdentObj idObj);
void setLeftInset(IdentObj idObj, int newValue);
int getRightInset(IdentObj idObj);
void setRightInset(IdentObj idObj, int newValue);
int getTopInset(IdentObj idObj);
void setTopInset(IdentObj idObj, int newValue);

INPUT:

idObj; Object ID returned by getAnnotationBox(), getBeveledLegend(), getBeveledLegendMarker(), getBeveledRiser(), getFootnoteBox(), getSubtitleBox(), or getTitleBox().

newValue; the inset of the border in virtual coordinates.

RETURN:

int; For get...Inset(), the inset of the border in virtual coordinates.

EXAMPLE:

setBorderType(getTitleBox(), 3);
setDisplay(getTitleBox(), true);
setTopInset(getTitleBox(), 500);
setBottomInset(getTitleBox(), 500);
setLeftInset(getTitleBox(), 500);
setRightInset(getTitleBox(), 500);
setFillColor(getTitleBox(), new Color(255,255,0));
setDepthRadius(0);
setGraphType(41);

ALSO SEE:

get/setBorderType(), get/setCornerArc...()

get/setCornerArcWidth/Height()

These methods get/set the width and height of the corner arc of a border that may be applied to an object. The default value is 5. A border can be applied to an annotation box, beveled legend area, beveled legend marker, beveled riser, footnote box, subtitle box, or title box.

SYNTAX:

int getCornerArcHeight (IdentObj id);
void setCornerArcHeight (IdentObj anObject, int newValue);
int getCornerArcWidth (IdentObj id);
void setCornerArcWidth (IdentObj anObject, int newValue);

INPUT:

idObj; Object ID returned by getAnnotationBox(), getBeveledLegend(), getBeveledLegendMarker(), getBeveledRiser(), getFootnoteBox(), getSubtitleBox(), or getTitleBox().

newValue; Height or width of corner arc in virtual coordinates

RETURN:

int; Height or width of corner arc applied to object

EXAMPLE:

setBorderType(getTitleBox(), 3);
setDisplay(getTitleBox(), true);
setTopInset(getTitleBox(), 500);
setBottomInset(getTitleBox(), 500);
setLeftInset(getTitleBox(), 500);
setRightInset(getTitleBox(), 500);
setCornerArcHeight(getTitleBox(), 1000);
setCornerArcWidth(getTitleBox(), 1000);
setFillColor(getTitleBox(), new Color(255,255,0));
setDepthRadius(0);
setGraphType(41);

ALSO SEE:

get/setBorderType(), get/set...Insets()

get/setFillColor()

These methods get/set the value of a fill color of an object in a chart.

SYNTAX:

Color getFillColor (IdentObj id);
void  setFillColor (Color newValue);
void  setFillColor (IdentObj id, Color newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

newValue; the value of the fill color (e.g., new Color (255, 0, 0) = Red)

RETURN:

Color; value of the fill color for the object identified by id, null = no fill color applied

EXAMPLE:

setViewableGroups (3);
setViewableSeries (3);
setDataScrollerPresenceGroups (0);
setFillColor (getChartBackground(), new Color (255, 255, 0));
setDepthRadius (0);

NOTES:

ALSO SEE:

get/setBorderColor(), get/setFillType(), getSelectionFillColor(), get/setTransparentFillColor(), isSelectionFillColorTransparent()

get/setFillType()

These methods get/set an integer that identifies the fill type assigned to an object.

SYNTAX:

int  getFillType (IdentObj id);
void setFillType (int newValue);
void setFillType (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

newValue; fill type (1...3): 1 = Color, 2 = Gradient, 3 = Texture

RETURN:

int; fill type (1...3): 1 = Color, 2 = Gradient, 3 = Texture

EXAMPLE:

setDepthRadius (0);
setGraphType (32);
setFillType (getSeries (0), 1);
setFillColor (getSeries (0), new Color (245, 175, 224));
setFillType (getSeries (1), 1);
setFillColor (getSeries (1), new Color (140, 246, 147));
setFillType (getSeries (3), 1);
setFillColor (getSeries (3), new Color (255, 255, 255));

NOTES:

ALSO SEE:

get/setFillColor(), setGradientDirection(), get/setGradientNumPins(), get/setGradientPinLeftColor(),
get/setGradientPinPosition(), get/setGradientPinRightColor(), setTextureURL(), get/setTextureDisplayMode()

get/setGradientDirection()

These methods get/set the direction of a gradient.

SYNTAX:

int  getGradientDirection (IdentObj id);
void setGradientDirection (int newValue);
void setGradientDirection (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

int; gradient direction (1...13). 1 = Right, 2 = Left, 3 = Down, 4 = Up, 5 = Down/Left, 6 = Up/Left, 7 = Down/Right, 8 = Up/Right, 9 = Radial, 10 = Radial/Top/Left, 11 = Radial/Top/Right, 12 = Radial/Bottom/left, 13 = Radial/Bottom/Right

RETURN:

int; gradient direction (1...13)

NOTES:

ALSO SEE:

get/setFillType(), get/setGradientNumPins(), get/setGradientPinLeftColor(), get/setGradientPinRightColor(), get/setGradientPinPosition(), insertGradientPin()

get/setGradientNumPins()

These methods get/set the number of pins in a gradient.

SYNTAX:

int  getGradientNumPins (IdentObj id);
void setGradientNumPins (int newValue);
void setGradientNumPins (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

RETURN:

int; number of pins in gradient

EXAMPLE:

setGraphType (32);
setDepthRadius (0);
setFillType (getSeries (4), 2);
setGradientDirection (getSeries (4), 1);
setGradientNumPins (getSeries (4), 2);
setGradientPinLeftColor (getSeries (4), new Color (0, 0, 0), 1);
setGradientPinLeftColor (getSeries (4), new Color (0, 255, 255), 0);
setGradientPinPosition (getSeries (4), 1.0, 1);
setGradientPinPosition (getSeries (4), 0.0, 0);
setGradientPinRightColor (getSeries (4), new Color (0, 0, 0), 1);
setGradientPinRightColor (getSeries (4), new Color (0, 255, 255), 0);

ALSO SEE:

get/setFillType(), get/setGradientDirection(), get/setGradientPinLeftColor(), get/setGradientPinRightColor(), get/setGradientPinPosition(), insertGradientPin()

get/setGradientPinLeftColor()

These methods get/set the color used by the left pin of a gradient.

SYNTAX:

Color getGradientPinLeftColor (IdentObj id,  int nIndex);
void  setGradientPinLeftColor (Color newValue, int nIndex);
void  setGradientPinLeftColor (IdentObj id, Color newValue, int nIndex);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

nIndex: 0...Number of pins in gradient

newValue; the color value of the left pin in a gradient

RETURN:

Color: color value of the left pin in a gradient

ALSO SEE:

get/setFillType(), get/setGradientDirection(), get/setGradientNumPins(), get/setGradientPinRightColor(), get/setGradientPinPosition(), insertGradientPin()

get/setGradientPinPosition()

These methods get/set an integer that identifies the pin position of a gradient.

SYNTAX:

double getGradientPinPosition (IdentObj id,  int nIndex);
void setGradientPinPosition (double newValue, int nIndex);
void setGradientPinPosition (IdentObj id,  double NewValue, int nIndex);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

nIndex; 0...Number of pins in gradient

newValue; position in the gradient (0.0 to 1.0)

RETURN:

double; position in the gradient (0.0 to 1.0)

ALSO SEE:

get/setFillType(), get/setGradientDirection(), get/setGradientNumPins(), get/setGradientPinRightColor(), get/setGradientPinLeftColor(), insertGradientPin()

get/setGradientPinRightColor()

These methods get/set the color used by the right pin of a gradient.

SYNTAX:

Color getGradientPinRightColor (IdentObj id, int nIndex);
void setGradientPinRightColor (Color newValue, int nIndex);
void setGradientPinRightColor (IdentObj id, Color newValue, int nIndex);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

nIndex; 0...Number of pins in gradient

newValue; the color value of the right pin in a gradient

RETURN:

Color; the color value of the right pin in a gradient

EXAMPLE:

setFillType (getSeries (4), 2);
setGradientDirection (getSeries (4), 1);
setGradientNumPins (getSeries (4), 2);
setGradientPinLeftColor (getSeries (4), new Color (0, 0, 0), 1);
setGradientPinLeftColor (GetSeries (4), new Color (0, 0, 255), 0);
setGradientPinPosition (getSeries (4), 1.0, 1);
setGradientPinPosition (getSeries (4), 0.0, 0);
setGradientPinRightColor (getSeries (4), new Color (0, 0, 0), 1);
setGradientPinRightColor (getSeries (4), new Color (0, 0, 255), 0);

ALSO SEE:

get/setFillType(), get/setGradientDirection(), get/setGradientNumPins(), get/setGradientPinPosition(), get/setGradientPinLeftColor(), insertGradientPin()

get/setShadowColor()

These methods get/set the color of a drop shadow.

SYNTAX:

Color getShadowColor (IdentObj id);
void setShadowColor (IdentObj id, Color newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getFrame())

color: the value of the color to be applied to the drop shadow id

RETURN:

color; the value of the drop shadow applied to id, null = no drop shadow color applied

EXAMPLE:

setDepthAngle (0);
setDepthRadius (0);
setShadowDisplay (getFrame(), true);
setShadowXOffset (getFrame(), 10);
setShadowYOffset (getFrame(), 10);
setShadowColor (getFrame(), new Color (0, 255, 255));

ALSO SEE:

get/setShadowDisplay(), get/setShadowXOffset(), get/setShadowYOffset()

get/setShadowDisplay()

These methods get/set a drop shadow that can be applied to an object in a chart.

SYNTAX:

boolean getShadowDisplay();
boolean getShadowDisplay (IdentObj id);
void setShadowDisplay (boolean newValue);
void setShadowDisplay (IdentObj id, boolean newValue);

INPUT:

id; object ID returned by a getObject() method (e.g, getFrame())

newValue; true = Drop shadow is displayed, false = Drop shadow not drawn

RETURN:

boolean; true = Drop shadow is displayed, false = Drop shadow not drawn

NOTES:

If a specific object is not identified with the input parameter id, these methods get/set the associated value (if any) for the first item in the selection list.

ALSO SEE:

get/setShadowColor(), get/setShadowXOffset(), get/setShadowYOffset()

get/setShadowFillType()

When shadow is enabled for a specified text object (e.g., setShadowDisplay (getTitle(), true)), these methods get/set a shadow fill type. The default value is 1 (FILL_COLOR). If FILL_GRADIENT_LEFTTORIGHT (2) is used, use setShadowGradientStartColor() and setShadowGradientEndColor() to specified the starting and ending colors of the gradient. If FILL_TEXTURE (3) is used, use setShadowTextureURL() to define the texture file.

SYNTAX:

int getShadowFillType (IdentObj id);
void setShadowFillType (IdentObj id, int newValue)

INPUT:

id; object ID returned by a getObject() method (e.g., getTitle())

newValue; FILL_COLOR = 1, FILL_GRADIENT_LEFTTORIGHT = 2, FILL_TEXTURE = 3

RETURN:

int; FILL_COLOR = 1, FILL_GRADIENT_LEFTTORIGHT = 2, FILL_TEXTURE = 3

ALSO SEE:

get/setShadowDisplay(), get/setShadowGradientEndColor(), get/setShadowGradientStartColor(), setShadowTextureURL()

get/setShadowGradientEndColor()

When setShadowFillType() assigns a gradient (FILL_GRADIENT_LEFTTORIGHT (2)) to a text object, these methods get/set the ending color of a gradient for a specified object. The default value is green.

SYNTAX:

Color getShadowGradientEndColor (IdentObj idObj);
void setShadowGradientEndColor (IdentObj idObj, Color col);

INPUT:

idObj; object ID returned by a getObject() method (e.g., getTitle())

col; color specificiation (e.g., new Color (255, 0, 0) // red)

RETURN:

Color; shadow gradient end color assigned to the specified text object.

ALSO SEE:

get/setShadowFillType(), get/setShadowGradientStartColor()

get/setShadowGradientStartColor()

When setShadowFillType() assigns a gradient (FILL_GRADIENT_LEFTTORIGHT (2)) to a text object, these methods get/set the starting color of a gradient for a specified object. The default value is blue.

SYNTAX:

Color getShadowGradientStartColor (IdentObj idObj);
void setShadowGradientStartColor (IdentObj idObj, Color col);

INPUT:

idObj; object ID returned by a getObject() method (e.g., getTitle())

col; color specificiation (e.g., new Color (255, 0, 0) // red)

RETURN:

Color; shadow gradient start color assigned to the specified text object.

EXAMPLE:

// Gradient on the title 
setFillType (getTitle(), 2); 
setGradientDirection (getTitle(), 1); 
setGradientNumPins (getTitle(), 2); 
setGradientPinLeftColor (getTitle(), new Color (0, 255, 0), 1); 
setGradientPinLeftColor (getTitle(), new Color (0, 0, 255), 0); 
setGradientPinPosition (getTitle(), 1.0, 1); 
setGradientPinPosition (getTitle(), 0.0, 0); 
setGradientPinRightColor (getTitle(), new Color (0, 255, 0), 1); 
setGradientPinRightColor (getTitle(), new Color (0, 0, 255), 0); 
// Gradient on the drop shadow 
setShadowDisplay (getTitle(), true); 
setShadowFillType (getTitle(), Java2DTextLowLevel.FILL_GRADIENT_LEFTTORIGHT); 
setShadowTextureURL (getTitle(), "C:/pfjFull/tiles/Granite.gif"); 
setShadowGradientStartColor (getTitle(), new Color (0, 255, 0)); 
setShadowGradientEndColor (getTitle(), new Color (255, 0, 0));

ALSO SEE:

get/setShadowFillType(), get/setShadowGradientEndColor()

get/setShadowTextureURL()

When setShadowFillType() assigns a texture (FILL_TEXTURE (3)) to a text object, these methods get/set the texture file that may be applied to the object. This method is identical to setTextureURL() except it only applies to Java 2D Text.

SYNTAX:

Image getShadowTextureURL (String szURL);
String getShadowTextureURL (IdentObj id);
void setShadowTextureURL (IdentObj id, String szURL);

INPUT:

id; object ID of a text object returned by a getObject() method

szURL; URL specification string that identifies a texture file

RETURN:

String; URL specification string that identifies a texture file

Image; java.awt.Image set by setShadowTextureURL() for a specified text object

EXAMPLE:

// Texture on the front
setFillType (getTitle(), 3);
setTextureDisplayMode (getTitle(), 0);
setTextureURL (getTitle(), "C:/JavaChart/pfjFull/tiles/Purple_Pink_Granite.gif");
// Texture on the drop shadow
setShadowDisplay (getTitle(), true);
setShadowFillType (getTitle(), 3);
setShadowTextureURL (getTitle(), 
"C:/JavaChart/pfjFull/tiles/Azul_Granite.gif");

ALSO SEE:

setTextureURL()

get/setShadowXOffset()

These methods get/set the offset in the X-direction of a drop shadow that has been applied to an object.

SYNTAX:

int getShadowXOffset();
int getShadowXOffset (IdentObj id);
void setShadowXOffset (int newValue);
void setShadowXOffset (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method

newValue; X-direction offset of the drop shadow applied to id, null = no drop shadow applied

RETURN:

int; X-direction offset of the drop shadow applied to id, null = no drop shadow applied

NOTES:

If a specific object is not identified with the input parameter id, these methods get/set the associated value (if any) for the first item in the selection list.

ALSO SEE:

get/setShadowColor(), get/setShadowDisplay(), get/setShadowYOffset()

get/setShadowYOffset()

These methods get/set the offset in the Y-direction of a drop shadow that is assigned to an object.

SYNTAX:

int getShadowYOffset();
int getShadowYOffset (IdentObj id);
void setShadowYOffset (int newValue);
void setShadowYOffset (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method

newValue; Y-direction offset of the drop shadow applied to id, null = no drop shadow applied

RETURN:

int; Y-direction offset of the drop shadow applied to id, , null = no drop shadow applied

NOTES:

If a specific object is not identified with the input parameter id, these methods get/set the associated value (if any) for the first item in the selection list.

ALSO SEE:

get/setShadowColor(), get/setShadowDisplay(), get/setShadowXOffset()

getTexture()

This method can be used to determine if a texture has been applied to an object in a chart. When a texture name (i.e., a .GIF file name) is supplied as an input parameter, this method identifies whether or not the named texture is applied to any object in the chart. If an object ID is specified (e.g., getTexture (getSeries (1);), this method will identify whether or not a texture is applied to the specific object.

SYNTAX:

Image getTexture (String szURL);
String getTexture (IdentObj id);

INPUT:

szURL; name of an image to look for in the chart

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

RETURN:

Image; indicates whether or not the texture exists in the chart. null = texture is not in the look

String; the name of the texture (if any) assigned to id.

EXAMPLE:

setDepthRadius (0);
setFillType (getSeries (2), 3);
setTextureDisplayMode (getSeries (2), 0);
setTextureURL (getSeries (2), "C:/PJE/tiles/Azul_Granite.gif");
setViewableGroups (3);
setViewableSeries (3);
setDataScrollerPresenceGroups (0);
setTitleString (getTexture (getSeries (2)));

ALSO SEE:

get/setTextureDisplayMode(), get/setFillType(), setTextureURL(), DisplayBarAsPictograph

get/setTextureBGColor()

These methods get/set a texture background color for a specified object.

SYNTAX:

Color getTextureBGColor(); 
Color getTextureBGColor (IdentObj id);
Color getTextureBGColor (int seriesID);
Color getTextureBGColor (int seriesID, int groupID);
public void setTextureBGColor (Color newValue);
void setTextureBGColor (IdentObj id, Color newValue);
void setTextureBGColor (int seriesID, Color newValue);
void setTextureBGColor (int seriesID, int groupID, Color newValue);

INPUT:

IdentObj; object ID returned by a getObject() method

seriesID; a series number

groupID; a group number

newValue; a color (e.g., new Color (255, 0, 0)) to be applied to the background of a texture for a specified object.

RETURN:

Color; Color assigned to the specified object's texture background

get/setTextureDisplayMode()

These methods get/set the texture display mode for a specified object.

SYNTAX:

int getTextureDisplayMode (IdentObj id);
int getTextureDisplayMode();
void setTextureDisplayMode (int newValue);
void setTextureDisplayMode (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

newValue; Texture display mode (0/1). 0 = Stretched, 1 = Tiled

RETURN:

int; Texture display mode (0/1). 0 = Stretched, 1 = Tiled

EXAMPLE:

setFillType (getSeries (3), 3);
setFillType (getSeries (0), 3);
setFillType (getSeries (2), 3);
setFillType (getSeries (4), 3);
setFillType (getSeries (1), 3);
setGraphType (32);
setTextureDisplayMode (getSeries (3), 0);
setTextureDisplayMode (getSeries (0), 0);
setTextureDisplayMode (getSeries (2), 0);
setTextureDisplayMode (getSeries (4), 0);
setTextureDisplayMode (getSeries (1), 0);
setTextureURL (getSeries (3), "C:/PJE/tiles/Soft_Blue_Marble.gif");
setTextureURL (getSeries (0), "C:/PJE/tiles/Soft_Blue_Marble.gif");
setTextureURL (getSeries (2), "C:/PJE/tiles/Oil.gif");
setTextureURL (getSeries (4), "C:/PJE/tiles/Yellow.gif");
setTextureURL (getSeries (1), "C:/PJE/tiles/Azul_Granite.gif");

NOTES:

If a specific object is not identified with the input parameter id, these methods get/set the associated value (if any) for the first item in the selection list.

ALSO SEE:

get/setTextureFlipMode()

get/setTextureFlipMode()

These methods get/set the direction in which a texture is drawn for a selected object.

SYNTAX:

int getTextureFlipMode (IdentObj id);
int getTextureFlipMode();
void setTextureFlipMode (int newValue);
void setTextureFlipMode (IdentObj id, int newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getO1Label())

newValue; flip mode (0...3). 0 = No flipping, 1 = Flip vertical, 2 = Flip horizontal, 3 = Flip vertical and horizontal

RETURN:

int; texture flip mode 0...3. The default value is (0).

NOTES:

If a specific object is not identified with the input parameter id, these methods get/set the associated value (if any) for the first item in the selection list.

ALSO SEE:

get/setTextureDisplayMode()

get/setTransparentBorderColor()

These methods get/set transparent border color mode for a specified object.

SYNTAX:

boolean getTransparentBorderColor (IdentObj id);
void setTransparentBorderColor (boolean newValue);
void setTransparentBorderColor (IdentObj id, boolean newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

newValue; TRUE = apply transparent border color

RETURN:

boolean; true = Transparent border color is applied, false = Transparent border color not applied

NOTES:

If an object ID (id) is not specified, newValue is assigned to the first item in the selection list (if applicable).

ALSO SEE:

get/setBorderColor(), getSelectionBorderColor(), isSelectionBorderColorTransparent()

get/setTransparentFillColor()

These methods get/set transparent fill color mode for a specified object.

SYNTAX:

boolean getTransparentFillColor (IdentObj id);
void setTransparentFillColor (boolean newValue);
void setTransparentFillColor (IdentObj id, boolean newValue);

INPUT:

id; object ID returned by a getObject() method (e.g., getSeries())

newValue; true = Apply transparent fill color, false = Do not apply transparent fill color

RETURN:

boolean; true = Transparent fill color is applied, false = Transparent fill color not applied

ALSO SEE:

get/setFillColor(), getSelectionFillColor(), isSelectionFillColorTransparent()

insertGradientPin()

This method inserts a new color pin in a gradient.

SYNTAX:

void insertGradientPin (
     tdg.draw.IdentObj id,
     double newPin,
     java.awt.Color leftColor,
     java.awt.Color rightColor
);

INPUT:

id: IdentObj returned by a getObject() method (e.g., getSeries())

newPin: a new gradient pin number

leftColor: the left color value of the new pin

rightColor: the right color value of the new pin

RETURN:

void;

ALSO SEE:

get/setGradientPinLeftColor(), get/setFillType(), get/setGradientDirection(), get/setGradientNumPins(), get/setGradientPinRightColor(), get/setGradientPinPosition()

setShadowTextureURL()

When setShadowFillType() assigns a texture (FILL_TEXTURE (3)) to a text object, this method defines the texture file to be applied to the object. This method is identical to setTextureURL() except it only applies to Java 2D Text.

SYNTAX:

void setShadowTextureURL (IdentObj id, String szURL)

INPUT:

id; object ID of a text object returned by a getObject() method

szURL; URL specification string that identifies a texture file

RETURN:

void

ALSO SEE:

get/setShadowFillType()

setTextureResource()

This method assigns a texture from a file to a specified chart object.

SYNTAX:

void setTextureResource (IdentObj id, String szResource)

INPUT:

id; object ID returned by a getObjectID() method (e.g., getSeries())

szResource; texture file name

RETURN:

void;

ALSO SEE:

get/setTextureDisplayMode(), get/setTextureFlipMode(), setTextureURL()

setTextureURL()

This method can be used to load a texture image from a URL/file and assign it to object (s) in the chart. Note that the setFillType() method be used to select a texture fill type.

SYNTAX:

void setTextureURL (String szURL)
void setTextureURL (IdentObj id, String szURL)
void setTextureURL (String szURL, Image theImage)
void setTextureURL (IdentObj id, String szURL, Image theImage)

INPUT:

id; Object ID returned by a getObjectID() method (e.g., getSeries())

theImage; A URL/file name where the texture image resides.

szURL; Size of the URL

RETURN:

void

ALSO SEE:

get/setFillType(), get/setTextureDisplayMode()