glPixelMapusv-Funktion
Die glPixelMapusv-Funktion richtet Pixelübertragungszuordnungen ein.
Syntax
void WINAPI glPixelMapusv(
GLenum map,
GLsizei mapsize,
const GLushort *values
);
Parameter
-
map
-
Ein symbolischer Kartenname. Die zehn Karten lauten wie folgt.
Wert Bedeutung - GL _ PIXEL _ MAP _ I _ TO _ I
Karten Farbindizes in Farbindizes. - GL _ PIXEL _ MAP _ S _ TO _ S
Karten Schablonenindizes in Schablonenindizes. - GL _ PIXEL _ MAP _ I _ TO _ R
Karten Farbindizes in rote Komponenten um. - GL _ PIXEL _ MAP _ I _ TO _ G
Karten Farbindizes in grüne Komponenten. - GL _ PIXEL _ MAP _ I _ TO _ B
Karten Farbindizes auf blaue Komponenten um. - GL _ PIXEL _ MAP _ I _ TO _ A
Karten farblich in Alphakomponenten. - GL _ PIXEL _ MAP _ R _ TO _ R
Karten rote Komponenten in rote Komponenten. - GL _ PIXEL MAP G ZU _ _ _ _ G
Karten grüne Komponenten in grüne Komponenten. - GL _ PIXEL MAP B ZU _ _ _ _ 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 Zweierkraft. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glPixelMap-Funktion richtet Übersetzungstabellen oder Zuordnungen ein, die von glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1Dund glTexSubImage2Dverwendet werden. Die Verwendung dieser Zuordnungen wird vollständig im GlPixelTransfer-Thema und teilweise in den Themen für die Pixel- und Texturbildbefehle beschrieben. In diesem Thema wird nur die Spezifikation der Karten beschrieben.
Der Map-Parameter ist ein symbolischer Kartenname, der eine von zehn zu legenden Karten angibt. Der mapsize-Parameter gibt die Anzahl der Einträge in der Karte an, und Werte sind ein Zeiger auf ein Array von Kartengröße-Kartenwerten.
Die Einträge in einer Zuordnung können als Gleitkommazahlen mit einzelner Genauigkeit, ganze Zahlen ohne Vorzeichen oder lange 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 nicht angegebenen _ _ _ _ _ _ _ _ _ _ Mantisse- und Exponentengrößen bei. Von glPixelMapfv angegebene Gleitkommawerte werden direkt in das interne Gleitkommaformat dieser Zuordnungen konvertiert und dann an den Bereich [ 0,1 geklammert. ] Ganzzahlwerte ohne Vorzeichen, die von glPixelMapusv und glPixelMapuiv angegeben werden, werden linear konvertiert, damit die größte darstellbare ganze Zahl 1,0 und 0,0 zugeordnet wird.
Karten, in denen Indizes , GL PIXEL MAP I TO I und GL PIXEL MAP S TO S, gespeichert werden, behalten ihre Werte im Festpunktformat bei, mit einer nicht angegebenen Anzahl von Bits rechts vom _ _ _ _ _ _ _ _ _ _ Binärpunkt. Von glPixelMapfv angegebene Gleitkommawerte werden direkt in das interne Festkommaformat dieser Zuordnungen konvertiert. Ganzzahlige Werte ohne Vorzeichen, die von glPixelMapusv und glPixelMapuiv angegeben werden, geben ganzzahlige Werte mit allen Nullen rechts vom Binärpunkt an.
In der folgenden Tabelle sind die Anfangsgrößen und -werte für jede der Karten aufgeführt. Karten, die entweder durch Farb- oder Schablonenindizes indiziert werden, müssen mapsize = 2 ^ n für einige n oder Ergebnisse haben, die nicht definiert sind. 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 Karten, und er beträgt mindestens 32.
| Karte | Suchindex | Nachschlagewert | 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 ZU _ _ _ _ G | G | G | 1 | 0,0 |
| GL _ PIXEL MAP B ZU _ _ _ _ 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 dem 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 |
|