glGetConvolutionFilter

Aus DGL Wiki
Version vom 7. April 2006, 09:55 Uhr von Dj3hut1 (Diskussion | Beiträge) (kleiner Tipfehler korrigiert)

Wechseln zu: Navigation, Suche

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