glGetSeparableFilter - Versionsgeschichte

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:21:19Z

Bot: konvertiere/korrigiere

Dj3hut1: an manpages angepasst

2006-04-10T15:33:49Z

an manpages angepasst

Dj3hut1: Funktionsverweis verändert

2006-04-07T15:20:22Z

Funktionsverweis verändert

Dj3hut1: neu erstellt

2006-04-07T15:18:05Z

neu erstellt

Neue Seite

= glGetSeparableFilter =

 
== Name ==
'''glGetSeparableFilter''' - Abfrage des separablen [[Convolution-Filter|Convolution-Filters]].

 
== Delphi-Spezifikation ==
procedure '''glGetSeparableFilter'''(''target'' : TGLenum; ''format'' : TGLenum; ''_type'' : TGLenum;
''row'' : PGLvoid; ''column'' : PGLvoid; ''span'' : PGLvoid);

 
== Parameter ==
{| border="1" rules="all"
! ''target''
| Der abzufragende separable Filter. Muss '''GL_SEPARABLE_2D''' sein.
|-
! ''format''
| Gewünschtes Format der Werte. Erlaubt sind die Parameter '''GL_RGB, GL_RGBA, GL_BGR, GL_BGRA, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE''' und '''GL_LUMINANCE_ALPHA'''.
|-
! ''_type''
| Typ, mit dem die zu holenden Daten gespeichert werden sollen. Erlaubte symbolische Konstanten sind : '''GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2''' und '''GL_UNSIGNED_INT_2_10_10_10_REV'''.
|-
! ''row''
| Zeiger auf Speicher, in der die Spalten-Daten des separablen Filters abgelegt werden sollen.
|-
! ''column''
| Zeiger auf Speicher, in der die Zeilen-Daten des separablen Filters abgelegt werden sollen.
|-
! ''span''
| Bisher ungenutzter Parameter. Sollte vorerst Null-Wert enthalten.
|}

 

== Beschreibung ==
'''glGetSeparableFilter''' liefert den aktuell gesetzten separablen Convolution-Filter über die Zeiger ''row'' und ''column'' zurück. ''target'' gibt das Ziel des gewünschten Filters an und muss auf '''GL_SEPARABLE_2D''' gesetzt werden. ''format'' und ''type'' geben das Format und den Typ des gewünschten Filters an und sind äquivalent zu den entsprechenden Parametern von [[glGetTexImage]].

''row'' enthält dabei die Spaltenwerte und ''column'' die Zeilenwerte des Filters.

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

Für ''row'' und ''column'' sollte zum Empfang der Daten genügend Speicher allokiert werden. Die Grösse des Speichers ist abhängig von den Parametern ''format'', ''_type'' und der Größe des Filters, welche via [[glGetConvolutionParameter]] mit den Parametern '''GL_CONVOLUTION_WIDTH''' (für die Länge von ''row'') und '''GL_CONVOLUTION_HEIGHT''' (für die Länge von ''column'') ermittelt werden kann.

 
== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn ''target'', ''format'' oder ''type'' ein ungültiger Wert übergeben wurde. 
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetSeparableFilter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.

 
== Siehe auch ==
[[glConvolutionFilter]], [[glGetConvolutionFilter]], [[glGetConvolutionParameter]], [[glSeparableFilter]]

[[Kategorie:GL|GetSeparableFilter]]

@@ Zeile 1: / Zeile 1: @@
 = glGetSeparableFilter =
-<br>
 == Name ==
 '''glGetSeparableFilter''' - holt separable Convolution-Faltungskernbilder.
-<br>
 == Delphi-Spezifikation ==
   procedure '''glGetSeparableFilter'''(''target'' : TGLenum; ''format'' : TGLenum;
@@ Zeile 11: / Zeile 13: @@
                                  ''column'' : PGLvoid; ''span'' : PGLvoid);
-<br>
 == Parameter ==
 {| border="1" rules="all"
@@ Zeile 33: / Zeile 36: @@
 |}
-<br>
 == Beschreibung ==
@@ Zeile 65: / Zeile 69: @@
 </div>
-<br>
 == Hinweise ==
 '''glGetSeparableFilter''' ist erst ab GL Version 1.2 oder höher nutzbar.
@@ Zeile 77: / Zeile 82: @@
 Nicht-separable 2D-Filter müssen mit [[glGetConvolutionFilter]] geholt werden.
-<br>
 == Fehlermeldungen ==
 '''GL_INVALID_ENUM''' wird generiert, wenn ''target'' nicht '''GL_SEPARABLE_2D''' ist.<br>
@@ Zeile 108: / Zeile 114: @@
-<br>
 == Siehe auch ==
 [[glConvolutionFilter]], [[glGetConvolutionFilter]], [[glGetConvolutionParameter]], [[glSeparableFilter2D]]
 [[Kategorie:GL|GetSeparableFilter]]

