Flash am 29. Januar 2006 um 17:29 Uhr

2006-01-29T17:29:43Z

La Boda am 29. Januar 2006 um 13:34 Uhr

2006-01-29T13:34:24Z

Neue Seite

= glConvolutionParameter =

== Name ==
'''glConvolutionParameterf''', '''glConvolutionParameteri''', '''glConvolutionParameterfv''', '''glConvolutionParameteriv''' - Setzt [[Convolution]]-Parameter

== Delphi-Spezifikation ==
procedure '''glConvolutionParameterf'''(''target'' : GLenum; ''pname'' : GLenum; ''params'' : GLfloat)

procedure '''glConvolutionParameteri'''(''target'' : GLenum; ''pname'' : GLenum; ''params'' : GLint)

== Parameter ==

{| border="1" rules="all"
! ''target''
| Das Ziel für die Comvolution-Parameter. Muss vom Typ '''GL_CONVOLUTION_1D''', '''GL_CONVOLUTION_2D''' oder '''GL_SEPARABLE_2D''' sein.
|-
! ''pname''
| Der zu setzende Parameter. Muss '''GL_CONVOLUTION_BORDER_MODE''' sein.
|-
! ''params''
| Der Parameter. Muss '''GL_REDUCE''', '''GL_CONSTANT_BORDER''' oder '''GL_REPLICATE_BORDER''' sein.
|}

== Delphi-Spezifikation ==
procedure '''glConvolutionParameterfv'''(''target'' : GLenum; ''pname'' : GLenum; '''const ''' ''params'' : PGLfloat)

procedure '''glConvolutionParameteriv'''(''target'' : GLenum; ''pname'' : GLenum; '''const ''' ''params'' : PGLint)

== Parameter ==

{| border="1" rules="all"
! ''target''
| Das Ziel für die Comvolution-Parameter. Muss vom Typ '''GL_CONVOLUTION_1D''', '''GL_CONVOLUTION_2D''' oder '''GL_SEPARABLE_2D''' sein.
|-
! ''pname''
| Der zu setzende Parameter. Muss '''GL_CONVOLUTION_BORDER_MODE''', '''GL_CONVOLUTION_BORDER_COLOR''', '''GL_CONVOLUTION_FILTER_SCALE''' oder '''GL_CONVOLUTION_FILTER_BIAS''' sein.
|-
! ''params''
| Der Parameter. Wenn ''pname'' '''GL_CONVOLUTION_BORDER_MODE''' ist, dann muss ''params'' '''GL_REDUCE''', '''GL_CONSTANT_BORDER''' oder '''GL_REPLICATE_BORDER''' sein. Andernfalls muss ein einer vierdimensionaler Vektor (für Rot, Grün, Blau bzw. Alpha) zum Skalieren (wenn ''pname'' '''GL_CONVOLUTION_FILTER_SCALE''' ist) oder zum Biasing (wenn ''pname'' '''GL_CONVOLUTION_FILTER_BIAS''' ist) eines Convolution-Filter-Kernels oder zum Setzen der konstanten Rand-Farbe (wenn ''pname'' '''GL_CONVOLUTION_BORDER_COLOR''' ist) verwendet werden.
|}

== Beschreibung ==
'''glConvolutionParameter''' setzt den Wert für einen [[Convolution]]-Parameter.

Mit ''target'' wählt man den Convolution-Filter, der bearbeitet werden soll. Zulässig sind Variablen mit dem Typ '''GL_CONVOLUTION_1D''', '''GL_CONVOLUTION_2D''' oder '''GL_SEPARABLE_2D'''.

Mit ''pname'' wählt man den Parameter, der verändert werden soll. '''GL_CONVOLUTION_FILTER_SCALE''' und '''GL_CONVOLUTION_FILTER_BIAS''' beeinflussen die Definition des Convolution-Filter-Kernels (siehe [[glConvolutionFilter1D]], [[glConvolutionFilter2D]], and [[glSeparableFilter2D]] für mehr Details). In diesen Fällen ist ''params'' ein Array mit vier Werten für Rot, Grün, Blau bzw Alpha. Der Standard-Wert für '''GL_CONVOLUTION_FILTER_SCALE''' ist (1, 1, 1, 1), für '''GL_CONVOLUTION_FILTER_BIAS'''
(0, 0, 0, 0).

