glPixelMapuiv-Funktion

Die glPixelMapuiv-Funktion richtet Pixelübertragungszuordnungen ein.

Syntax

void WINAPI glPixelMapuiv(
         GLenum  map,
         GLsizei mapsize,
   const GLuint  *values
);

Parameter

map

Ein symbolischer Zuordnungsname. Die zehn Zuordnungen sind wie folgt.

Wert Bedeutung
GL _ PIXEL _ MAP _ I _ TO _ I
Karten Farbindizes zu Farbindizes.
GL _ PIXEL _ MAP _ S _ TO _ S
Karten Schablonenindizes zu Schablonenindizes.
GL _ PIXEL _ MAP _ I _ TO _ R
Karten Farbindizes für rote Komponenten an.
GL _ PIXEL _ MAP _ I _ TO _ G
Karten Farbindizes zu grünen Komponenten.
GL _ PIXEL _ MAP _ I _ TO _ B
Karten Farbindizes zu blauen Komponenten.
GL _ PIXEL _ MAP _ I _ TO _ A
Karten Farbindizes für Alphakomponenten an.
GL _ PIXEL _ MAP _ R _ TO _ R
Karten roter Komponenten zu roten Komponenten.
GL _ PIXEL _ MAP _ G _ TO _ G
Karten grüne Komponenten zu grünen Komponenten.
GL _ PIXEL _ MAP _ B _ TO _ B
Karten blaue Komponenten in blaue Komponenten.
GL _ PIXEL _ MAP _ A _ TO _ A
Karten Alphakomponenten zu Alphakomponenten.

mapsize

Die Größe der zu definierenden Karte.

Werte

Ein Array von Zuordnungswerten.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ INVALID _ ENUM
map war kein akzeptierter Wert.
GL _ UNGÜLTIGER _ WERT
mapsize war negativ oder größer als GL _ PIXEL _ MAP _ TABLE.
GL _ UNGÜLTIGER _ WERT
Map war GL _ PIXEL MAP I TO _ _ _ _ I, GL PIXEL MAP _ S TO _ _ _ _ S, GL PIXEL MAP I _ TO _ _ _ _ R, GL PIXEL MAP I _ TO _ _ _ _ G, GL PIXEL MAP _ I TO B oder GL PIXEL MAP I TO _ A _ und _ _ _ _ _ _ _ mapsize war keine Potenz von zwei.
GL _ INVALID _ OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen.

Bemerkungen

Die glPixelMap-Funktion richtet Übersetzungstabellen ein oder ordnet zu, die von glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1Dund glTexSubImage2Dverwendet werden. Die Verwendung dieser Zuordnungen wird vollständig im Thema glPixelTransfer und teilweise in den Themen für die Pixel- und Texturbildbefehle beschrieben. In diesem Thema wird nur die Spezifikation der Zuordnungen beschrieben.

Der Map-Parameter ist ein symbolischer Kartenname, der eine von zehn festzulegende Zuordnungen angibt. Der Mapsize-Parameter gibt die Anzahl von Einträgen in der Karte an, und Werte sind ein Zeiger auf ein Array von Kartenwerten für Kartenzuordnungen.

Die Einträge in einer Zuordnung können als Gleitkommazahlen mit einfacher Genauigkeit, kurze ganze Zahlen ohne Vorzeichen oder ganze Zahlen ohne Vorzeichen angegeben werden. Karten, die Farbkomponentenwerte (alle außer GL _ PIXEL MAP I TO I und GL PIXEL MAP _ S TO _ _ _ _ _ _ _ _ S) speichern, behalten ihre Werte im Gleitkommaformat bei, mit nicht angegebenen Mantisse- und Exponentengrößen. Gleitkommawerte, die von glPixelMapfv angegeben werden, werden direkt in das interne Gleitkommaformat dieser Zuordnungen konvertiert und dann an den Bereich [ 0,1 ] gebunden. Durch glPixelMapusv und glPixelMapuiv angegebene ganzzahlige Werte ohne Vorzeichen werden linear konvertiert, sodass die größte darstellbare ganze Zahl 1,0 und null 0,0 zugeordnet wird.

Karten, die Indizes, GL _ PIXEL _ MAP I TO I und GL PIXEL MAP S _ TO _ _ _ _ _ _ _ S, speichern, behalten ihre Werte im Festkommaformat mit einer nicht angegebenen Anzahl von Bits rechts vom Binärpunkt bei. Gleitkommawerte, die von glPixelMapfv angegeben werden, werden direkt in das interne Festkommaformat dieser Zuordnungen konvertiert. Ganzzahlige Werte ohne Vorzeichen, die von glPixelMapusv und glPixelMapuiv angegeben werden, geben ganzzahlige Werte an, wobei alle Nullen rechts neben dem Binärpunkt angezeigt werden.

Die folgende Tabelle zeigt die Anfangsgrößen und -werte für jede der Zuordnungen. Karten, die entweder von Farb- oder Schablonenindizes indiziert werden, müssen karten = 2 ^ n für einige n aufweisen, oder Ergebnisse sind nicht definiert. Die maximal zulässige Größe für jede Zuordnung hängt von der Implementierung ab und kann durch Aufrufen von glGet mit dem Argument GL MAX PIXEL MAP TABLE bestimmt _ _ _ _ werden. Der einzelne Höchstwert gilt für alle Zuordnungen und ist mindestens 32.

Karte Suchindex Suchwert Anfangsgröße Anfangswert
GL _ PIXEL _ MAP _ I _ TO _ I Farbindex Farbindex 1 0,0
GL _ PIXEL _ MAP _ S _ TO _ S Schablonenindex Schablonenindex 1 0,0
GL _ PIXEL _ MAP _ I _ TO _ R Farbindex R 1 0,0
GL _ PIXEL _ MAP _ I _ TO _ G Farbindex G 1 0,0
GL _ PIXEL _ MAP _ I _ TO _ B Farbindex B 1 0,0
GL _ PIXEL _ MAP _ I _ TO _ A Farbindex Ein 1 0,0
GL _ PIXEL _ MAP _ R _ TO _ R R R 1 0,0
GL _ PIXEL _ MAP _ G _ TO _ G G G 1 0,0
GL _ PIXEL _ MAP _ B _ TO _ B B B 1 0,0
GL _ PIXEL _ MAP _ A _ TO _ A Ein Ein 1 0,0

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glPixelMap ab:

glGet mit Argument GL _ PIXEL MAP I TO I _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP S TO S _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP I TO R _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP I TO G _ _ _ _ _ SIZE

glGet mit Argument GL _ PIXEL MAP I TO B _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP I TO A _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP R TO R _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP G TO G _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP B TO B _ _ _ _ _ SIZE

glGet mit argument GL _ PIXEL MAP A TO A _ _ _ _ _ SIZE

glGet mit argument GL _ MAX PIXEL MAP _ _ _ TABLE

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glCopyPixels

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D