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
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 Zweierkraft.
UNGÜLTIGER _ _ GL-VORGANG
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glCopyPixels

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D