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.6.71  vq_color                                                   TOS

 Name:         »Inquire Color Representation« - ermittelt die 
               Intensität einer Farbe.

 VDI-Nummer:   26

 Deklaration:  int16_t vq_color ( int16_t handle, int16_t color_index, 
               int16_t set_flag, int16_t *rgb );

 Beschreibung: Die Funktion ermittelt die eingestellten 
               Farbintensitäten der Farbpalette. Es gilt:

                Parameter    Bedeutung

                handle       Kennung der Workstation
                color_index  zu erfragendes Farbregister
                set_flag     Flag für Farbintensität
                              0 = gesetzte Intensität
                              1 = tatsächliche Intensität
                rgb_in[0]    Rotanteil   (in Promille, 0-1000)
                rgb_in[1]    Grünanteil  (in Promille, 0-1000)
                rgb_in[2]    Blaunanteil (in Promille, 0-1000)

               Hinweis: Gesetzte und tatsächliche Farbintensität 
               können bei Systemen mit einer CLUT voneinander 
               abweichen, wenn die Anzahl der möglichen 
               Farbabstufungen zu klein ist.

               Beispiel: Verfügt ein Monitor nur über zwei 
               Intensitäten, so teilt sich der Bereich in die 
               Teilbereiche 0..500 und 501..1000. Die tatsächliche 
               Intensität kann aber nur 0 oder 1000 sein; egal welche 
               Zahl aus dem Bereich von 501 bis 1000 gewählt wird, es 
               wird immer die Intensität 1000 gesetzt. Daher kann z.B. 
               die gesetzte Intensität den Wert 623 und die 
               tatsächliche den Wert 1000 haben.

               Bei Direct-RGB (keine CLUT) wird meistens die 
               tatsächlich eingestellte Intensität auch als die vom 
               Anwender übergebene Intensität zurückgeliefert, da die 
               Anzahl der Abstufungen ausreichend groß ist.

 Ergebnis:     Die Funktion liefert -1, wenn der Farbindex außerhalb 
               der Grenzen ist.

 Verfügbar:    Alle Treiber.

 Gruppe:       Auskunftsfunktionen

 Querverweis:  Binding   vs_color   vs_color2