glGetConvolutionFilter: Unterschied zwischen den Versionen
(neu erstellt) |
K (kleiner Tipfehler korrigiert) |
||
| Zeile 22: | Zeile 22: | ||
|- | |- | ||
! ''image'' | ! ''image'' | ||
| − | | Zeiger auf Speicher, in der die Daten des Filterkernels geladen | + | | Zeiger auf Speicher, in der die Daten des Filterkernels geladen werden sollen. |
|} | |} | ||
Version vom 7. April 2006, 09:55 Uhr
Inhaltsverzeichnis
glGetConvolutionFilter
Name
glGetConvolutionFilter - Abfrage des momentanen Convolution-Filters.
Delphi-Spezifikation
procedure glGetConvolutionFilter(target: TGLenum; format: TGLenum; _type: TGLenum; image: PGLvoid);
Parameter
| target | Ziel des Filters. Akzeptierte Werte sind GL_CONVOLUTION_1D und GL_CONVOLUTION_2D. |
|---|---|
| format | Pixelformat des Filterkernels. Erlaubt sind die Parameter GL_RGB, GL_RGBA, GL_BGR, GL_BGRA, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE und GL_LUMINANCE_ALPHA. |
| _type | Datentyp für Pixelwerte des Filterkernels. Erlaubt sind die Parameter GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_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 und GL_UNSIGNED_INT_2_10_10_10_REV. |
| image | Zeiger auf Speicher, in der die Daten des Filterkernels geladen werden sollen. |
Beschreibung
glGetConvolutionFilter liefert den aktuell gesetzten Convolution-Filter über den Zeiger image zurück. target bestimmt, ob der gewünschte Filter via glConvolutionFilter1D(GL_CONVOLUTION_1D) oder glConvolutionFilter2D(GL_CONVOLUTION_2D) erstellt wurde. format und type geben das Format und den Typ des gewünschten Filters an und sind äquivalent zu den entsprechenden Parametern von glGetTexImage.
Hinweise
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von params durchgeführt.
Für image sollte zum Empfang der Daten genügend Speicher allokiert werden. Die Grösse des Speichers ist abhängig von den Parametern format, _type und der Größe des Filters, welche via glGetConvolutionParameter mit den Parametern GL_CONVOLUTION_WIDTH und GL_CONVOLUTION_HEIGHT ermittelt werden kann.
Fehlermeldungen
GL_INVALID_ENUM wird generiert wenn target, format oder type ein ungültiger Wert übergeben wurde.
GL_INVALID_OPERATION wird generiert wenn glGetConvolutionFilter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.
Siehe auch
glConvolutionFilter, glGetSeparableFilter, glGetConvolutionParameter
