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.15  v_getoutline                                              TOS

 Name:         »Get character outline« - Calculate outline of a vector 
               character.

 Opcode:       243

 Syntax:       void v_getoutline ( int16_t handle, int16_t ch, int16_t 
               *xyarray, int8_t *bezarray, int16_t maxpts, int16_t 
               *count );

 Description:  The call v_getoutline uses Bezier curves to create the 
               outline that belongs to a given vector character. The 
               following apply:

                Parameter  Meaning

                handle     Workstation identifier
                ch         Character whose outline is to be calculated
                xyarray    Coordinate buffer
                bezarray   Vertice-type buffer (jump, bez)
                maxpts     Maximum number of vertices
                count      Number of vertices

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

               If one wants to use the information from this function 
               as a vector graphic, say as a part of a metafile, then 
               it is recommended that a large text height is set 
               before the call; otherwise the quality of the returned 
               Bezier may be quite poor, as the internal presentation 
               in 1/65536 pixels is rounded off to integer fixed point 
               pixels, i.e. 16 bits will be lost. The text height 
               should be oriented to the raster resolution of the font 
               outline, as returned by the function vqt_fontheader.

 Return value: The function does not return a result.

 Availability: As of SpeedoGDOS 4.00 and from NVDI 3.00 on.

 Group:        Control functions

 See Also:     Binding   v_get_outline   v_killoutline   SpeedoGDOS 
               NVDI   fix31