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_offset16()
v_ftext()
v_gtext()
v_ftext_offset()                                                        VDI

Syntax

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

Function      v_ftext_offset() is a variant binding of v_ftext() available
              under SpeedoGDOS which allows an offset vector for each
              character to be specified.

Opcode        241

Availability  Available only with SpeedoGDOS.

Parameters    handle specifies a valid workstation handle. x and y give
              the point where the string will be rendered. offset points
              to an array of WORDs which contains one x and y offset value
              for each character in str.

Binding       WORD i = 0;

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

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

              for(j = 0; j < i * 2;j++)
               ptsin[j + 2] = offset[j];

              contrl[0] = 241;
              contrl[1] = i + 1;
              contrl[3] = i;
              contrl[6] = handle;

              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_ftext_offset16().

See Also      v_ftext_offset16(), v_ftext(), v_gtext()

Group         VDI SpeedoGDOS