Syntax
[C/C++:]
void ggSetPieChartExplosion(int num, int *list, float *factor);
[F90:]
subroutine ggSetPieChartExplosion(num, list, factor)
integer, intent(in) :: num, list(*)
real, intent(in) :: factor(*)
Arguments
num
The number of segments to be drawn as exploded segments (not greater than 50)
|
= 0, |
Lists of indices and explosion factors are ignored and all segments are drawn from the centre |
|
> 0, |
The num segments indexed in array list are drawn with the explosion factors in array factor |
list
Array of dimension
num, giving the indices of the segments to be drawn as exploded segments
factor
Array of dimension
num, defining explosion factors
Description
The routine ggSetPieChartExplosion() defines a list of explosion factors, allowing the selective explosion of Pie Charts sectors. If ggSetPieChartExplosion() is called with
num > 0, the
num segments indexed in the array
list will be exploded in all Pie Charts subsequently drawn by ggPlotPieChart(). For example, if
list contains the values 1, 3 and 4, the first, third and fourth segments drawn will be extracted.
The distance from the centre of the Pie Chart to the inner point of the segment indexed in
list(N) is then
factor(N) * radius, all segments not indexed in
list being drawn from the centre with no explosion factor.
Pie chart radius is automatically adjusted to take account of the explosion factor if the default Pie Chart frame is used. If ggSetPieChartFrame() has been called the user should ensure that exploded sections remain within the available drawing area or current window.
If ggSetPieChartExplosion() is called with
num = 0, the lists of segment indices and explosion factors are deleted and all segments will be drawn from the centre in all Pie Charts subsequently drawn by ggPlotPieChart().
Once called, ggSetPieChartExplosion() remains active until called again with
num = 0.
See Also
ggSetPieChartExplosion UsageggPlotPieChart
