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.45  vqt_fontheader                                             TOS

 Name:         »Inquire Speedo header information« - Informationen 
               über einen Zeichensatz ermitteln

 VDI-Nummer:   232

 Deklaration:  void vqt_fontheader ( int16_t handle, int8_t *buffer, 
               int8_t *tdf_name );

 Beschreibung: Die Funktion kopiert den Header des eingestellten 
               Speedo-Fonts in einen Puffer, und liefert wenn möglich 
               einen Zeiger auf die zugehörige TDF-Datei. Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                buffer     aufnehmender Puffer
                tdf_name   aufnehmender Zugriffspfad auf die 
                           entsprechende TDF-Datei

               Hinweis: Der aufnehmende Puffer sollte eine Größe von 
               ca. 1 Kbyte besitzen, da die Länge des Speedo- 
               Fontheaders vom jeweiligen Zeichensatz und möglichen 
               Formaterweiterungen abhängt.

               Für andere Zeichensatzformate (Beispiel: TrueType) wird 
               versucht, den Header nachzubilden.

               Es sollte beachtet werden, daß für jeden Aufruf dieser 
               Funktion mehrfach auf die Festplatte zugegriffen werden 
               muß; - bei vielen installierten Zeichensätzen kann dies 
               einige Sekunden dauern. Daher sollte man den häufigen 
               Aufruf der Funktion vermeiden, oder wichtige Angaben 
               selbst speichern, und beim Programmstart laden.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    ab SpeedoGDOS 4.00 und ab NVDI 3.00

 Gruppe:       Auskunftsfunktionen

 Querverweis:  Binding   vqt_fontinfo   Aufbau des Fontheaders