Der ''pname''-Wert '''GL_CONVOLUTION_BORDER_MODE''' beeinflusst den Convolution-Rand-Modus. Zulässige Modi sind:

:'''GL_REDUCE'''
::Das Bild, das durch die Convolution erzeugt wird, ist kleiner als das ursprüngliche Bild. Wenn die Filter-Breite ''Wf'' ist, die Höhe ''Hf'' und die ürsprüngliche Breite ''Ws'' und Höhe ''Hs'', dann hat das erzeugte Bild die Breite ''Ws - Wf + 1'' und die Höte ''Hs - Hf + 1''. (Wenn diese Operation ein Bild mit der Breite und Höhe 0 erzeugen würde, bleibt das Ergebnis 0, ohne das ein Fehler generiert wird.) Die Koordinaten des fertigen Bildes sind (0, 0).

:'''GL_CONSTANT_BORDER'''
::Das Bild, das durch die Convolution erzeugt wird, hat die gleiche Größe wie das ursprüngliche Bild und wird so generiert, wie wenn das ursprüngliche Bild von Pixeln mit der Farbe - festgelegt durch '''GL_CONVOLUTION_BORDER_COLOR''' - umgeben wäre.

:'''GL_REPLICATE_BORDER'''
::Das Bild, das durch die Convolution erzeugt wird, hat die gleiche Größe wie das ursprüngliche Bild und wird so generiert, wie wenn die äußersten Pixel des Rands des Quellbildes wiederholt würden.

== Hinweise ==
'''glConvolutionParameter''' steht nur zur Verfügung, wenn '''GL_ARB_imaging''' in dem String enthalten ist, der von [[glGetString]] mit dem Argument '''GL_EXTENSIONS''' zurückgeliefert wird.

In Fällen, in denen Fehler aus den Maßen von ungültigen Bilddimensionen folgen würden, werden die Dimensionen nach der Convolution überprüft, und nicht die Dimensionen des Quellbildes. Zum Beispiel erfordert [[glTexImage1D]] ein Bild mit den Maßen 2^n. Wenn der '''GL_REDUCE''' Rand-Modus aktiviert ist, dann muss das Quellbild um 1 größer als die finale 2^n-Größe des 1D-Filter-Kernels sein.

== Fehlermeldungen ==

'''GL_FEHLER''' wird generiert, wenn....

'''GL_INVALID_ENUM''' wird generiert, wenn ''target'' einen unzulässigen Wert hat.

'''GL_INVALID_ENUM''' wird generiert, wenn ''pname'' einen unzulässigen Wert hat.

'''GL_INVALID_ENUM''' wird generiert, wenn ''pname'' '''GL_CONVOLUTION_BORDER_MODE''' ist und ''params'' '''GL_REDUCE''', '''GL_CONSTANT_BORDER''' oder '''GL_REPLICATE_BORDER''' ist.

'''GL_INVALID_OPERATION''' wird generiert wenn '''glConvolutionParameter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.

== Zugehörige Wertrückgaben ==
[[glGetConvolutionParameter]]

== Siehe auch ==
[[glConvolutionFilter1D]], [[glConvolutionFilter2D]], [[glSeparableFilter2D]], [[glGetConvolutionParameter]]

[[Kategorie:GL|ConvolutionParameter]]

@@ Zeile 8: / Zeile 8: @@
 == Delphi-Spezifikation ==
   procedure '''glConvolutionParameterf'''(''target'' : GLenum; ''pname'' : GLenum; ''params'' : GLfloat)
-−
   procedure '''glConvolutionParameteri'''(''target'' : GLenum; ''pname'' : GLenum; ''params'' : GLint)
@@ Zeile 28: / Zeile 28: @@
 == Delphi-Spezifikation ==
   procedure '''glConvolutionParameterfv'''(''target'' : GLenum; ''pname'' : GLenum; '''const ''' ''params'' : PGLfloat)
-−
   procedure '''glConvolutionParameteriv'''(''target'' : GLenum; ''pname'' : GLenum; '''const ''' ''params'' : PGLint)

glConvolutionParameter - Versionsgeschichte

Flash am 29. Januar 2006 um 17:29 Uhr

La Boda am 29. Januar 2006 um 13:34 Uhr