glColorMaterial: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(→‎Parameter)
K (→‎Hinweise: WäHrend)
 
(8 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= glColorMaterial =
 
= glColorMaterial =
  
−
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
−
'''glColorMaterial''' - bestimmt welche Materialeigenschaften sich auf die aktuelle Farbe auswirken.
+
'''glColorMaterial''' - bestimmt, welche Materialeigenschaften sich auf die aktuelle Farbe auswirken.
 +
 
 +
 
  
−
<br>
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
 
  procedure '''glColorMaterial'''(''face'': TGLenum; ''mode'': TGLenum);
 
  procedure '''glColorMaterial'''(''face'': TGLenum; ''mode'': TGLenum);
  
−
<br>
+
 
 +
 
 
== Parameter ==
 
== Parameter ==
−
<table border=1 rules=all>
+
{| border="1" rules="all"
−
<tr>
+
! ''face''
−
<td>''face''</td>
+
| Gibt an, ob die Materialparameter der Vorderseite und/oder Rückseite die aktuelle Farbe beeinflussen sollen. Akzeptiert werden:<br>
−
<td>Gibt an, ob die Materialparameter der Vorderseite und/oder Rückseite die aktuelle Farbe beeinflussen sollen. Akzeptiert werden:<br>
 
 
'''GL_FRONT, GL_BACK,''' und '''GL_FRONT_AND_BACK'''<br>
 
'''GL_FRONT, GL_BACK,''' und '''GL_FRONT_AND_BACK'''<br>
 
'''Vorgabewert''' ist '''GL_FRONT_AND_BACK'''
 
'''Vorgabewert''' ist '''GL_FRONT_AND_BACK'''
−
</td>
+
|-
−
</tr>
+
! ''mode''
−
<tr>
+
| Gibt an, welche der verschiedenen Materialparameter sich auf die aktuelle Farbe auswirken soll. Akzeptiert werden: <br>
−
<td>''mode''</td>
 
−
<td>Gibt an, welche der verschiedenen Materialparameter sich auf die aktuelle Farbe auswirken soll. Akzeptiert werden: <br>
 
 
'''GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR,''' und '''GL_AMBIENT_AND_DIFFUSE'''<br>
 
'''GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR,''' und '''GL_AMBIENT_AND_DIFFUSE'''<br>
−
'''Vorgabewert''' ist '''GL_AMBIENT_AND_DIFFUSE'''</td>
+
'''Vorgabewert''' ist '''GL_AMBIENT_AND_DIFFUSE'''
−
</tr>
+
|}
−
</table>
+
 
  
−
<br>
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
−
'''glColorMaterial''' spezifiziert welche Materialeigenschaften sich auf die aktuelle Farbe auswirken sollen. <br>
+
'''glColorMaterial''' spezifiziert, welche Materialeigenschaften sich auf die aktuelle Farbe auswirken sollen. <br>
 
Wenn '''GL_COLOR_MATERIAL''' aktiviert ist, beinflussen <br>
 
Wenn '''GL_COLOR_MATERIAL''' aktiviert ist, beinflussen <br>
−
:die Eigenschaft/en die über ''mode'' angegeben wurden, <br>
+
:die Eigenschaft/en, die über ''mode'' angegeben wurden, <br>
−
:der Seite/n die über ''face'' gewählt wurden  
+
:der Seite/n, die über ''face'' gewählt wurden,
−
die aktuelle Farbe über die ganze Zeit.<br>
+
die aktuelle Farbe über die ganze Zeit.
−
'''GL_COLOR_MATERIAL''' kann über [[glEnable]]/[[glDisable]] und dem Token '''GL_COLOR_MATERIAL''' aktiviert bzw. deaktiviert werden.<br>
+
 
−
Als '''Vorgabewert''' ist es '''deaktiviert'''.
+
'''GL_COLOR_MATERIAL''' kann über [[glEnable]]/[[glDisable]] und dem Token '''GL_COLOR_MATERIAL''' aktiviert bzw. deaktiviert werden.
 +
Als Vorgabewert ist es deaktiviert.
 +
 
 +
 
  
−
<br>
 
 
== Hinweise ==
 
== Hinweise ==
−
'''glColorMaterial''' ermöglicht für einen Teil der Parameter diese für jeden [[Eckpunkt|Vertex]] direkt mit [[glColor]] zu ändern, ohne [[glMaterial]] extra aufzurufen. Wenn also nur ein Parameter aus dieser Teilmenge geändert werden soll, ist '''glColorMaterial''' dem Aufruf von [[glMaterial]] vorzuziehen.
+
'''glColorMaterial''' ermöglicht es für einen Teil der Materialparameter, diese für jeden [[Vertex]] direkt mit [[glColor]] zu ändern, ohne [[glMaterial]] extra aufzurufen. Wenn also nur ein Parameter aus dieser Teilmenge geändert werden soll, ist '''glColorMaterial''' dem Aufruf von [[glMaterial]] vorzuziehen.
 +
 
 +
Rufen Sie '''glColorMaterial''' auf, bevor Sie '''GL_COLOR_MATERIAL''' aktivieren (mittels [[glEnable]]).
 +
 
 +
[[glDrawElements]] kann die aktuelle Farbe undefiniert zurücklassen. Wenn während dieses undefinierten Zustandes '''glColorMaterial''' aktiviert wird, ist der Status der Beleuchtungsmaterialien, die mittels ''face'' und ''mode'' gewählt wurden, ebenfalls unbestimmt.
 +
 
 +
Ab GL Version 1.1 beeinflussen evaluierte Farbwerte das Ergebnis der Lichtberechnung so, als ob die aktuelle Farbe geändert worden wäre. Dabei werden aber keine Änderungen an den Beleuchtungsparametern durchgeführt.
  
−
<br>
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
−
GL_INVALID_ENUM wird generiert wenn ''face'' oder ''mode'' ein ungültiger Wert übergeben wurde.<br>
+
'''GL_INVALID_ENUM''' wird generiert, wenn ''face'' oder ''mode'' ein ungültiger Wert übergeben wurde.
−
GL_INVALID_OPERATION wird generiert wenn '''glColorMaterial''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
+
 
 +
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glColorMaterial''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird.
 +
 
 +
 
 +
 
  
−
<br>
 
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
−
[[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_PARAMETER|GL_COLOR_MATERIAL_PARAMETER]]<br>
+
[[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_PARAMETER|GL_COLOR_MATERIAL_PARAMETER]]
−
[[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_FACE|GL_COLOR_MATERIAL_FACE]]<br>
+
 
 +
[[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_FACE|GL_COLOR_MATERIAL_FACE]]
 +
 
 
[[glIsEnabled]] mit Token GL_COLOR_MATERIAL
 
[[glIsEnabled]] mit Token GL_COLOR_MATERIAL
  
−
<br>
+
 
  
 
== Siehe auch ==
 
== Siehe auch ==
 
[[glColor]], [[glEnable]], [[glLight]], [[glLightModel]], [[glMaterial]]
 
[[glColor]], [[glEnable]], [[glLight]], [[glLightModel]], [[glMaterial]]
 +
 +
[[Materialsammlung]]
  
 
[[Kategorie:GL|ColorMaterial]]
 
[[Kategorie:GL|ColorMaterial]]
 +
[[Kategorie:GL1.0|ColorMaterial]]

Aktuelle Version vom 18. März 2012, 16:42 Uhr

glColorMaterial

Name

glColorMaterial - bestimmt, welche Materialeigenschaften sich auf die aktuelle Farbe auswirken.


Delphi-Spezifikation

procedure glColorMaterial(face: TGLenum; mode: TGLenum);


Parameter

face Gibt an, ob die Materialparameter der Vorderseite und/oder Rückseite die aktuelle Farbe beeinflussen sollen. Akzeptiert werden:

GL_FRONT, GL_BACK, und GL_FRONT_AND_BACK
Vorgabewert ist GL_FRONT_AND_BACK

mode Gibt an, welche der verschiedenen Materialparameter sich auf die aktuelle Farbe auswirken soll. Akzeptiert werden:

GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR, und GL_AMBIENT_AND_DIFFUSE
Vorgabewert ist GL_AMBIENT_AND_DIFFUSE


Beschreibung

glColorMaterial spezifiziert, welche Materialeigenschaften sich auf die aktuelle Farbe auswirken sollen.
Wenn GL_COLOR_MATERIAL aktiviert ist, beinflussen

die Eigenschaft/en, die über mode angegeben wurden,
der Seite/n, die über face gewählt wurden,

die aktuelle Farbe über die ganze Zeit.

GL_COLOR_MATERIAL kann über glEnable/glDisable und dem Token GL_COLOR_MATERIAL aktiviert bzw. deaktiviert werden. Als Vorgabewert ist es deaktiviert.


Hinweise

glColorMaterial ermöglicht es für einen Teil der Materialparameter, diese für jeden Vertex direkt mit glColor zu ändern, ohne glMaterial extra aufzurufen. Wenn also nur ein Parameter aus dieser Teilmenge geändert werden soll, ist glColorMaterial dem Aufruf von glMaterial vorzuziehen.

Rufen Sie glColorMaterial auf, bevor Sie GL_COLOR_MATERIAL aktivieren (mittels glEnable).

glDrawElements kann die aktuelle Farbe undefiniert zurücklassen. Wenn während dieses undefinierten Zustandes glColorMaterial aktiviert wird, ist der Status der Beleuchtungsmaterialien, die mittels face und mode gewählt wurden, ebenfalls unbestimmt.

Ab GL Version 1.1 beeinflussen evaluierte Farbwerte das Ergebnis der Lichtberechnung so, als ob die aktuelle Farbe geändert worden wäre. Dabei werden aber keine Änderungen an den Beleuchtungsparametern durchgeführt.

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn face oder mode ein ungültiger Wert übergeben wurde.

GL_INVALID_OPERATION wird generiert, wenn glColorMaterial innerhalb eines glBegin-glEnd-Blocks aufgerufen wird.



Zugehörige Wertrückgaben

glGet mit Token GL_COLOR_MATERIAL_PARAMETER

glGet mit Token GL_COLOR_MATERIAL_FACE

glIsEnabled mit Token GL_COLOR_MATERIAL


Siehe auch

glColor, glEnable, glLight, glLightModel, glMaterial

Materialsammlung

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