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_point()
vst_arbpt()
vst_height()                                                            VDI

Syntax

VOID vst_height( handle, height, wchar, hchar, wcell, hcell )
WORD handle, height;
WORD *wchar, *hchar, *wcell, *hcell;

Function      vst_height() sets the height of the current text face (in
              pixels).

Opcode        12

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle.
              height specifies the height (in pixels) at which to render
              text. 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] = 12;
              contrl[1] = 1;
              contrl[3] = 0;
              contrl[6] = handle;

              ptsin[0] = 0;
              ptsin[1] = height; /* Passed in ptsin[1] because of VDI bug. */

              vdi();

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

Comments      vst_height() works on both bitmap and outline fonts. The
              font will be scaled to fit within the height given. This
              doesn't always give good results with bitmap text.

See Also      vst_point(), vst_arbpt()

Group         VDI Attributes