Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.10.15  v_getoutline                                              TOS

 Name:         »Get character outline« - Outline eines Zeichens 
               berechnen.

 VDI-Nummer:   243

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

 Beschreibung: Die Funktion erzeugt das Outline, welches zu einem 
               bestimmten Zeichen gehört. Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                ch         Zeichen, dessen Outline berechnet werden 
                           soll
                xyarray    Puffer für die Koordinaten
                bezarray   Puffer für Punktinformationen
                maxpts     maximal auszugebende Punktzahl
                count      Anzahl der auszugebenden Punkte

               Hinweis: Die gelieferten Werte können direkt an die 
               Ausgabefunktion für Bezier-Splines (v_bez, v_bez_fill) 
               weitergereicht werden.

               Wenn man die Informationen dieser Funktion z.B. als 
               Vektorgrafik benutzen möchte, so empfiehlt es sich, vor 
               dem Aufruf eine große Texthöhe einzustellen. 
               Andernfalls ist die Qualität des zurückgelieferten 
               Beziers recht mager, da von der internen Darstellung in 
               1/65536 Pixeln auf Pixel gerundet wird, d.h. 16 Bit 
               fallen weg. Die Texthöhe sollte sich an der 
               Rasterauflösung des Fonts orientieren, die auch von der 
               Funktion vqt_fontheader zurückgeliefert wird.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    ab SpeedoGDOS 4.00 und an NVDI 3.00

 Gruppe:       Kontrollfunktionen

 Querverweis:  Binding   v_get_outline   v_killoutline   SpeedoGDOS 
               NVDI   fix31