INQUIRE_TEXT_EXTENT(3G)

NAME

inquire_text_extent − return text-extent rectangle coordinates

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

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

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

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

string String of ASCII characters.

xform Enumerated value in VDC_TEXT, WORLD_COORDINATE_TEXT, or TOS_TEXT specifying the type of transformation to perform on the font coordinates.

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

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 WORLD_COORDINATE_TEXT the returned values are in World Coordinate values.

For TOS_TEXT the returned values are defined by the top of the matrix stack.