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_ftext16()
v_ftext_offset()
v_ftext_offset16()
v_gtext()
VDI GDOS
VDI Attributes
v_ftext()                                                               VDI

Syntax

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

Function      v_ftext() outputs outline text taking spacing remainders
              into consideration.

Opcode        241

Availability  Available only with FSMGDOS or SpeedoGDOS.

Parameters    handle specifies a valid workstation handle. x and y specify
              the starting coordinate of the NULL-terminated text string
              (see vst_alignment() ) pointed to by str to print.

Binding       WORD i = 0;

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

              contrl[0] = 241;
              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. To output 16-bit Speedo
              character indexes, use v_ftext16(). This function produces
              output more properly spaced than with v_gtext() because it
              takes the remainder amounts from vqt_f_extent() into
              consideration.

See Also      v_ftext16(), v_ftext_offset(), v_ftext_offset16(), v_gtext(),
              VDI GDOS, VDI Attributes

Group         VDI FSMGDOS