Syntax

[C/C++:]
void ggSetPieChartBoxType(int type, int fill, int line);

[F90:]
subroutine ggSetPieChartBoxType(type, fill, line)
integer, intent(in) :: type, fill, line

Arguments

type
Pie chart internal annotation box type

= GNONE

No filling/masking and no boxes

= GFILLED

Filling/masking done but no boxes drawn

= GBOXED

No filling/masking but box outlines are drawn

GFILLED and GBOXED can be combined by an OR operation to produce a box which is both filled and outlined.

fill
Fill style of Pie Chart annotation boxes for types GFILLED and GBOXED

< -1	Specifies box is masked only

=  GHOLLOW

Specifies boundary only

=  GSOLID

Specifies a solid fill

=  GFINEHORIZONTAL

}

=  GFINEVERTICAL

}

=  GFINELEFTDIAGONAL

}

=  GFINERIGHTDIAGONAL

}

=  GFINEHORIZONTALGRID

}

=  GFINEDIAGONALGRID

}

=  GFINEHORIZONTALMESH

} Specifies the hatch

=  GFINEDIAGONALMESH

} style index

=  GCOARSEHORIZONTAL

}

=  GCOARSEVERTICAL

}

=  GCOARSELEFTDIAGONAL

}

=  GCOARSERIGHTDIAGONAL

}

=  GCOARSEHORIZONTALGRID

}

=  GCOARSEDIAGONALGRID

}

=  GCOARSEHORIZONTALMESH

}

=  GCOARSEDIAGONALMESH

}

>256	Specifies a solid fill for software fill, or the fill style index for hardware fill

line
Line style to be used for filling boxes for types GFILLED and GBOXED

= GCURRENT

Specifies the current line style

= 1 to 256

Specifies the line style index

>256	Specifies the current line style

The value of line is irrelevant where fill has a value less than -1

Description

The routine ggSetPieChartBoxType() controls the form of the internal annotation boxes (where ggSetPieChartAnnotation() has been set to type GINTERNAL) for the complete Pie Chart routines ggPlotPieChart() and ggAddPieChartSegment(). ggSetPieChartBoxType() affects the annotation boxes of all the label types wherever they are placed within the segment area.

The value of type determines whether the annotation box is filled/masked, and whether a box outline drawn. If output, the box outline is drawn in the current GINO colour. If the box area is not filled/masked (type = GNONE) then the annotation is displayed over any segment filling. If type = GFILLED, the box area is filled in the specified fill and line style, except if fill < -1, where the box area is left unfilled.

If the value of type is out or range, a warning message is output and the default value is used.

The routine ggRestorePieChartSettings() resets the box type and fill styles back to their defaults.

See Also

ggSetPieChartBoxType Usage
ggSetPieChartAnnotation
ggPlotPieChart
ggRestorePieChartSettings
ggAddPieChartSegment

---