glColorMaterial: Unterschied zwischen den Versionen
Flash (Diskussion | Beiträge) K (Offline Vorlage genutzt) |
Flash (Diskussion | Beiträge) (Version Hochgeladen) |
||
Zeile 1: | Zeile 1: | ||
− | + | = glColorMaterial = | |
+ | |||
+ | <br> | ||
+ | == Name == | ||
+ | '''glColorMaterial''' - bestimmt welche Materialeigenschaften sich auf die aktuelle Farbe auswirken. | ||
+ | |||
+ | <br> | ||
+ | == Delphi-Spezifikation == | ||
+ | procedure '''glColorMaterial'''(''face'': TGLenum; ''mode'': TGLenum); | ||
+ | |||
+ | <br> | ||
+ | == Parameter == | ||
+ | <table border=1 rules=all> | ||
+ | <tr> | ||
+ | <td>''face''</td> | ||
+ | <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> | ||
+ | '''Vorgabewert''' ist '''GL_FRONT_AND_BACK''' | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <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> | ||
+ | '''Vorgabewert''' ist '''GL_AMBIENT_AND_DIFFUSE'''</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | <br> | ||
+ | |||
+ | == Beschreibung == | ||
+ | '''glColorMaterial''' spezifiziert welche Materialeigenschaften sich auf die aktuelle Farbe auswirken sollen. <br> | ||
+ | Wenn '''GL_COLOR_MATERIAL''' aktiviert ist, beinflussen <br> | ||
+ | :die Eigenschaft/en die über ''mode'' angegeben wurden, <br> | ||
+ | :der Seite/n die über ''face'' gewählt wurden | ||
+ | die aktuelle Farbe über die ganze Zeit.<br> | ||
+ | '''GL_COLOR_MATERIAL''' kann über [[glEnable]]/[[glDisable]] und dem Token '''GL_COLOR_MATERIAL''' aktiviert bzw. deaktiviert werden.<br> | ||
+ | Als '''Vorgabewert''' ist es '''deaktiviert'''. | ||
+ | |||
+ | <br> | ||
+ | == 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. | ||
+ | |||
+ | <br> | ||
+ | == Fehlermeldungen == | ||
+ | GL_INVALID_ENUM wird generiert wenn ''face'' oder ''mode'' ein ungültiger Wert übergeben wurde.<br> | ||
+ | GL_INVALID_OPERATION wird generiert wenn '''glColorMaterial''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird. | ||
+ | |||
+ | <br> | ||
+ | == Zugehörige Wertrückgaben == | ||
+ | [[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_PARAMETER|GL_COLOR_MATERIAL_PARAMETER]]<br> | ||
+ | [[glGet]] mit Token [[glGet#GL_COLOR_MATERIAL_FACE|GL_COLOR_MATERIAL_FACE]]<br> | ||
+ | [[glIsEnabled]] mit Token GL_COLOR_MATERIAL | ||
+ | |||
+ | <br> | ||
+ | |||
+ | == Siehe auch == | ||
+ | [[glColor]], [[glEnable]], [[glLight]], [[glLightModel]], [[glMaterial]] |
Version vom 1. September 2004, 20:10 Uhr
Inhaltsverzeichnis
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 |
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 |
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 für einen Teil der Parameter 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.
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