glPixelMapfv-Funktion
Die Funktion glPixelMapfv richtet Pixelübertragungszuordnungen ein.
Syntax
void WINAPI glPixelMapfv(
GLenum map,
GLsizei mapsize,
const GLfloat *values
);
Parameter
-
map
-
Ein symbolischer Zuordnungsname. Die zehn Karten sind wie folgt:
Wert Bedeutung - GL_PIXEL_MAP_I_TO_I
Ordnet Farbindizes Farbindizes Farbindizes zu. - GL_PIXEL_MAP_S_TO_S
Ordnet Schablonenindizes Schablonenindizes zu. - GL_PIXEL_MAP_I_TO_R
Ordnet Farbindizes roten Komponenten zu. - GL_PIXEL_MAP_I_TO_G
Ordnet Farbindizes grünen Komponenten zu. - GL_PIXEL_MAP_I_TO_B
Ordnet Farbindizes blauen Komponenten zu. - GL_PIXEL_MAP_I_TO_A
Ordnet Farbindizes Alphakomponenten zu. - GL_PIXEL_MAP_R_TO_R
Ordnet rote Komponenten roten Komponenten zu. - GL_PIXEL_MAP_G_TO_G
Ordnet grüne Komponenten grünen Komponenten zu. - GL_PIXEL_MAP_B_TO_B
Ordnet blaue Komponenten blauen Komponenten zu. - GL_PIXEL_MAP_A_TO_A
Ordnet Alphakomponenten Alphakomponenten Alphakomponenten zu. -
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 Macht von zwei. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glPixelMap-Funktion richtet Übersetzungstabellen oder -karten ein, die von glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexImage1D, glTexSubImage1D und glTexSubImage2D verwendet 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 Karten beschrieben.
Der Kartenparameter ist ein symbolischer Kartenname, der eine von zehn festzulegenden Karten angibt. Der mapsize-Parameter gibt die Anzahl der Einträge in der Karte an, und werte sind ein Zeiger auf ein Array von Kartenzuordnungswerten .
Die Einträge in einer Zuordnung können als Gleitkommazahlen mit einfacher Genauigkeit, kurze ganze Zahlen ohne Vorzeichen oder lange ganze Zahlen ohne Vorzeichen angegeben werden. Karten, die Farbkomponentenwerte (außer GL_PIXEL_MAP_I_TO_I und GL_PIXEL_MAP_S_TO_S) speichern, behalten ihre Werte im Gleitkommaformat mit nicht spezifizierten Mantissa- und Exponentengrößen bei. Gleitkommawerte, die von glPixelMapfv angegeben werden, werden direkt in das interne Gleitkommaformat dieser Karten konvertiert und dann in den Bereich [0,1] geklemmt. Ganzzahlwerte ohne Vorzeichen, die von glPixelMapusv und glPixelMapuiv angegeben werden, werden linear konvertiert, sodass die größte darstellbare ganze Zahl 1,0 und null Zuordnungen 0,0 zugeordnet werden.
Karten, die Indizes GL_PIXEL_MAP_I_TO_I und GL_PIXEL_MAP_S_TO_S speichern, behalten ihre Werte im Festpunktformat mit einer nicht angegebenen Anzahl von Bits rechts neben dem binären Punkt bei. Gleitkommawerte, die von glPixelMapfv angegeben werden, werden direkt in das interne Fixpunktformat dieser Zuordnungen konvertiert. Ganzzahlwerte ohne Vorzeichen, die von glPixelMapusv und glPixelMapuiv angegeben werden, geben ganzzahlige Werte an, wobei alle Nullen rechts neben dem Binärpunkt liegen.
Die folgende Tabelle zeigt die Anfangsgrößen und Werte für die einzelnen Karten. Karten, die entweder durch Farb- oder Schablonenindizes indiziert sind, müssen für einige nmapsize = 2 ^ 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 argument GL_MAX_PIXEL_MAP_TABLE bestimmt werden. Das einzelne Maximum gilt für alle Karten und ist mindestens 32.
| Zuordnung | Nachschlageindex | 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 | A | 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 | A | 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
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 |
|