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 ).
Dekl.: int16 vq_ctab( int16 handle, int32 ctab_length, COLOR_TAB *ctab );
Aufruf: vq_ctab( handle, CTAB_LENGTH, ctab );
Variable Belegung Bedeutung
Eingaben:
contrl[0] 206
contrl[1] 0 Einträge in ptsin
contrl[3] 2 Einträge in intin
contrl[5] 0 0: vq_ctab
contrl[6] handle
intin[0/1] ctab_length Länge des Speicherbereichs,
auf den ctab zeigt
intout zeigt auf ctab
Ausgaben:
contrl[2] 0 Einträge in ptsout
contrl[4] variabel Einträge in intout
intout[0-n] ctab kopierte Farbtabelle