glGetColorTableParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(neu erstellt)
 
(an manpages angepasst)
Zeile 3: Zeile 3:
 
<br>
 
<br>
 
== Name ==
 
== Name ==
−
'''glGetColorTableParameter''' - dient zur Abfrage der verschiedenen Farbtabellen-Parameter.
+
'''glGetColorTableParameter''' - dient zur Abfrage der verschiedenen Farblookuptabellen-Parameter.
  
 
<br>
 
<br>
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
−
  procedure '''glGetColorTableParameterfv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLfloat);
+
  procedure '''glGetColorTableParameterfv'''(''target'': TGLenum; ''pname'': TGLenum;
−
  procedure '''glGetColorTableParameteriv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLint);
+
                                      ''params'': PGLfloat);
 +
  procedure '''glGetColorTableParameteriv'''(''target'': TGLenum; ''pname'': TGLenum;
 +
                                      ''params'': PGLint);
  
 
<br>
 
<br>
Zeile 20: Zeile 22:
 
|-
 
|-
 
! ''params''
 
! ''params''
−
| Liefert den angeforderten Farbtabellen-Parameter.
+
| Ein Zeiger auf ein Array, indem die Parameterwerte abgespeichert werden.
 
|}
 
|}
  
Zeile 26: Zeile 28:
  
 
== Beschreibung ==  
 
== Beschreibung ==  
−
'''glGetColorTableParameter''' liefert über die Rückgabevariable ''params'' den Wert der Farbtabellen-Eigenschaft, die mit ''pname'' angegeben wurde.<br>
+
Liefert die konkreten Parameter zur Farbtabelle ''target''.
  
−
Folgende Eigenschaften sind abfragbar :
+
Wenn ''pname'' auf '''GL_COLOR_TABLE_SCALE''' oder '''GL_COLOR_TABLE_BIAS''' gesetzt ist, gibt '''glGetColorTableParameter''' die Skalierung- oder Bias-Parameter für die durch ''target'' definierte Farbtabelle zurück. Für diese Abfragen muss ''target'' auf '''GL_COLOR_TABLE''', '''GL_POST_CONVOLUTION_COLOR_TABLE''' oder '''GL_POST_COLOR_MATRIX_COLOR_TABLE''' gesetzt sein und ''params'' auf ein Array von vier Elementen zeigen, welches die Skalierungs- und Biasfaktoren für Rot, Grün, Blau und Alpha in dieser Reihenfolge erhält.
  
−
'''GL_COLOR_TABLE_SCALE'''
+
'''glGetColorTableParameter''' kann auch benutzt werden um die Grössen- und Formatparameter einer Farbtabelle zu erhalten. Setze für diese Abfragen ''target'' entweder auf das Farbtabellenziel oder das Proxy-Farbtabellenziel. Die Grössen- und Formatparameter werden durch [[glColorTable]] gesetzt.
−
: Liefert den Skalierungsfaktor für die Farbtabelle.
 
  
−
'''GL_COLOR_TABLE_BIAS'''
+
Die folgende Tabelle listet die Format- und Grössenparameter, die abgefragt werden können, auf. Für jede symbolische Konstante, die unten für ''pname'' aufgelistet ist, muss ''params'' auf ein Array der gegebenen Länge zeigen und die angegebenen Werte empfangen.
−
: Liefert den Biaswert für die Farbtabelle.
 
  
 
'''GL_COLOR_TABLE_FORMAT'''
 
'''GL_COLOR_TABLE_FORMAT'''
−
: Liefert das interne Format für die Farbtabelle.
+
: Internes Format (z.B. '''GL_RGBA''')
  
 
'''GL_COLOR_TABLE_WIDTH'''
 
'''GL_COLOR_TABLE_WIDTH'''
−
: Liefert die Breite der Farbtabelle.
+
: Anzahl der Tabellenlemente.
  
 
'''GL_COLOR_TABLE_RED_SIZE'''
 
'''GL_COLOR_TABLE_RED_SIZE'''
−
: Liefert die Auflösung der roten Farbtabellen-Komponente in Bit.
+
: Grösse der roten Komponente, in Bits.
  
 
'''GL_COLOR_TABLE_GREEN_SIZE'''
 
'''GL_COLOR_TABLE_GREEN_SIZE'''
−
: Liefert die Auflösung der grünen Farbtabellen-Komponente in Bit.
+
: Grösse der grünen Komponente.
  
 
'''GL_COLOR_TABLE_BLUE_SIZE'''
 
'''GL_COLOR_TABLE_BLUE_SIZE'''
−
: Liefert die Auflösung der blauen Farbtabellen-Komponente in Bit.
+
: Grösse der blauen Komponente.
  
 
'''GL_COLOR_TABLE_ALPHA_SIZE'''
 
'''GL_COLOR_TABLE_ALPHA_SIZE'''
−
: Liefert die Auflösung der Alpha-Komponente der Farbtabelle in Bit.
+
: Grösse der Alpha-Komponente.
  
 
'''GL_COLOR_TABLE_LUMINANCE_SIZE'''
 
