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_advance()
vqt_width()                                                             VDI

Syntax

WORD vqt_width( handle, wch, cellw, left, right )
WORD handle, wch;
WORD *cellw, *left, *right;

Function      vqt_width() returns information regarding the width of
              a character cell.

Opcode        117

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. The lower eight
              bits of wch specify the ASCII character to return width
              information about. The following three values are each WORDs
              which are filled in by the function upon return with
              information about the width of the specified character in
              pixels as illustrated here.



Binding       contrl[0] = 117;
              contrl[1] = 0;
              contrl[3] = 1;
              contrl[6] = handle;

              intin[0] = wch;

              vdi();

              *cellw = ptsout[0];
              *left = ptsout[2];
              *right = ptsout[4];

              return intout[0];

Return Value  vqt_width() returns wch or -1 if an error occurred.

Caveats       vqt_width() does not take into account remainders when
              dealing with outline fonts. It is therefore recommended that
              vqt_advance() be used instead when inquiring about outline
              fonts.

See Also      vqt_advance()

Group         VDI Inquire