glGetConvolutionParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(neu erstellt)
 
K (Bot: konvertiere/korrigiere <BR>)
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 1: Zeile 1:
 
= glGetConvolutionParameter =
 
= glGetConvolutionParameter =
  
−
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
 
'''glGetConvolutionParameter''' - dient zur Abfrage der verschiedenen Convolution-Parameter.
 
'''glGetConvolutionParameter''' - dient zur Abfrage der verschiedenen Convolution-Parameter.
  
−
<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>
 
 
== Parameter ==
 
== Parameter ==
 
{| 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 25:
 
|-
 
|-
 
! ''params''
 
! ''params''
−
| Liefert den angeforderten Convolution-Parameter.
+
| Zeiger auf Speicher für die abzufragenden Parameter.
 
|}
 
|}
  
−
<br>
+
 
 +
 
  
 
== 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>
 
 
== Hinweise ==
 
== Hinweise ==
 
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
 
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
  
−
<br>
+
 
 +
 
 
== 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.
 
  
−
<br>
+
'''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>
 +
 
 +
 
 +
 
 
== Siehe auch ==
 
== Siehe auch ==
−
[[glConvolutionFilter]], [[glConvolutionParameter]], [[glGetConvolutionFilter]], [[glGetSeparableFilter]], [[glSeparableFilter]]
+
[[glConvolutionFilter]], [[glConvolutionParameter]], [[glGetConvolutionFilter]], [[glGetSeparableFilter]], [[glSeparableFilter2D]]
  
 
[[Kategorie:GL|GetConvolutionParameter]]
 
[[Kategorie:GL|GetConvolutionParameter]]

Aktuelle Version vom 22. April 2006, 20:20 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=17606“