SET PIE CHART ANNOTATION POSITION
CALL SEQUENCE
void tset_piech_annot_pos (strid, intext, posit)
INPUT PARAMETERS
Pint strid;
Tpie_annot_flag intext;
Tpie_annot_position posit;
ARGUMENTS
- strid
- Identifier of the structure of the pie chart with the following
attributes:
- intext
- Attributes for interior or exterior annotation:
- TANNOT_INTERNAL
- Interior annotation.
- TANNOT_EXTERNAL
- Exterior annotation.
- posit
- Position of text in relation to slice
- TANNOT_POS_RADIAL
- Written radially
- TANNOT_POS_HORIZONTAL
- Written horizontally.
- TANNOT_POS_HORIZONTAL_ALIGNED
- Aligned horizontally.
- TANNOT_POS_VERTICAL_ALIGNED
- Aligned vertically.
- TANNOT_POS_SQUARE_ALIGNED
- Aligned horizontally and vertically.
EFFECT
This function sets the attributes that defines the manner of writing annotation
on the interior or exterior of a pie chart identified by strid.
All valid values of posit may be used for exterior annotation, but
only radial (TANNOT_POS_RADIAL) and horizontal
(TANNOT_POS_HORIZONTAL) writing is permitted for interior annotation.
If this function is not called, both interior and exterior annotation is
written horizontally (TANNOT_POS_HORIZONTAL).
Below is a description of the manner in which external annotation position is
calculated according to the value of posit. It is given that d1, d2
and d3 are the current annotation distance attribute values, defined with
tset_piech_annot_dist.
TANNOT_POS_RADIAL
The annotation is written parallel to the bisector of each slice. The point
P1, the inner-most point of the annotation, is on the bisector at the distance
d1+d2+d3 from the center of the pie chart. The arrow runs from the point P1
along the bisector until it reaches a point P2 at a distance of d1 from the
center of the pie chart.
TANNOT_POS_HORIZONTAL
The annotation is written horizontally with its origin at a horizontal
displacement from the bisector of the slice. The point P3, the inner-most
point of the arrow, is on the bisector at a distance d1 from the center of the
pie chart. The point P2, the turning point of the arrow, is on the bisector at
a distance d1+d2 from the center of the pie chart. The point P1, the origin of
the arrow and the origin of the annotation, is at the same height as P2, but
displaced horizontally by a distance d3.
TANNOT_POS_HORIZONTAL_ALIGNED
All annotation is aligned on a horizontal line either above or below
the pie chart. The point P3, the inner-most point of the arrow, is on the
bisector at a distance d1 from the center of the pie chart. The point P2, the
turning point of the arrow, is on the bisector at a distance d1+d2 from the
center of the pie chart. The point P1, the origin of the arrow and the origin
of the annotation, has the same abscissa as the point P2, but is at a height
d1+d2+d3 from the center of the pie chart.
TANNOT_POS_VERTICAL_ALIGNED
All annotation is aligned on a vertical line either to the left of or
to the right of the pie chart. The point P3, the inner-most point of the
arrow, is on the bisector at a distance d1 from the center of the pie chart.
The point P2, the turning point of the arrow, is on the bisector at a distance
d1+d2 from the center of the pie chart. The point P1, the origin of the arrow
and the origin of the annotation, is at the same height as the point P2, but is
displaced horizontally a distance d1+d2+d3 from the center of the pie chart.
TANNOT_POS_SQUARE_ALIGNED
The annotation is aligned on an alignment rectangle that is centered on the
same point as the pie chart. The alignment rectangle has a half-side length of
d1+d2+d3. This mode is a combination of the two preceding modes. The
annotation is aligned, depending on its associated slice's position relative to
the pie chart, either along one of the horizontal sides or along one of the
vertical sides of the alignment rectangle.
