INQUIRE_TEXT_EXTENT(3G)

NAME

inquire_text_extent − return the coordinates of the text extent rectangle.

SYNOPSIS

C SYNTAX

void inquire_text_extent(fildes,string,xform,extent)
int fildes,xform;
char *string;
float extent[12];

FORTRAN77 SYNTAX

        subroutine inquire_text_extent(fildes,string,xform,extent)
        integer*4 fildes,xform
        character*(*) string
        real extent(12)

PASCAL SYNTAX

procedure inquire_text_extent(fildes:integer; str:string255; xform:integer; var extent:text_extent_array);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
string
an ASCII string of characters
xform
an enumerated value in (VDC_TEXT, WORLD_COORDINATE_TEXT, TOS_TEXT) specifying the type of transformation to perform on the font coordinates.

OUTPUT PARAMETER

extent
return array for the coordinates of the concatenation point and the text extent rectangle.

DISCUSSION

The inquire_text_extent procedure pseudo executes the string and returns the following values in the extent array:

extent [0] - concatenation point (x coordinate)
extent [1] - concatenation point (y coordinate)
extent [2] - concatenation point (z coordinate)
extent [3] - lower left corner (x coordinate)
extent [4] - lower left corner (y coordinate)
extent [5] - lower left corner (z coordinate)
extent [6] - upper left corner (x coordinate)
extent [7] - upper left corner (y coordinate)
extent [8] - upper left corner (z coordinate)
extent [9] - upper right corner (x coordinate)
extent [10] - upper right corner (y coordinate)
extent [11] - upper right corner (z coordinate)

For VDC_TEXT the returned coordinates are in Virtual Device Coordinate values.

For USER_UNIT_TEXT the returned values are in World Coordinate values.

For TOS_TEXT the returned values are Text Coordinate values.

Museum

Related Articles