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.23  vq_ctab                                                    TOS

 Name:         »Inquire Current Color Table« - Farbtabelle erfragen

 VDI-Nummer:   206 (Unterfunktion 0)

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

 Beschreibung: Diese Funktion kopiert die aktuelle Farbtabelle, die 
               das VDI unter dem übergebenen handle verwaltet, 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 unterstü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         Farbtabellen

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

 Verfügbar:    ab NVDI 5.00

 Gruppe:       Farbtabellenfunktionen

 Querverweis:  Binding