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.5  v_create_ctab                                               TOS

 Name:         »Create Color Table« - Farbtabelle erzeugen

 VDI-Nummer:   206 (Unterfunktion 8)

 Deklaration:  COLOR_TAB *v_create_ctab( int16_t handle, int32_t 
               color_space, uint32_t px_format );

 Beschreibung: Diese Funktion legt eine Farbtabelle im Farbraum 
               color_space für eine Bitmap mit px_format & PX_BITS 
               Bits an. Die Farbtabelle ist mit den Standardfarben für 
               diese Bittiefe initialisiert. Die Applikation kann die 
               Farbtabelle beschreiben und die Farbeinträge ändern. 
               Wenn die Farben geändert werden muß aber über 
               v_get_ctab_id eine neue Kennung angefordert werden und 
               im Strukturelement <map_id> eingetragen werden. 
               Andernfalls würde mit Fehlfarben ausgegeben werden.

               Die Farbtabelle kann nach Gebrauch mit v_delete_ctab 
               freigegeben werden.

                Parameter    Bedeutung

                handle       Kennung der Workstation
                color_space  Farbraum (z.Zt.nur 0 für eingestellten 
                             Farbraum oder CSPACE_RGB)
                px_format    Pixelformat (nur die unteren 8 Bit werden 
                             ausgewertet, d.h. Bits pro Pixel)

 Ergebnis:     Die Funktion liefert den Zeiger auf die Farbtabelle 
               zurück.

 Verfügbar:    ab NVDI 5.00

 Gruppe:       Farbtabellenfunktionen

 Querverweis:  Binding