glGetSeparableFilter

glGetSeparableFilter

Name

glGetSeparableFilter - Abfrage des separablen Convolution-Filters.

Delphi-Spezifikation

procedure glGetSeparableFilter(target : TGLenum; format : TGLenum; _type : TGLenum;
                               row : PGLvoid; column : PGLvoid; span : PGLvoid);

Parameter

target	Der abzufragende separable Filter. Muss GL_SEPARABLE_2D sein.
format	Gewünschtes Format der Werte. 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	Typ, mit dem die zu holenden Daten gespeichert werden sollen. Erlaubte symbolische Konstanten sind : 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.
row	Zeiger auf Speicher, in der die Spalten-Daten des separablen Filters abgelegt werden sollen.
column	Zeiger auf Speicher, in der die Zeilen-Daten des separablen Filters abgelegt werden sollen.
span	Bisher ungenutzter Parameter. Sollte vorerst Null-Wert enthalten.

Beschreibung

glGetSeparableFilter liefert den aktuell gesetzten separablen Convolution-Filter über die Zeiger row und column zurück. target gibt das Ziel des gewünschten Filters an und muss auf GL_SEPARABLE_2D gesetzt werden. format und type geben das Format und den Typ des gewünschten Filters an und sind äquivalent zu den entsprechenden Parametern von glGetTexImage.

row enthält dabei die Spaltenwerte und column die Zeilenwerte des Filters.

Hinweise

Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von params durchgeführt.

Für row und column 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 (für die Länge von row) und GL_CONVOLUTION_HEIGHT (für die Länge von column) 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 glGetSeparableFilter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Siehe auch

glConvolutionFilter, glGetConvolutionFilter, glGetConvolutionParameter, glSeparableFilter