@@ Zeile 3: / Zeile 3: @@
 <br>
 == Name ==
-'''glGetSeparableFilter''' - Abfrage des separablen [[Convolution-Filter|Convolution-Filters]].
+'''glGetSeparableFilter''' - holt separable Convolution-Faltungskernbilder.
 <br>
 == Delphi-Spezifikation ==
-  procedure '''glGetSeparableFilter'''(''target'' : TGLenum; ''format'' : TGLenum; ''_type'' : TGLenum;
+  procedure '''glGetSeparableFilter'''(''target'' : TGLenum; ''format'' : TGLenum;
-                                ''row'' : PGLvoid; ''column'' : PGLvoid; ''span'' : PGLvoid);
+                                ''_type'' : TGLenum; ''row'' : PGLvoid;
 <br>
@@ Zeile 17: / Zeile 18: @@
 |-
 ! ''format''
-| Gewünschtes Format der Werte. Erlaubt sind die Parameter '''GL_RGB, GL_RGBA, GL_BGR, GL_BGRA, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE''' und '''GL_LUMINANCE_ALPHA'''.
+| Gewünschtes Format des Ausgabebildes. Erlaubt sind die Parameter '''GL_RGB, GL_RGBA, GL_BGR, GL_BGRA, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE''' und '''GL_LUMINANCE_ALPHA'''.
 |-
 ! ''_type''
-| Typ, mit dem die zu holenden Daten gespeichert werden sollen. Erlaubte symbolische Konstanten sind : '''GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2''' und '''GL_UNSIGNED_INT_2_10_10_10_REV'''.
+| Datentyp der Komponenten des Ausgabebildes. Erlaubte symbolische Konstanten sind : '''GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2''' und '''GL_UNSIGNED_INT_2_10_10_10_REV'''.
 |-
 ! ''row''
-| Zeiger auf Speicher, in der die Spalten-Daten des separablen Filters abgelegt werden sollen.
+| Zeiger auf Speicher für das Zeilenfilterbild.
 |-
 ! ''column''
-| Zeiger auf Speicher, in der die Zeilen-Daten des separablen Filters abgelegt werden sollen.
+| Zeiger auf Speicher für das Spaltenfilterbild.
 |-
 ! ''span''
-| Bisher ungenutzter Parameter. Sollte vorerst Null-Wert enthalten.
+| Zeiger auf Speicher für das Spannenfilterbild (zur Zeit unbenutzt).
 |}
@@ Zeile 35: / Zeile 36: @@
 == Beschreibung ==
-'''glGetSeparableFilter''' liefert den aktuell gesetzten separablen Convolution-Filter über die Zeiger ''row'' und ''column'' zurück. ''target'' gibt das Ziel des gewünschten Filters an und muss auf '''GL_SEPARABLE_2D''' gesetzt werden. ''format'' und ''type'' geben das Format und den Typ des gewünschten Filters an und sind äquivalent zu den entsprechenden Parametern von [[glGetTexImage]].
+'''glGetSeparableFilter''' liefert die zwei eindimensionalen Faltungskern-Bilder für den aktuellen separablen 2D-Convolution-Filter. Das Zeilenbild ist in ''row'' platziert und das Spaltenbild ist in ''column'' platziert, laut den Spezifikationen in ''format'' und ''_type''. (In der momentanen Implementation wird ''span'' in keiner Art und Weise beeinflusst.) Keine Pixeltransferoperation (gesetzt mit [[glPixelTransfer]]) werden auf die Bilder verarbeitet, aber die relevanten Pixelspeicher-Modes (gesetzt mit [[glPixelStore]]) werden angewendet.
-''row'' enthält dabei die Spaltenwerte und ''column'' die Zeilenwerte des Filters.
+Farbkomponenten, die in ''format'' vorkommen, aber nicht im internen Format der Filter auftauchen, werden als 0 zurückgegeben. Die Zuweisungen der internen Farbkomponenten an die Komponenten von ''format'' sind wie folgt :
 <br>
 == Hinweise ==
 Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
 Für ''row'' und ''column'' sollte zum Empfang der Daten genügend Speicher allokiert werden. Die Grösse des Speichers ist abhängig von den Parametern ''format'', ''_type'' und der Größe des Filters, welche via [[glGetConvolutionParameter]] mit den Parametern '''GL_CONVOLUTION_WIDTH''' (für die Länge von ''row'') und '''GL_CONVOLUTION_HEIGHT''' (für die Länge von ''column'') ermittelt werden kann.
 <br>
 == Fehlermeldungen ==
-'''GL_INVALID_ENUM''' wird generiert wenn ''target'', ''format'' oder ''type'' ein ungültiger Wert übergeben wurde.<br>
+'''GL_INVALID_ENUM''' wird generiert, wenn ''target'' nicht '''GL_SEPARABLE_2D''' ist.<br>
 '''GL_INVALID_OPERATION''' wird generiert wenn '''glGetSeparableFilter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
 <br>