glGetConvolutionParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(neu erstellt)
 
(Anpassung an manpages)
Zeile 7: Zeile 7:
 
<br>
 
<br>
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
−
  procedure '''glGetConvolutionParameterfv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLfloat);
+
  procedure '''glGetConvolutionParameterfv'''(''target'': TGLenum; ''pname'': TGLenum;
−
  procedure '''glGetConvolutionParameteriv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLint);
+
                                      ''params'': PGLfloat);
 +
  procedure '''glGetConvolutionParameteriv'''(''target'': TGLenum; ''pname'': TGLenum;
 +
                                      ''params'': PGLint);
  
 
<br>
 
<br>
Zeile 14: Zeile 16:
 
{| border="1" rules="all"
 
{| border="1" rules="all"
 
! ''target''
 
! ''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'''.
+
| Der Filter, dessen Parameter abgefragt werden. Muss eine der folgenden symbolischen Konstanten sein : '''GL_CONVOLUTION_1D''', '''GL_CONVOLUTION_2D''' oder '''GL_SEPARABLE_2D'''.
 
|-
 
|-
 
! ''pname''
 
! ''pname''
Zeile 20: Zeile 22:
 
|-
 
|-
 
! ''params''
 
! ''params''
−
| Liefert den angeforderten Convolution-Parameter.
+
| Zeiger auf Speicher für die abzufragenden Parameter.
 
|}
 
|}
  
Zeile 26: Zeile 28:
  
 
== Beschreibung ==  
 
== Beschreibung ==  
−
'''glGetConvolutionParameter''' liefert über die Rückgabevariable ''params'' den Wert der Convolution-Eigenschaft, die mit ''pname'' angegeben wurde.<br>
+
'''glGetConvolutionParameter''' fragt Convolution-Parameter ab. ''target'' bestimmt, welcher Convolution-Filter abgefragt werden soll. ''pname'' bestimmt, welcher Parameter zurückgeliefert wird :
  
−
Folgende Eigenschaften sind abfragbar :
+
'''GL_CONVOLUTION_BORDER_MODE'''
 +
: Der Convolution-Rahmenmodus. Siehe [[glConvolutionParameter]] für eine Liste an Rahmenmodes.
  
 
'''GL_CONVOLUTION_BORDER_COLOR'''
 
'''GL_CONVOLUTION_BORDER_COLOR'''
−
: Liefert die RGBA-Farbe des Convolution-Rahmens (4 Werte).
+
: 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_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'''
 
'''GL_CONVOLUTION_FILTER_SCALE'''
−
: Liefert die Skalierungsfaktoren, welche auf den Filter angewendet werden (4 Werte).
+
: 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'''
 
'''GL_CONVOLUTION_FILTER_BIAS'''
−
: Liefert die Biaswerte, welche auf den Filter angewendet werden (4 Werte).
+
: 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'''
 
'''GL_CONVOLUTION_FORMAT'''
−
: Liefert das internes Format des Convolution-Filtes.
+
: Das aktuellen interne Format. Siehe [[glConvolutionFilter1D]], [[glConvolutionFilter2D]] und [[glSeparableFilter2D]] für eine Liste der erlaubten Formate.
  
 
'''GL_CONVOLUTION_WIDTH'''
 
'''GL_CONVOLUTION_WIDTH'''
−
: Liefert die Breite des Filters.
+
: Die aktuelle Breite des Filterbildes.
  
 
'''GL_CONVOLUTION_HEIGHT'''
 
'''GL_CONVOLUTION_HEIGHT'''
−
: Liefert die Höhe des Filters.
+
: Die aktuelle Höhe des Filterbildes.
  
 
'''GL_MAX_CONVOLUTION_WIDTH'''
 
'''GL_MAX_CONVOLUTION_WIDTH'''
−
: Liefert die maximale Breite des Filters.
+
: Die maximale akzeptable Breite des Filterbildes.
  
 
'''GL_MAX_CONVOLUTION_HEIGHT'''
 
'''GL_MAX_CONVOLUTION_HEIGHT'''
−
: Liefert die maximale Höhe des Filters.
+
: Die maximale akzeptable Höhe des Filterbildes.
  
 
<br>
 
<br>
Zeile 64: Zeile 64:
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' oder ''pname'' ungültige Werte übergeben werden. <br>
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' oder ''pname'' ungültige Werte übergeben werden. <br>
−
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetConvolutionParameter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
+
 
 +
'''GL_INVALID_ENUM''' wird generiert, falls ''target'' '''GL_CONVOLUTION_1D''' und ''pname'' '''GL_CONVOLUTION_HEIGHT''' oder '''GL_MAX_CONVOLUTION_HEIGHT''' ist.<br>
 +
 
 +
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetConvolutionParameter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.<br>
  
 
<br>
 
<br>
 
== Siehe auch ==
 
== Siehe auch ==
−
[[glConvolutionFilter]], [[glConvolutionParameter]], [[glGetConvolutionFilter]], [[glGetSeparableFilter]], [[glSeparableFilter]]
+
[[glConvolutionFilter]], [[glConvolutionParameter]], [[glGetConvolutionFilter]], [[glGetSeparableFilter]], [[glSeparableFilter2D]]
  
 
[[Kategorie:GL|GetConvolutionParameter]]
 
[[Kategorie:GL|GetConvolutionParameter]]

Version vom 10. April 2006, 14:01 Uhr

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

Abgerufen von „https://wiki.delphigl.com/index.php?title=glGetConvolutionParameter&oldid=17156“