Syntax
[C/C++:]
void gDisplayStrPolylineBy2D(int npts, GPOINT *points, char string[]);
void gDisplayStrPolylineTo2D(int npts, GPOINT *points, char string[]);
[F90:]
subroutine gDisplayStrPolylineBy2D(npts, points, string)
subroutine gDisplayStrPolylineTo2D(npts, points, string)
integer, intent(in) :: npts
type (GPOINT), intent(in) :: points(*)
character*(*), intent(in) :: string
Arguments
npts
Number of vector increments specified
points
Array of points specifying a series of either relative or absolute 2D positions, which define a polyline along which the string will be drawn
string
Character string
Description
The routines gDisplayStrPolylineBy2D() and gDisplayStrPolylineTo2D() display a character string along a polyline represented by the points contained in the array
points by adjusting the angle of each character in the string. The polyline should be defined as a series of either relative or absolute points depending on the routine used. The relative points used by gDisplayStrPolylineBy2D() start at the current position and pass through
npts vector increments.
Strings should be terminated by *. otherwise the number of characters is limited to the total length of
string up to a maximum of 256 characters. For example, if string is declared as char [10] then the string will always be terminated after 10 characters, if no intervening *. is encountered.
The characters are drawn subject to the font representation, font weight, character size, italics and underline settings. If transformations are switched on the string is output using transformed characters so that the string follows the transformed polyline.
The string is justified on the polyline according to the current setting of gSetStrJustify(). The character string may contain any of the GINO escape sequences described under gDisplayStr(). If the length of the character string is longer than the length of the polyline, the string is truncated.
See Also
gDisplayStrPolylineBy2D UsagegSetStrJustifygDisplayStr
