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.6.49  vqt_f_extent                                               TOS

 Name:         »Inquire Outline-Font Text Extent« - ermittelt die 
               Länge eines Strings im Vektor-Zeichensatz.

 VDI-Nummer:   240

 Deklaration:  void vqt_f_extent ( int16_t handle, int8_t *string, 
               int16_t *extent );

 Beschreibung: Die Funktion addiert die Zeichenweiten eines Strings. 
               Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                string     Adresse der Zeichenkette
                extent[0]  x-Koordinate
                extent[1]  y-Koordinate der unteren linken Ecke
                extent[2]  x-Koordinate
                extent[3]  y-Koordinate der unteren rechten Ecke
                extent[4]  x-Koordinate
                extent[5]  y-Koordinate der oberen rechten Ecke
                extent[6]  x-Koordinate
                extent[7]  y-Koordinate der oberen linken Ecke

               Hinweis: Im Gegensatz zu vqt_extent beachtet die 
               Funktion auch etwaige Kerning-Werte.

               Achtung: Diese Funktion liefert nicht das den Text 
               umgebende Rechteck. Sie addiert nur die Schrittweiten 
               und beachtet auch nicht linke oder rechte 
               Zeichenüberhänge. Sie ist im Prinzip nur zur Cursor- 
               Positionierung gedacht. Wer aber mit dieser Funktion 
               die Größe eines neuzuzeichnenden Bildbereiches 
               ermitteln möchte, muß links und rechts 
               sicherheitshalber die Breite des größten Zeichens 
               hinzuaddieren (und die Neigung beachten).

               Vorsicht: Aus Kompatibilitätsgründen verhält sich diese 
               Funktion bei 90, 180 und 270 Grad genauso unsinnig wie 
               das alte vqt_extent - der Bezugspunkt wird geändert!

               Ab NVDI-3 empfiehlt sich stattdessen die Verwendung von 
               vqt_real_extent.

 Ergebnis:     Die Funktion liefert kein Ergebnis zurück.

 Verfügbar:    ab SpeedoGDOS 4.00 und ab NVDI 3.00

 Gruppe:       Auskunftsfunktionen

 Querverweis:  Binding   vqt_extent   SpeedoGDOS   NVDI