glGetConvolutionParameter

glGetConvolutionParameter

Name

glGetConvolutionParameter - dient zur Abfrage der verschiedenen Convolution-Parameter.

Delphi-Spezifikation

procedure glGetConvolutionParameterfv(target: TGLenum; pname: TGLenum; params: PGLfloat);
procedure glGetConvolutionParameteriv(target: TGLenum; pname: TGLenum; params: PGLint);

Parameter

target	Gibt den symbolischen Namen des Filters an, dessen Parameter abgefragt werden sollen. Erlaubte Werte sind GL_CONVOLUTION_1D, GL_CONVOLUTION_2D oder GL_SEPARABLE_2D.
pname	Gibt den symbolischen Namen des Convolution-Parameters an, der abgefragt werden soll. Akzeptierte Werte sind GL_CONVOLUTION_BORDER_COLOR, GL_CONVOLUTION_BORDER_MODE, GL_CONVOLUTION_FILTER_SCALE, GL_CONVOLUTION_FILTER_BIAS, GL_CONVOLUTION_FORMAT, GL_CONVOLUTION_WIDTH, GL_CONVOLUTION_HEIGHT, GL_MAX_CONVOLUTION_WIDTH oder GL_MAX_CONVOLUTION_HEIGHT.
params	Liefert den angeforderten Convolution-Parameter.

Beschreibung

glGetConvolutionParameter liefert über die Rückgabevariable params den Wert der Convolution-Eigenschaft, die mit pname angegeben wurde.

Folgende Eigenschaften sind abfragbar :

GL_CONVOLUTION_BORDER_COLOR

Liefert die RGBA-Farbe des Convolution-Rahmens (4 Werte).

GL_CONVOLUTION_BORDER_MODE

Liefert den Rahmen-Modus des Convolution-Filters. Mögliche Rückgabewerte sind GL_REDUCE, GL_CONSTANT_BORDER oder GL_REPLICATE_BORDER.

GL_CONVOLUTION_FILTER_SCALE

Liefert die Skalierungsfaktoren, welche auf den Filter angewendet werden (4 Werte).

GL_CONVOLUTION_FILTER_BIAS

Liefert die Biaswerte, welche auf den Filter angewendet werden (4 Werte).

GL_CONVOLUTION_FORMAT

Liefert das internes Format des Convolution-Filtes.

GL_CONVOLUTION_WIDTH

Liefert die Breite des Filters.

GL_CONVOLUTION_HEIGHT

Liefert die Höhe des Filters.

GL_MAX_CONVOLUTION_WIDTH

Liefert die maximale Breite des Filters.

GL_MAX_CONVOLUTION_HEIGHT

Liefert die maximale Höhe des Filters.

Hinweise

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

Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn target oder pname ungültige Werte übergeben werden.
GL_INVALID_OPERATION wird generiert wenn glGetConvolutionParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Siehe auch

glConvolutionFilter, glConvolutionParameter, glGetConvolutionFilter, glGetSeparableFilter, glSeparableFilter