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.9.29  vq_dflt_ctab                                               TOS

 Name:         »Inquire Default Color Table« - Systemfarbtabelle 
               zurückliefern

 VDI-Nummer:   206 (Unterfunktion 7)

 Deklaration:  int16_t vq_dflt_ctab( int16_t handle, int32_t 
               ctab_length, COLOR_TAB *ctab );

 Beschreibung: Diese Funktion kopiert die bevorzugte Systemfarbtabelle 
               für die eingestellte Farbanzahl in den Bereich auf den 
               ctab; zeigt. Sollte die Farbtabelle länger als 
               ctab_length sein, wird kein Wert in intout 
               zurückgeliefert, contrl[4] ist dann 0. Eine Farbtabelle 
               enthält maximal 256 Einträge (da das VDI maximal 256 
               Farbstifte untersützt können es nicht mehr sein) und 
               daher ergibt sich die Maximallänge aus der Größe des 
               Header plus 256 * sizeof( COLOR_ENTRY ).

                Parameter    Bedeutung

                handle       Kennung der Workstation
                ctab_length  Länge des Speicherbereichs, auf den ctab 
                             zeigt
                ctab         Speicherbreich in den die Farbtabelle 
                             kopiert wird.

 Ergebnis:     Die Funktion liefert 0 oder 1 für Fehler oder alles in 
               Ordnug.

 Verfügbar:    ab NVDI 5.00

 Gruppe:       Farbtabellenfunktionen

 Querverweis:  Binding