Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevqt_f_extent()
vqt_advance()
vqt_width()
vqt_extent()                                                            VDI

Syntax

VOID vqt_extent( handle, str, pts )
WORD handle;
char *str;
WORD *pts;

Function      vqt_extent() returns the pixel extent of a string of text.

Opcode        116

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. str points to
              a text string to return extent information for. pts points to
              an array of 8 WORDs which will be filled in as follows:



              pts[x]    Meaning

                0       X coordinate of point 1.

                1       Y coordinate of point 1.

                2       X coordinate of point 2.

                3       Y coordinate of point 2.

                4       X coordinate of point 3.

                5       Y coordinate of point 3.

                6       X coordinate of point 4.

                7       Y coordinate of point 4.

Binding       WORD i = 0;

              while(intin[i++] = (WORD)*str++);

              contrl[0] = 116;
              contrl[1] = 0;
              contrl[3] = --i;
              contrl[6] = handle;

              vdi();

              pts[0] = ptsout[0];
              pts[1] = ptsout[1];
              pts[2] = ptsout[2];
              pts[3] = ptsout[3];
              pts[4] = ptsout[4];
              pts[5] = ptsout[5];
              pts[6] = ptsout[6];
              pts[7] = ptsout[7];

Comments      This function will also output correct bounding information
              for rotated text. It is recommended that vqt_f_extent() be
              used for outline fonts as it takes special factors into
              consideration which makes its output more accurate.

See Also      vqt_f_extent(), vqt_advance(), vqt_width()

Group         VDI Inquire