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.10.17  v_get_outline                                             TOS

 Name:         »Get character outline« - Calculate outline of a 
               character (improved version).

 Opcode:       243 (Sub-Opcode 1)

 Syntax:       int16_t v_get_outline ( int16_t handle, uint16_t index, 
               uint16_t x_offset, uint16_t y_offset, int16_t *xyarray, 
               uint8_t *bezarray, int16_t max_pts );

 Description:  The call v_get_outline creates the outline that belongs 
               to a given character. This improved version of 
               v_getoutline:

                  . Works the same way for any font format
                  . Accepts offsets for X- and Y-coordinates
                  . Also works with rotation
                  . Respects vertical alignment
                  . Respects horizontal alignment

                Parameter  Meaning

                handle     Workstation identifier
                index      Character index
                x_offset   Is added to all X-coordinates in xyarray
                y_offset   Is added to all Y-coordinates in xyarray
                xyarray    Buffer for the coordinates
                bezarray   Buffer for vertice information
                max_pts    Maximum number of vertices to be output

               Note 1: The returned values can be passed directly to 
               the output function for Bezier splines (v_bez, 
               v_bez_fill).

               Note 2: With the previous v_getoutline (old Speedo 
               function), rotation did not work at all, and alignment 
               was ignored as well. Furthermore, with Speedo fonts the 
               Y-coordinate 0 corresponded to the top coordinate used 
               in the character (so, depending on the character, was 
               positioned somewhere within the character cell), while 
               with Postscript and TrueType fonts the Y-coordinate 0 
               always corresponded to the top edge of the character 
               cell.

 Return value: The function returns the number of vertices output.

 Availability: As of NVDI 5.00.

 Group:        Control functions

 See Also:     Binding   v_getoutline   v_killoutline   SpeedoGDOS 
               NVDI   fix31