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.
Dekl.: COLOR_TAB *v_create_ctab( int16 handle, int32 color_space, uint32 px_format ) Aufruf: ctab = v_create_ctab( handle, CSPACE_RGB, px_format ); Variable Belegung Bedeutung Eingaben: contrl[0] 206 contrl[1] 0 Einträge in ptsin contrl[3] 4 Einträge in intin contrl[5] 8 v_create_ctab contrl[6] handle intin[0-1] color_space Farbraum (z.Zt. nur CSPACE_RGB) intin[2-3] px_format Pixelformat (nur die unteren 8 Bit werden ausgewertet, d.h. Bits pro Pixel) Ausgaben: contrl[2] 0 Einträge in ptsout contrl[4] 2 Einträge in intout intout[0-1] ctab Zeiger auf Farbtabelle