glGetMinmax: Unterschied zwischen den Versionen
(an manpages angepasst) |
DGLBot (Diskussion | Beiträge) K (Bot: konvertiere/korrigiere <BR>) |
||
| Zeile 1: | Zeile 1: | ||
= glGetMinmax = | = glGetMinmax = | ||
| − | + | ||
| + | |||
== Name == | == Name == | ||
'''glGetMinmax''' - Liefert die minimalen und maximalen Farbwerte eines Bildes oder einer Textur. | '''glGetMinmax''' - Liefert die minimalen und maximalen Farbwerte eines Bildes oder einer Textur. | ||
| Zeile 12: | Zeile 13: | ||
''values'' : PGLvoid); | ''values'' : PGLvoid); | ||
| − | + | ||
| + | |||
== Parameter == | == Parameter == | ||
| Zeile 32: | Zeile 34: | ||
|} | |} | ||
| − | + | ||
| + | |||
== Beschreibung == | == Beschreibung == | ||
| Zeile 63: | Zeile 66: | ||
Falls ''reset'' '''GL_TRUE''' ist, werden die Minmax-Tabelleneinträge, die den Rückgabewerten entsprechen, auf ihre initialen Werte gesetzt. Minimal- und Maximalwerte, die nicht zurückgegeben werden, werden nicht verändert, auch wenn ''reset'' '''GL_TRUE''' ist. | Falls ''reset'' '''GL_TRUE''' ist, werden die Minmax-Tabelleneinträge, die den Rückgabewerten entsprechen, auf ihre initialen Werte gesetzt. Minimal- und Maximalwerte, die nicht zurückgegeben werden, werden nicht verändert, auch wenn ''reset'' '''GL_TRUE''' ist. | ||
| − | + | ||
| + | |||
== Hinweise == | == Hinweise == | ||
| Zeile 70: | Zeile 74: | ||
'''glGetMinmax''' ist nur verfügbar, wenn '''GL_ARB_imaging''' im Rückgabewert von [[glGetString]] enthalten ist bei einem Aufruf mit dem Parameter '''GL_EXTENSIONS'''. | '''glGetMinmax''' ist nur verfügbar, wenn '''GL_ARB_imaging''' im Rückgabewert von [[glGetString]] enthalten ist bei einem Aufruf mit dem Parameter '''GL_EXTENSIONS'''. | ||
| − | + | ||
| + | |||
== Fehlermeldungen == | == Fehlermeldungen == | ||
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' nicht '''GL_MINMAX''' ist.<br> | '''GL_INVALID_ENUM''' wird generiert wenn ''target'' nicht '''GL_MINMAX''' ist.<br> | ||
| Zeile 99: | Zeile 104: | ||
:* ''format'' weder '''GL_RGBA''' noch '''GL_BGRA''' ist. | :* ''format'' weder '''GL_RGBA''' noch '''GL_BGRA''' ist. | ||
| − | + | ||
| + | |||
== Siehe auch == | == Siehe auch == | ||
Aktuelle Version vom 22. April 2006, 19:21 Uhr
Inhaltsverzeichnis
glGetMinmax
Name
glGetMinmax - Liefert die minimalen und maximalen Farbwerte eines Bildes oder einer Textur.
Delphi-Spezifikation
procedure glGetMinmax(target : TGLenum; reset : TGLboolean;
format : TGLenum; _type : TGLenum;
values : PGLvoid);
Parameter
| target | Muss GL_MINMAX sein. |
|---|---|
| reset | Falls GL_TRUE, werden alle Einträge in der Minmax-Tabelle, die tatsächlich zurückgeliefert werden, auf ihre initialen Werte gesetzt. (Andere Einträge bleiben unverändert.) Falls GL_FALSE, bleibt die Minmax-Tabelle unverändert. |
| format | Das Format der Daten, die mit values zurückgegeben werden. Mögliche Werte sind GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA, GL_LUMINANCE oder GL_LUMINANCE_ALPHA. |
| _type | Datentyp der Werte, welche in values zurück gegeben werden. Die folgenden symbolischen Konstanten werden akzeptiert: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2, GL_UNSIGNED_INT_2_10_10_10_REV |
| values | Zeiger auf Speicher für die zurückgegebenen Werte. |
Beschreibung
glGetMinmax gibt die angehäuften Minimal- und Maximalpixelwerte (berechnet auf einer Per-Komponenten-Basis) in einem eindimensionalen Bild der Länge zwei zurück. Die erste Menge an Rückgabewerten sind die Minima und die zweite Menge an Rückgabewerten sind die Maxima. Das Format der Rückgabewerte wird durch format und ihr Typ durch _type festgelegt.
Keine Pixeltransferoperationen (gesetzt mit glPixelTransfer) werden für die Rückgabewerte ausgeführt, aber Pixelspeicher-Modes (gesetzt mit glPixelStore), die auf eindimensionalen Bilder anwendbar sind, werden ausgeführt. Farbkomponenten, die im definierten Format abgefragt werden, aber die nicht im internen Format der Minmax-Tabelle enthalten sind, werden als 0 zurückgegeben. Die Zuweisung von internen Farbkomponenten an die abgefragten Komponenten durch format sind wie folgt :
| Interne Komponente | Ergebniskomponente |
|---|---|
| Rot | Rot |
| Grün | Grün |
| Blau | Blau |
| Alpha | Alpha |
| Helligkeit | Rot |
Falls reset GL_TRUE ist, werden die Minmax-Tabelleneinträge, die den Rückgabewerten entsprechen, auf ihre initialen Werte gesetzt. Minimal- und Maximalwerte, die nicht zurückgegeben werden, werden nicht verändert, auch wenn reset GL_TRUE ist.
Hinweise
glGetMinmax ist ab OpenGL Version 1.2 verfügbar.
glGetMinmax ist nur verfügbar, wenn GL_ARB_imaging im Rückgabewert von glGetString enthalten ist bei einem Aufruf mit dem Parameter GL_EXTENSIONS.
Fehlermeldungen
GL_INVALID_ENUM wird generiert wenn target nicht GL_MINMAX ist.
GL_INVALID_ENUM wird generiert wenn format keinen zugelassenen Wert hat.
GL_INVALID_ENUM wird generiert wenn type keinen zugelassenen Wert hat.
GL_INVALID_OPERATION wird generiert wenn glGetMinmax innerhalb eines glBegin-glEnd Blocks aufgerufen wird.
GL_INVALID_OPERATION wird generiert wenn
- type einen der folgenden Werte hat:
- GL_UNSIGNED_BYTE_3_3_2
- GL_UNSIGNED_BYTE_2_3_3_REV
- GL_UNSIGNED_SHORT_5_6_5
- GL_UNSIGNED_SHORT_5_6_5_REV
- type einen der folgenden Werte hat:
- und
- format nicht GL_RGB ist.
GL_INVALID_OPERATION wird generiert wenn
- type einen der folgenden Werte hat:
- GL_UNSIGNED_SHORT_4_4_4_4
- GL_UNSIGNED_SHORT_4_4_4_4_REV
- GL_UNSIGNED_SHORT_5_5_5_1
- GL_UNSIGNED_SHORT_1_5_5_5_REV
- GL_UNSIGNED_INT_8_8_8_8
- GL_UNSIGNED_INT_8_8_8_8_REV
- GL_UNSIGNED_INT_10_10_10_2
- GL_UNSIGNED_INT_2_10_10_10_REV
- type einen der folgenden Werte hat:
- und
- format weder GL_RGBA noch GL_BGRA ist.
