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_height()
vst_point()                                                             VDI

Syntax

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

Function      vst_point() sets the height of the current text face in
              points (1/72 inch).

Opcode        107

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. point specifies
              a valid point size to set the current text face to. This
              means an appropriate bitmap font or a point size enumerated
              in the 'EXTEND.SYS' file. 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] = 107;
              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_point() returns the point size actually set.

Comments      If a point size which doesn't exist for the current face is
              selected, the next valid size down is selected.

See Also      vst_arbpt(), vst_height()

Group         VDI Attributes