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

Syntax

VOID v_ftext_offset( handle, x, y, wstr, wstrlen, offset )
WORD handle, x, y;
WORD *wstr;
WORD wstrlen;
WORD *offset;

Function      v_ftext_offset16() is a variant binding of v_ftext_offset()
              which allows 16-bit Speedo character strings to be output
              rather than 8-bit ASCII codes.

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 wstr.

Binding       WORD i;

              for( i = 0;i < wstrlen; i++)
               intin[i] = wstr[i];

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

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

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

              vdi();

Comments      This function should only be used when vst_charmap() has
              been used to indicate that WORD sized Speedo character
              indexes should be recognized rather than 8-bit ASCII. The
              text contained in wstr (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.

Caveats       Current versions of SpeedoGDOS become confused when the
              space character ( index 0) is encountered in the string. It
              is suggested that one of the three space characters (of
              varying widths) at indexes 560-562 be used instead.

See Also      v_ftext16(), v_ftext_offset()

Group         VDI SpeedoGDOS