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-Filev_ftext()
v_ftext_offset()
vst_color()
vst_effects()
vst_alignment()
vst_height()
vst_point()
v_gtext()                                                               VDI

Syntax

VOID v_gtext( handle, x, y, str)
WORD handle, x, y;
char *str;

Function      v_gtext() outputs graphic text.

Opcode        8

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. x and y specify
              the starting coordinates of the text (see vst_alignment() ).
              str is a pointer to a NULL-terminated character string to
              print.

Binding       WORD i = 0;

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

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

              ptsin[0] = x;
              ptsin[1] = y;

              vdi();

Comments      The text contained in str (including its NULL byte) should
              not exceed the maximum allowable size of the intin array (as
              indicated in the work_out array) or the size of the intin
              array allocated by your compiler. Using this function to
              output outline text with FSMGDOS is possible to remain
              backward-compatible but not recommended as it will introduce
              small errors as spacing remainders are lost.

See Also      v_ftext(), v_ftext_offset(), vst_color(), vst_effects(),
              vst_alignment(), vst_height(), vst_point()

Group         VDI Output