Pie Chart

The user can rotate the pie and labels by dragging the mouse around the center, or by using the keyboard arrow keys, and can position slices radially (i.e., exploded slices) by dragging them with the mouse or by using keyboard keys. (See Interactive Processing for more details about mouse and keyboard interaction with a piechart.)

 

SliceAnimationStyle

	SliceAnimationStyle = GROW | FADE | NONE;

Specifies how slices initially appear in a pie chart. This parameter is only valid in SVG or SVGWeb output formats.

   example: SliceAnimationStyle = GROW;

GROW

The slices grow and spin their actual value.

FADE The slices fade in.
NONE The slices are immediately visible.

 

SliceData

	SliceData = Value1, Value2, Value3 ... ValueN;

Defines the numeric values for each pie slice.

 

SliceColors


        SliceColors = Color1, Color2, Color3 ... ColorN;

Defines the colors of pie slices.

 

SliceLabel 


         SliceLabel = (State,Color,FontName,FontSize,Angle,InteriorAlignment);

Controls the appearance of the text in slice labels.

State Indicates if this parameter is in effect or not. If State is null no label will be drawn. If State=ON (or any non-null value) labels will be drawn
Color label color
FontName label font name
FontSize label font size
Angle label angle of rotation
InteriorAlignment For multiline labels, specifies the alignnment of the text in each row. Legal values are LEFT,RIGHT or CENTER. The default value is CENTER.

 

SliceLabelBox 

	SliceLabelBox = Color, BorderType, BorderWidth;

Controls the appearance of the optional box surrounding each slice label.
 Color  The color of the region. If an image attribute is also defined, this color is drawn first, followed by the image, allowing this color to show through any transparent parts of the image.
BorderType  The following border styles are supported: 
NONE    - No border
BOX     - Simple Box outline
SHADOW  - Shadow border
RAISED  - Raised border
RECESS  - Recessed border
When the BOX and SHADOW styles are specified, the border color will be black. When the RAISED and RECESS styles are specified, the border color will be chosen based on the region color.
 BorderWidth  This attribute defines the width of the border in pixels.

 

SliceLabelContent 

	SliceLabelContent = PERCENTAGE,DATA,LABEL;

Controls the parameters that are displayed within slice labels when SliceLabelStyle is set to RADIAL or EXTERIOR.

Multiple variations may be specified.
PERCENTAGE Displays the slice percentage as nn.nn% (for backward compatibility)
PERCENTAGE_FLOAT Displays the slice percentage as nn.nn%
PERCENTAGE_INT Displays the slice percentage as nn%
DATA The data value, as formatted in the SliceFormat parameter.
LABEL The label passed as part of the Slices or SliceLabels parameter.

 

SliceLabelContentDelimiter

	SliceLabelContentDelimiter = delimiter;

Specifies the delimiter character that will be placed between the SliceLabelContent parameters that are used in slice labels when SliceLabelStyle is set to RADIAL or EXTERIOR. 

example: SliceLabelContentDelimiter = "\n";

 

SliceLabelLine

	SliceLabelLine = LineStyle, LineWidth, Color;

Controls the appearance of the lines connecting EXTERIOR pie slice labels to pie slices. If the color is set to NULL or left undefined, the line color will match the associated slice color.
lineStyle 

SOLID (default), DOTTED, DASHED, DOTDASH
lineWidth The width of the line in pixels. Default width is 1.
lineColor The color of the line. Default color is black.

 

SliceLabels

	SliceLabels Label1, Label2, Label3, ... LabelN;

Specifies the text for the labels associated with each pie slice.

 

SliceLabelStyle

	SliceLabelStyle = EXTERIOR|RADIAL|NONE;

Specifies the style in which the slice labels are displayed. EXTERIOR places the label outside the pie with a line connecting the label to the slice. RADIAL places the label inside each slice. NONE suppresses the display of the slice labels. Slice labels will appear in the legend, if the legend is enabled.

 

Slices (Deprecated)

This parameter has been deprecated in favor of SliceData, SliceLabel, SliceLabelBox, SliceLabelContent, SliceLabelContentDelimiter, SliceLabelLine, SliceLabelStyle. 
	Slices = (Slice Tuple1), (Slice Tuple2), ...;

