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-File8.20.3  fnts_create                                                TOS

 Name:         »Font Selector Create« - initialisiert die 
               Zeichensatzauswahl.

 AES-Nummer:   180

 Deklaration:  FNT_DIALOG *fnts_create ( int16_t vdi_handle, int16_t 
               no_fonts, int16_t font_flags, int16_t dialog_flags, 
               int8_t *sample, int8_t *opt_button );

 Beschreibung: Die Funktion initialisiert die Zeichensatzauswahl. Es 
               gilt:

                Parameter   Bedeutung

                vdi_handle  Kennung der benutzten Workstation
                no_fonts    Anzahl der verfügbaren Fonts (oder 0)
                font_flags  Bitvektor der anzuzeigenden Fonts
                             Bit-0  =  Bitmapfonts anzeigen ( FNTS_BTMP = 1) 
                             Bit-1  =  Vektorfonts anzeigen ( FNTS_OUTL = 2) 
                             Bit-2  =  äquidistante Fonts zeigen ( FNTS_MONO = 4) 
                             Bit-3  =  proportionale Fonts zeigen ( FNTS_PROP = 8) 

                dialog_flags Aussehen des Dialogs
                            FNTS_3D (1) = Auswahl im 3D-Look anzeigen
                sample      String für Beispieltext
                opt_button  Zeiger auf einen String für einen 
                            optionalen Button, oder NULL

               Hinweis: Falls no_fonts den Wert 0 besitzt, wird die 
               Funktion vst_load_fonts mit vdi_handle aufgerufen. 
               Anderenfalls wird davon ausgegangen, daß no_fonts die 
               Anzahl aller über vdi_handle verfügbaren Fonts ist, 
               d.h. die Anzahl aller Systemfonts zuzüglich der Anzahl 
               der nachgeladenen Fonts.

               Da diese Funktion je nach Systemkonfiguration durchaus 
               1 Sekunde (oder mehr) benötigt, sollte man sie am 
               Programmstart und nicht erst direkt vor der Anzeige der 
               Fontauswahl aufrufen.

               Achtung: Der Fontselektor verändert die Attribute der 
               mit vdi_handle bezeichneten Workstation. Wenn man die 
               bei fnts_create übergebene Workstation noch für andere 
               Zwecke benutzen möchte, müssen auf jeden Fall die 
               Attribute vorher gesetzt werden, da sie evtl. 
               zwischenzeitlich vom Fontselektor geändert wurden.

 Ergebnis:     Die Funktion liefert einen Zeiger auf die 
               Verwaltungsstruktur der Zeichensätze zurück.

 Verfügbar:    Das Vorhandensein dieser Funktion kann per appl_getinfo 
               (Opcode 7) festgestellt werden.

 Gruppe:       Zeichensatzauswahl

 Querverweis:  Binding   fnts_open   fnts_close   xFSL-Schnittstelle