These properties and methods control the color and shading
of objects in a graph:
- Autoshading
(true/false); This property enables (true)/disables (false) automatic
shading of 3D cube walls and riser faces. When depth effect is applied
to a 2D graph with DepthRadius, this property also applies shading
to the faces of the 2.5D risers.
- ColorMode (0...2);
This property sets the color mode to be used in the graph (automatic,
color-by-series, or color-by-group). For 3D surface graphs, automatic
mode will cause the graph to be colored by height. For bar, line,
and area graphs, automatic mode will color the graph by series if
there is more than one series or by groups if there is only one
series. 0 (automatic) is the default value.
- ExactColorByHeight
(true/false); This property enables (true)/disables (false) exact coloring
by height in spectral maps and 3D surface graphs. When this property
is enabled (true), the actual data value is used to get a color
from the color-by-height gradient. When this property is disabled
(false), the colors on the spectral legend are the only ones used
and the data value is compared to determine which of those buckets it
falls into.
- SeriesLooping
(1...# of series in graph); Use this property to select the interval
at which series color values are repeated. The default setting (32)
defines different colors for the first 32 series (0...31). Starting
with series 32, the colors are repeated (that is, series 32...64
have the same colors as 0...31, respectively).
- get/setBorderColor();
These methods get/set the border color of an object.
- get/setFillColor();
These methods get/set the fill color of an object.
- get/setFillType();
These methods get/set the fill type of an object in a graph. The fill
type can be a color, gradient, or texture.
- getSelectionBorderColor();
This method returns the border color of an object.
- getSelectionFillColor();
This method returns the fill color of an object.
- get/setTransparentBorderColor();
These methods get/set the transparent border color of an object.
- get/setTransparentFillColor();
These methods get/set the transparent fill color of an object.
- setSeriesBorderColor();
This method sets the border color of risers for a specified series
in a graph.
- setSeriesFillColor();
This method sets the fill color of risers for a specified series in
a graph.
- getColorByHeight();
When a graph is colored by height (rather than by series or by group),
the graphing engine chooses the color of quantitative data representations based
on the data values supplied to the graph. This happens in spectral
map graphs and in 3D surface graphs. If, for example, the data ranges
from 7 to 74 and the Y1 axis scale, therefore, goes from 0 to 80,
the graphing engine might have the color blue assigned to 0, red
assigned to 80, and various interpolated shades for values between 0
and 80. Note that spectral map graphs do include a Y1 axis even
though it is not visible in the graph. The getColorByHeight() method
returns the IdentObj of the color by height gradient (in this case
a blue to red one). With the object ID, your application can modify
the gradient. Its end colors can be changed or the gradient could
be made more complex.
When you select a data point, you can change its color as described
above, except that if ExactColorByHeight is false, the graphing
engine changes the color of the appropriate spectral legend marker's
value instead of the color for the exact data value.
Example:
setExactColorByHeight(false);
When you use data ranges from 23 to 57, the gradient goes from
blue (20) to red (60). There are spectral markers at 20, 25, 30,
...60. When you click on marker 20 and change it to black, the colors
are interpolated from black (20) to red (60). When you click on
data point 31 and change its color to green, a new pin with the
color green is added at 0.25 (31 is colored as if it were 30 and
30 is 25% of the way from 20 to 60). Now the colors are interpolated
as follows: black (20) to green (30); green (30) to red (60).
setExactColorByHeight(true);
When the user clicks on data point 48 and changes its color to
yellow, a new pin is added at 0.7 (48 is 70% between 20 and 60)
with the color yellow. Now the colors are interpolated as follows:
black (20) to green (30); green (30) to yellow (48); yellow (48)
to red (60).
You can use the following properties and methods to control the
display of shadows in a graph.
- get/setShadowColor();
These methods get/set the color of a shadow applied to an object.
- get/setShadowDisplay();
These methods get/set whether or not a drop shadow is displayed
for a particular object in a graph.
- get/setShadowXOffset();
These methods get/set the offset in the X-direction of a drop shadow
for a particular object in a graph.
- get/setShadowYOffset();
These methods get/set the offset in the Y-direction of a drop shadow
for a particular object in a graph.
- ShadowXOffsetDefault
(0...100); This property sets the default value for the X-offset
of a drop shadow. 30 is the default value.
- ShadowYOffsetDefault
(0...100); This property sets the default value for the Y-offset
of a drop shadow. 30 is the default value.