Defines a set of slices for the piechart. Each slice is defined using a tuple containing the following parameters:

value numeric value represented by the pie slice. The percentage will be computed based on the total of all slice values.
pieColor pie slice color.
"label" label associated with pie slice.
labelColor label color
"labelFont" label font name
labelSize label font size
labelAngle label angle of rotation
bgColor color of underlying label region
bgBorder border type of underlying region

Only the first two values need to be specified, all others will be assigned default values. For the first slice, the defaults will be based on system defaults. For all other slices, the value assigned to the previous slice for that attribute will be used as the default. In that way, you need only specify attributes for the first slice in order to control the attributes of all slices. The value "null" may be passed as a pie slice value, but has the same effect as a 0 slice value.

If a pieColor is not specified in the vector, then the previously specified color will be used. If the color is specified as "null", then a default color will be chosen from the color table. (See the ColorTable parameter.)

 

LabelPos

	LabelPos = Float;

Defines the position of a pie slice label relative to the width of the pie. A value of 1.1 will place each label just outside the pie, while a value of 0.6 will place each label inside of each pie slice.

 

SlicePos

	SlicePos = pos1, pos2, pos3,...;

Defines the position of each pie slice relative to the width of the pie. The value may be expressed as a fractional value in the range 0.0 to 2.0, or as a percentage value in the range of 2 to 100. A value of 0.5 or 50.0 will move the slice center radially out 50 percent of the width of the pie. That is, any nonzero value will result in the slice being exploded.

 

SliceBorder

	SliceBorder = (lineType, lineWidth, lineColor);

This parameter specifies the line style to be used for the border of all pie slices. The following attribute values are supported:

lineType Specifies the style of the border line to be drawn, as follows: 

SOLID (default), DOTTED, DASHED, DOTDASH
lineWidth The width of the line in pixels. Default width is 1.
lineColor The color of the line. Default color is black.

 

SliceFormat

	SliceFormat = (FormatType, "FormatExpr");

The numeric labels that are automatically generated for each slice can be formatted using the SliceFormat parameter. The FormatType attribute specifies the type of number being displayed by that axis, with the following types currently supported:

FLOAT the numeric values should be displayed with decimal parts.
INTEGER the numeric values should be displayed as integers, rounded if necessary.

The FormatExpr attribute of the SliceFormat parameter specifies a display format to be used for each slice label and each active label generated by default. The format allows a developer to specify numeric formats using expressions similar to those provided in the C/Unix printf function. The format expressions can consist of an arbitrary string, plus one or more occurrences of format components, which are preceded by '%'. See Axis for more details on numeric format expressions.

 

SliceSlide

	SliceSlide = ON | OFF

When SliceSlide = ON, clicking on a pie slice will cause the slice to slide in or out of the pie. This parameter is only valid in SVG or SVGweb output formats. 

   example: SliceSlide = ON;

 

Pie3DDepth

	Pie3DDepth = Integer;

Specifies the pixel depth of the 3D effect or shadow.

 

PieAngle

	PieAngle = Integer;

