Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.5.29  v_ftext_offset                                             TOS

 Name:         »Outline font text offset« - Output an 8-bit ASCII 
               outline text, using character offset vectors.

 Opcode:       241

 Syntax:       void v_ftext_offset ( int16_t handle, int16_t x, 
               int16_t y, int8_t *string, int16_t *offset );

 Description:  The call v_ftext_offset is a variant of v_ftext for use 
               under SpeedoGDOS, outputting an 8-bit ASCII character 
               string to a workstation; one can specify an offset 
               vector for each character.

                Parameter     Meaning

                handle        Workstation identifier
                x             X-coordinate, and
                y             Y-coordinate of starting position
                string        Pointer to the string (NULL-terminated)
                offset[0]     X-offset of the first character
                offset[1]     Y-offset of the first character
                ...
                ...
                offset[2n-2]  X-offset of the last character
                offset[2n-1]  Y-offset of the last character

               The parameter offset permits setting your own offsets 
               in place of the character values calculated by the 
               system; this permits substantially better control for 
               positioning the characters on the output device.

               Notes: The text attributes as well as the kerning 
               settings will be respected.

               To output 16-bit Speedo character strings, you can use 
               v_ftext_offset16.

 Return value: The function does not return a result.

 Availability: As of SpeedoGDOS 4.00, and NVDI 3.00 onwards.

 Group:        Output functions

 See Also:     Binding   v_gtext   v_ftext   SpeedoGDOS   NVDI