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 |
|---|---|
|
map war kein akzeptierter Wert. |
|
mapsize war negativ oder größer als GL _ PIXEL _ MAP _ TABLE. |
|
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. |
|
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 |
|
| Bibliothek |
|
| DLL |
|