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.4.6.99  vs_color                                                 TOS

 Name:         »Set Color Representation« - legt die Farbintensität 
               fest.

 VDI-Nummer:   14

 Deklaration:  void vs_color ( int16_t handle, int16_t index, int16_t 
               *rgb_in );

 Beschreibung: Die Funktion wählt die Farbintensität zu den einzelnen 
               Farbregistern. Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                index      Farbnummer
                rgb_in[0]  Rotanteil in Promille
                rgb_in[1]  Grünanteil in Promille
                rgb_in[2]  Blauanteil in Promille

               Da nicht jedes Ausgabegerät über 1000 mögliche 
               Farbabstufungen verfügen muß, können für verschiedene 
               Eingabeintensitäten der RGB-Farben, die tatsächlich 
               eingestellten Intensitäten gleich sein.

               Hinweis: Die Funktion kann nur benutzt werden, falls 
               eine Lookup-Table Unterstützung vorhanden ist. Sollte 
               eine ungültige Farbnummer übergeben werden, wird der 
               nächste erreichbare Wert angenommen.

               Bei Geräten mit einer CLUT (Grafiksysteme bis 8 Planes 
               d.h. 256 Farben) wirken sich die Einstellungen sofort 
               auf alle Punkte aus, die bisher auf dem Bildschirm mit 
               dem Farbindex index gezeichnet wurden.

               Wichtig: Aus diesem Grund sollten die ersten 16 
               Farbnummern nicht verändert werden, da diese vom AES 
               benutzt werden.

               Bei mehr als 256 gleichzeitig darstellbaren Farben 
               benutzen Grafiksysteme in der Regel keine CLUT sondern 
               eine direkte RGB-Zuordnung pro Pixel. Die einzelnen 
               Pixel enthalten dann statt eines Farbindex einen 
               direkten RGB-Wert (z.B. je 8 Bit für R,G und B und 8 
               Bit Overlay). Bei einer solchen Organisation stellt das 
               VDI pro Workstation 256 lokale Farbstifte und eine 
               Pseudopalette zur Verfügung, für die man mit vs_color() 
               die Farbwerte setzen kann. Eine Änderung wirkt sich 
               also erst dann aus, wenn man wieder mit dem Farbstift 
               zeichnet und wirkt sich immer nur auf die mit handle 
               bezeichnete Workstation aus.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all devices.

 Gruppe:       übergeordnete Attribute

 Querverweis:  Binding   v_pline   v_pmarker   v_gtext   v_fillarea 
               v_cellarray   v_contourfill   vr_recfl   v_bar   v_arc 
                 v_pieslice   v_circle   v_ellarc   v_ellpie 
               v_ellipse   v_rbox   v_rfbox   v_justified   vq_color 
               vq_scrninfo