ChartDirector 7.0 (Perl Edition)

PyramidChart.setGradientShading


Usage

setGradientShading(startBrightness, endBrightness)

Description

Sets gradient shading mode.

Gradient shading only applies to 2D and 3D pyramids, and 2D cones and funnels. 3D cones and funnels always use Phong lighting (see PyramidChart.setLighting).

The gradient is specified with two brightness values at the gradient end points. A brightness less than 1 means the color is darkened, while a brightness greater than 1 means the color is brightened. For example, a brightness of 0.5 means the color is half as bright as the original color. If the original color is red, the color will become dark red. Conversely, a brightness of 2 means the color is twice as bright as the original color. If the original color is red, the color will become light red.

For a pyramid or cone layer, the gradient is from left edge to the right edge. For a funnel chart, the gradient is from the right edge to the left edge.

For a pyramid chart, this is the default coloring method. If this method is never called, the default brightness is from 0.75 to 2.

Arguments

ArgumentDefaultDescription
startBrightness(Mandatory)The brightness at the starting point.
endBrightness(Mandatory)The brightness at the ending point.

Return Value

None