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.11.1  v_get_pixel                                                TOS

 Name:         »Get Pixel« - liefert den Farbwert eines Pixels.

 VDI-Nummer:   105

 Deklaration:  void v_get_pixel ( int16_t handle, int16_t x, int16_t 
               y, int16_t *pel, int16_t *index );

 Beschreibung: Die Funktion ermittelt den Pixelwert und den Farbindex 
               eines Pixels bei Auflösungen bis zu 256 Farben (8 
               Planes). Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                x          x-Koordinate
                y          y-Koordinate des Pixels
                pel        Wert des Pixels
                index      Farbindex des Pixels

               Hinweis: Unter dem Farbindex versteht man die Nummer, 
               die man bei den Attributfunktionen des VDI angeben 
               kann. Der Pixelwert gibt hingegen den tatsächlichen 
               Inhalt des Bildspeichers wieder.

               Bei HiColor (15- oder 16-Bit) enthält pel den Pixelwert 
               und index ist (meistens) -1, da er nicht einwandfrei 
               zuzuordnen ist. Bei TrueColor enthält pel das Low-Word 
               des Pixelwerts und index das High-Word.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all screen drivers.

 Gruppe:       Rasterfunktionen

 Querverweis:  Binding   Rasterformate