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()v_ftext_offset16()v_gtext()VDI GDOSVDI Attributesv_ftext16() VDISyntaxVOID v_ftext16( handle, x, y, wstr, wstrlen)
WORD handle, x, y;
WORD *wstr;
WORD wstrlen;
Function v_ftext16() is a variant binding of v_ftext() that outputs
16-bit Speedo character text rather than 8-bit ASCII text.
Opcode 241
Availability Available only with SpeedoGDOS.
Parameters handle specifies a valid workstation handle. x and y specify
the starting coordinate of the location to output text.
wstr points to a NULL-terminated text string composed of
WORD-sized Speedo characters. wstrlen specifies the length
of the text string.
Binding WORD i;
for( i = 0; i < wstrlen; i++)
intin[i] = wstr[i];
contrl[0] = 241;
contrl[1] = 1;
contrl[3] = wstrlen;
contrl[6] = handle;
ptsin[0] = x;
ptsin[1] = y;
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_ftext(), v_ftext_offset(), v_ftext_offset16(), v_gtext(),
VDI GDOS, VDI AttributesGroup VDI SpeedoGDOS