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	Der Filter, dessen Parameter abgefragt werden. Muss eine der folgenden symbolischen Konstanten sein : 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	Zeiger auf Speicher für die abzufragenden Parameter.

Beschreibung

glGetConvolutionParameter fragt Convolution-Parameter ab. target bestimmt, welcher Convolution-Filter abgefragt werden soll. pname bestimmt, welcher Parameter zurückgeliefert wird :

GL_CONVOLUTION_BORDER_MODE

Der Convolution-Rahmenmodus. Siehe glConvolutionParameter für eine Liste an Rahmenmodes.

GL_CONVOLUTION_BORDER_COLOR

Die aktuelle Convolution-Rahmenfarbe. params muss ein Zeiger auf ein Array mit vier Elementen sein, welches die roten, grünen, blauen und Alpha Rahmenfarben bekommt.

GL_CONVOLUTION_FILTER_SCALE

Die aktuellen Skalierungsfaktoren des Filters. params muss ein Zeiger auf ein Array mit vier Elementen sein, welches die roten, grünen, blauen und Alpha Rahmenfarben in dieser Reihenfolge bekommt.

GL_CONVOLUTION_FILTER_BIAS

Die aktuellen Biasfaktoren des Filters. params muss ein Zeiger auf ein Array mit vier Elementen sein, welches die roten, grünen, blauen und Alpha Rahmenfarben in dieser Reihenfolge bekommt.

GL_CONVOLUTION_FORMAT

Das aktuellen interne Format. Siehe glConvolutionFilter1D, glConvolutionFilter2D und glSeparableFilter2D für eine Liste der erlaubten Formate.

GL_CONVOLUTION_WIDTH

Die aktuelle Breite des Filterbildes.

GL_CONVOLUTION_HEIGHT

Die aktuelle Höhe des Filterbildes.

GL_MAX_CONVOLUTION_WIDTH

Die maximale akzeptable Breite des Filterbildes.

GL_MAX_CONVOLUTION_HEIGHT

Die maximale akzeptable Höhe des Filterbildes.

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_ENUM wird generiert, falls target GL_CONVOLUTION_1D und pname GL_CONVOLUTION_HEIGHT oder GL_MAX_CONVOLUTION_HEIGHT ist.

GL_INVALID_OPERATION wird generiert wenn glGetConvolutionParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Siehe auch

glConvolutionFilter, glConvolutionParameter, glGetConvolutionFilter, glGetSeparableFilter, glSeparableFilter2D