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-Filevst_arbpt()
vst_setsize32()
vst_setsize()                                                           VDI

Syntax

WORD vst_setsize( handle, point, wchar, hchar, wcell, hcell )
WORD handle;
WORD point;
WORD *wchar, *hchar, *wcell, *hcell;

Function      vst_setsize() sets the width of outline characters.

Opcode        252

Availability  Available only with FSMGDOS or SpeedoGDOS.

Parameters    handle specifies a vaid workstation handle. point specifies
              the width of the character in points (1/72 inch). A value
              for point equivalent to the same point size specified in
              vst_arbpt() will result in a correctly proportioned
              character. Upon return, the WORDs pointed to by wchar, hchar,
              wcell, and hcell will be filled in with the width and height
              of the character and the width and height of the character
              cell respectively.

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

              intin[0] = point;

              vdi();

              *wchar = ptsout[0];
              *hchar = ptsout[1];
              *wcell = ptsout[2];
              *hcell = ptsout[3];

              return intout[0];

Return Value  vst_setsize() returns the size actually set.

Comments      This call only works with outline fonts. At the next
              vst_point(), vst_height(), or vst_arbpt() the size will be
              reset to the correct proportions (width in points = height
              in points). To set a fractional size, use vst_setsize32().

See Also      vst_arbpt(), vst_setsize32()

Group         VDI FSMGDOS