'''GL_COLOR_TABLE_LUMINANCE_SIZE'''
−
: Liefert die Auflösung der Helligkeits-Komponente der Farbtabelle in Bit.
+
: Grösse der Helligkeits-Komponente.
  
 
'''GL_COLOR_TABLE_INTENSITY_SIZE'''
 
'''GL_COLOR_TABLE_INTENSITY_SIZE'''
−
: Liefert die Auflösung der Intensitäts-Komponente der Farbtabelle in Bit.
+
: Grösse der Intensitäts-Komponente.
  
 
<br>
 
<br>
 
== Hinweise ==
 
== Hinweise ==
 +
Die Funktion '''glGetColorTableParameter''' ist erst ab OpenGL Version 1.2 verfügbar.
 +
 +
'''glGetColorTableParameter''' ist nur verfügbar, falls '''GL_ARB_imaging''' beim Aufruf der Funktion [[glGetString]] mit dem Argument '''GL_EXTENSIONS''' zurückgegeben wird.
 +
 
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.
  

Version vom 10. April 2006, 14:52 Uhr

glGetColorTableParameter


Name

glGetColorTableParameter - dient zur Abfrage der verschiedenen Farblookuptabellen-Parameter.


Delphi-Spezifikation

procedure glGetColorTableParameterfv(target: TGLenum; pname: TGLenum;
                                     params: PGLfloat);
procedure glGetColorTableParameteriv(target: TGLenum; pname: TGLenum;
                                     params: PGLint);


Parameter

target Gibt den symbolischen Namen der Farbtabelle an, dessen Parameter abgefragt werden sollen. Erlaubte Werte sind GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE, GL_PROXY_COLOR_TABLE, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE oder GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE.
pname Gibt den symbolischen Namen des Farbtabellen-Parameters an, der abgefragt werden soll. Akzeptierte Werte sind GL_COLOR_TABLE_SCALE, GL_COLOR_TABLE_BIAS, GL_COLOR_TABLE_FORMAT, GL_COLOR_TABLE_WIDTH, GL_COLOR_TABLE_RED_SIZE, GL_COLOR_TABLE_GREEN_SIZE, GL_COLOR_TABLE_BLUE_SIZE, GL_COLOR_TABLE_ALPHA_SIZE, GL_COLOR_TABLE_LUMINANCE_SIZE und GL_COLOR_TABLE_INTENSITY_SIZE.
params Ein Zeiger auf ein Array, indem die Parameterwerte abgespeichert werden.


Beschreibung

Liefert die konkreten Parameter zur Farbtabelle target.

Wenn pname auf GL_COLOR_TABLE_SCALE oder GL_COLOR_TABLE_BIAS gesetzt ist, gibt glGetColorTableParameter die Skalierung- oder Bias-Parameter für die durch target definierte Farbtabelle zurück. Für diese Abfragen muss target auf GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE oder GL_POST_COLOR_MATRIX_COLOR_TABLE gesetzt sein und params auf ein Array von vier Elementen zeigen, welches die Skalierungs- und Biasfaktoren für Rot, Grün, Blau und Alpha in dieser Reihenfolge erhält.

glGetColorTableParameter kann auch benutzt werden um die Grössen- und Formatparameter einer Farbtabelle zu erhalten. Setze für diese Abfragen target entweder auf das Farbtabellenziel oder das Proxy-Farbtabellenziel. Die Grössen- und Formatparameter werden durch glColorTable gesetzt.

Die folgende Tabelle listet die Format- und Grössenparameter, die abgefragt werden können, auf. Für jede symbolische Konstante, die unten für pname aufgelistet ist, muss params auf ein Array der gegebenen Länge zeigen und die angegebenen Werte empfangen.

GL_COLOR_TABLE_FORMAT

Internes Format (z.B. GL_RGBA)

GL_COLOR_TABLE_WIDTH

Anzahl der Tabellenlemente.

GL_COLOR_TABLE_RED_SIZE

Grösse der roten Komponente, in Bits.

GL_COLOR_TABLE_GREEN_SIZE

Grösse der grünen Komponente.

GL_COLOR_TABLE_BLUE_SIZE

Grösse der blauen Komponente.

GL_COLOR_TABLE_ALPHA_SIZE

Grösse der Alpha-Komponente.

GL_COLOR_TABLE_LUMINANCE_SIZE

Grösse der Helligkeits-Komponente.

GL_COLOR_TABLE_INTENSITY_SIZE

Grösse der Intensitäts-Komponente.


Hinweise

Die Funktion glGetColorTableParameter ist erst ab OpenGL Version 1.2 verfügbar.

glGetColorTableParameter ist nur verfügbar, falls GL_ARB_imaging beim Aufruf der Funktion glGetString mit dem Argument GL_EXTENSIONS zurückgegeben wird.

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_OPERATION wird generiert wenn glGetColorTableParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Siehe auch

glColorSubTable, glColorTable, glColorTableParameter, glCopyColorSubTable, glCopyColorTable, glGetColorTable

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