Specifies the starting angle for the the first pie slice. The angle is measured in degrees from 0 to 360, in a counterclockwise direction, with 0 degrees pointing to the right (i.e., the 3 o'clock position).

 

PieDropShadow

	PieDropShadow = (color,offsetx,offsety,size);

PieDropShadow places a shadow on the background field of the pie chart. The color, orientation, and size of the shadow can be defined. The tuple element color sets the color of the shadow. That color value is interpolated to complete transparency as it reaches the end of the shadow's blur area. Offsetx and offsety define the center point of the shadow; offsetx sets the x-axis offset from the chart's center-point; offsety sets the y-axis offset. When an offset attribute is set to a whole number value, the position of the drop shadow is offset from the chart's center point by the number of pixels set by that whole number. When an offset is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow (the pie). The center of the drop shadow is repositioned based upon the values or percentages set for offsetx and offsety. Offset attribute values may be positive or negative. Size sets the size of the blur area, the region beyond the actual drop shadow shape where the shadow is extended and blurred into transparency. The size of this blurred region is controlled by the size attribute. The blurred region becomes larger and more diffuse as the value of size is increased. When size is set to a whole number value, the size of the blurred area is defined in pixels. When size is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow. When using a fractional value, enclose the value in double-quotes to "escape" the decimal point.

   example: PieDropShadow = (Black_100,5,5,"0.05");

 

PieEdgeHighlights

	PieEdgeHighlights = (start,stop,gap,size), ...;
The PieEdgeHighlights parameter provides a visual pattern fill in a Pie or MultiPie chart which accents the inner pie border. It overlays a ring (annulus) fill pattern over the existing fill patterns in a specified zone along the interior edge of the pie. The gap between the sides of the pie and the fill pattern being applied can be modified. The element Start sets the beginning color of the gradient, associated with the outside edge; the element Stop sets the end color of the gradient, associated with the interior of the pie where the color blends to transparency. Color values are interpolated between the two. The element Size specifies the width of the highlight. The element Gap specifies the size of the gap between the edge of the highlight and the edge of the pie. When the value for Gap is specified as a whole number, it sets the distance between the edge of the highlight and the edge of the pie in pixels. When set to a fractional number between 0 and 1, it sets the gap to a percentage of the radius of the pie. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal points. 

   example: PieEdgeHighlights = (blue_25,white_75,1,25);

 

PieHighlights

	PieHighlights = (type,start,stop,angle,gap,extent), ...;
The PieHighlights parameter provides a visual pattern fill in a Pie or MultiPie chart. It adds or overlays a fill pattern over one or more existing fill patterns to produce multiple color effects. The angle of origin of the gradient pattern can be modified. The gap between the sides of the pie and the fill pattern being applied can be modified. Gradient patterns can be set using the type attribute. Only gradient patterns may be used. A type value of NONE suppresses the highlights. The element start sets the beginning color of the gradient; the element stop sets the end color of the gradient. Color values are interpolated between the two. The element angle specifies the number of degrees from zero from which the initial gradient color begins at the edge of the pie. The element angle can be set to values greater than 360 degrees. The element gap specifies the size of the gap between the edge of the highlight and the associated edge of the pie. When the value for gap is specified as a whole number, it sets the distance between the edge of the highlight and the edge of the pie in pixels. When set to a fractional number between 0 and 1, it sets the gap to a percentage of the diameter of the pie. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point. The element extent controls the width of the highlight. When the value for extent is specified using a whole number, it sets the diameter of the highlight in pixels. If extent is set to -1, PieHighlights fills the diameter available after taking into account the value of the gap attribute specified previously. If extent is set to a fractional number between 0 and 1, PieHighlights sets the extent of the highlight to that percentage of the diameter of the pie available. 

   example: PieHighlights = (GRADIENTRADIAL,yellow,white,270,15,-1);
Type NONE no pattern, do default fill, if any
  Gradients
  GRADIENTANGLED top left to bottom right style gradient
  GRADIENTVERTICAL bottom to top style gradient
  GRADIENTHORIZONTAL left to right style gradient
  GRADIENTFDIAG top right to bottom left style gradient
  GRADIENTBDIAG top left to bottom right style gradient
  GRADIENTRADIAL radial style gradient
  GRADIENTCENTERHORIZONTAL center out horizontal gradient
  GRADIENTCENTERVERTICAL center out vertical gradient
start This color is used in the following ways:
- Starting color for gradients
  
stop

This color is used in the following ways:
- Stopping color for gradients

 

 

PieSize

	PieSize = (minWidth, minHeight, maxWidth, maxHeight);
The PieSize parameter can be used to set minimum and maximum sizes for the actual pie in a pie chart. This allows programmers to guarantee that the pie portion will always be the same size regardless of the length of the strings in the legend or slice labels. PieSize has the following interaction with PieSquare; if the minimum or maximum dimensions specified are not square, and PieSquare is ON, then the pie will be inscribed in a square with a dimension that ranges from the smallest of the minimum values to the smallest of the maximum values.

 

PieSpotlights

	PieSpotlights = (start,stop,center,centeroffsetx,centeroffsety,focusoffsetx,focusoffsety,radius),...;

Adds or overlays a color fill over one or more existing fill patterns to produce multiple layered color effects. The spotlight “illuminates” the pie in the Pie or MultiPie chart. The center of the spotlight and its focus can be adjusted independently by adjusting offsets from the pie chart center point. The elements centeroffsetx and centeroffsety set the x and y-coordinates of the center of the spotlight as an offset of the pie chart center point. When set to whole numbers, centeroffsetx and centeroffsety specify the number of pixels to offset from the chart center point. When set to fractional values (between 0 and 1), they are interpreted as percentages of the diameter of the pie. Percentage values are written using a decimal point (e.g. “0.05” and “0.50” represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to “escape” the decimal point. The element focusoffsetx is the offset from the pie chart center which defines the x-coordinate of the focus point of the spotlight. The element focusoffsety is the offset from the pie chart center which defines the y-coordinate of the focus point of the spotlight. When set to whole numbers, focusoffsetx and focusoffsety specify the offset from the center in pixels. When set to fractional values (between 0 and 1), they are interpreted as percentages of the diameter of the pie. The element radius sets the size of the spotlight, from its center to its edge. When set to a whole number, it sets the size of the radius in pixels; when set to a fractional value, it sets the radial diameter of the spotlight based upon that percentage of the diameter of the pie. 

   example: PieSpotlights = (blue_0,blue_105,RIGHT,1,1,120,-120,440);

 

  start  Start specifies the first of the two colors which will be interpolated to produce a gradiant spotlight.
  stop  Stop specifies the second of two colors which will be interpolated to produce a gradiant spotlight.
  center  Center specifies the position around of the center of the chart where the spotlight center will be placed. The following values are supported:
  • RIGHT - Offsets the center point of the spotlight to the right of the center point of the chart.
  • LEFT - Offsets the center point to the left.
  • TOP - Offsets the center point to the top.
  • BOTTOM - Offsets the center point to the bottom.
  • CENTER - Uses the chart center point for the spotlight center point.
  • TOPRIGHT - Offsets the center point of the spotlight to the top right.
  • TOPLEFT - Offsets the center point of the spotlight to the top left.
  • BOTTOMRIGHT - Offsets the center point of the spotlight to the bottom right.
  • BOTTOMLEFT - Offsets the center point of the spotlight to the bottom left.
  centeroffsetx  Centeroffsetx specifies the x-coordinate offset for the spotlight center.
  centeroffsety  Centeroffsety specifies the y-coordinate offset for the spotlight center.
  focusoffsetx  Focusoffsetx specifies the x-coordinate offset for the center of the spotlight's focus.
  focusoffsety  Focusoffsety specifies the y-coordinate offset for the center of the spotlight's focus.
  radius  Radius specifies the length of the radius of the spotlight from the center of the spotlight

 

PieSquare

	PieSquare = Switch;

PieSquare, when turned on, tells the pie chart that the appearance of the pie chart should be kept as high as it is wide. This prevents the pie shape from becoming too wide or too narrow because of titles, labels, legends, or other chart features.

Example:
           PieSquare = ON;
           PieSquare = OFF;

The default value = ON.

 

Interactive Processing

So that users can select the best view of piechart data, the following interactive features are supported:

Button User Action Result
Left Mouse Button Drag Mouse Around Circle The entire piechart, including slice labels, will be rotated as the mouse is dragged around the circle. The rotation will stop when the mouse button is released.
Right Mouse Button Drag Mouse In Slice The selected slice will be moved in or out radially (i.e., exploded) as the mouse is moved. The movement will stop when the mouse cursor is no longer inside of the slice or when the right mouse button is released.
Left Key
Up Key 		Press Left or Up Key The piechart will be rotated 5 degrees in the counterclockwise direction. If the SHIFT key is also held down, a 30 degree rotation will be performed.
Right Key
Down Key 		Press Right or Down Key The piechart will be rotated 5 degrees in the clockwise direction. If the SHIFT key is also held down, a 30 degree rotation will be performed.
PageUp Key Press PageUp Key All slices will be moved out radially by 10 percent. That is, the SlicePos for each slice will be increased by 0.1. Keyboard processing may not work in all browsers.
PageDown Key Press PageDown Key All slices will be moved in radially by 10 percent. That is, the SlicePos for each slice will be decreased by 0.1. Keyboard processing may not work in all browsers.