ChartDirector 6.0 (Perl Edition)

PieChart.setSectorStyle


Usage

setSectorStyle(shadingMethod [, edgeColor [, edgeWidth ]])

Description

Sets the sector shading style, edge color and edge width.

This method affects all sectors. To set the sector shading style, edge color and edge width for one particular sector, use Sector.setStyle.

ChartDirector supports various shading effects, which are best illustrated using examples.

ExampleDescription
2D Pie ShadingIllustrates various shading effects for 2D pies.
3D Pie ShadingIllustrates various shading effects for 3D pies.
2D Donut ShadingIllustrates various shading effects for 2D donuts.
3D Donut ShadingIllustrates various shading effects for 3D donuts.

The followings are textual descriptions of the shading effects.

ConstantValueDescription
DefaultShading0This is the default shading method. The top surfaces are shaded with flat colors. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.
FlatShading1All surfaces are shaded with flat colors.
LocalGradientShading2The top surfaces are shaded with linear gradient colors. For each sector, the gradient is from the bottom of the sector bounding box to the top of the sector bounding box, with the bottom side brighter and the top side darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.
GlobalGradientShading3The top surfaces are shaded with linear gradient colors. The gradient is from the bottom the pie bounding box to the top of the pie bounding box, with the bottom side brighter and the top side darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.
ConcaveShading4The top surfaces are shaded with a special effect so that they look concave, with the pie center appears to be depressed relative to the perimeter. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.
RoundedEdgeShading6The top surfaces are shaded with a special effect so that the pie looks raised with a rounded raised edge at the perimeter.
RadialShading7The top surfaces are shaded with radial gradient colors, with the pie center brighter and the perimeter darker. For 3D sectors, the cylindrical surfaces are shaded with cylindrical lighting effects.
RingShading8This effect is intended to be used with 2D donut charts only. The top surfaces are shaded with a special effect so that a 2D donut will look like a torus.

Arguments

ArgumentDefaultDescription
shadingMethod(Mandatory)The sector shading style to use, which must be one of the constants in the table above. -1 means to keep the existing value unchanged.
edgeColor-1The edge color of the sectors. -1 means to keep the existing value unchanged.
edgeWidth-1The edge width of the sectors. -1 means to keep the existing value unchanged.

Return Value

None