glShadeModel: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(→‎Fehlermeldungen)
K (Link auf Originaldoku)
 
(44 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
{{Excellent}}
 
=glShadeModel=
 
=glShadeModel=
  
 
==Syntax==
 
==Syntax==
−
  <b>procedure</b> glShadeModel (mode: GLenum); <b>stdcall</b>;
+
  procedure '''glShadeModel'''(''mode'': GLenum);
  
−
==Aufgabe==
+
==Parameter==
−
Legt fest ob Farbverläufe zwischen den einzelnen Eckpunkten des [[Primitiv]]en gebildet werden.
+
{| border="1" rules="all"
 +
! ''mode''
 +
| Bestimmt einen symbolischen Wert der eine Färbetechnik (Shadingtechnique) repräsentiert. Akzeptierte Werte sind '''GL_FLAT''' und '''GL_SMOOTH'''. <br>
 +
Der '''Vorgabewert''' ist '''GL_SMOOTH'''.
 +
|}
 +
 
 +
==Beschreibung==
 +
[[Bild:GlShadeModel_SMOOTH.jpg|thumb|right|Farbverlauf bei Smoothshading]]
 +
'''GL_SMOOTH'''
 +
: Es bilden sich Farbverläufe zwischen den Eckpunkten eines Primitiven.
 +
'''GL_FLAT'''
 +
: Das gesamte Primitiv erhält die Farbe die als letztes dem Polygon zugewiesen wurde.
 +
 
 +
 
 +
[[Primitive]] können entweder mittels Flat- oder Smoothshading gefärbt werden. Der Vorgabewert '''GL_SMOOTH''' sogt dafür, dass ein Farbverlauf über die Polygonfläche bei der [[Rasterisierung]] berechnet wird. Dies wird angewendet, wenn die Eckpunkte eines Polygons unterschiedlich gefärbt sein sollen.
 +
 
 +
Beim sogenannten [[Flat Shading]] legt ein Eckpunkt die Farbe des Polygons fest. Welcher [[Vertex]] das ist, kann der Tabelle entnommen werden. Für gewöhnlich ist dies der letzte Vertex eines Polygons oder Lineabschnittes. Die Ausnahme hierbei bilden einzelne Polygone, bei denen der erste Vertex die Farbe bestimmt. Flat Shading ist im allgemeinen schneller als Smooth Shading, da hierbei keine Farbinterpolation berechnet werden muss.
  
−
==Parameter==
+
Die Farbe eines Eckpunktes ist bei deaktiverter Beleuchtung nur von [[glColor]], bei aktivierter [[Beleuchtung]] zusätzlich noch von der Lichtberechnung abhängig.
−
Der Parameter mode kann einen der folgenden Werte enthalten:
+
<div align="center">
−
;GL_SMOOTH : Es bilden sich Farbverläufe zwischen den Eckpunkten eines Primitiven.
+
{| {{Prettytable_B1}}
−
;GL_FLAT : Das gesamte Primitiv erhält die Farbe eines Eckpunktes
+
|+ Farbberechnung bei Flat Shading
 +
! [[glBegin]] Parameter
 +
! farbbestimmender [[Vertex]] <br>für Polygon/Punkt/Linie i
 +
|-
 +
| GL_POLYGON
 +
| 1
 +
|-
 +
| GL_POINTS
 +
| i
 +
|-
 +
| GL_LINES
 +
| 2i
 +
|-
 +
| GL_LINE_STRIP
 +
| i + 1
 +
|-
 +
| GL_LINE_LOOP
 +
| i + 1 ; letzte Linie: 1
 +
|-
 +
| GL_TRIANGLES
 +
| 3i
 +
|-
 +
| GL_TRIANGLE_STRIP
 +
| i + 2
 +
|-
 +
| GL_TRIANGLE_FAN
 +
| i + 2
 +
|-
 +
| GL_QUADS
 +
| 4i
 +
|-
 +
| GL_QUAD_STRIP
 +
| 2i + 2
 +
|-
 +
|}
 +
</div>
  
−
==Hinweise==
+
==Beispiel==
−
GL_SMOOTH ist die Standart Einstellung.  
+
=== Farbfestlegung bei GL_FLAT ===
 +
==== Dreiecke ====
 +
<source lang="pascal">
 +
glShadeModel(GL_FLAT);
 +
// Zeichne Dreiecke
 +
glBegin( GL_TRIANGLES );
 +
  //Beginn des ersten Dreiecks -> i=1
 +
  glColor3f(1,0,0); //Kein Effekt
 +
  glVertex3f( 0.0, 1.0, 0.0 );
 +
  glColor3f(0,1,0); //Kein Effekt
 +
  glVertex3f( 1.0, -1.0, 0.0 );
 +
  glColor3f(0,0,1);
 +
  glVertex3f( -1.0, -1.0, 0.0 );  //i=1 -> 1*3=Vetex Nr 3 gibt die Frabe an
 +
  //-> dieses Dreick wird Blau (0,0,1)
 +
 +
  //Beginn des zweiten Dreiecks -> i=2
 +
  glColor3f(1,0,0); //Kein Effekt
 +
  glVertex3f( 3.0, 1.0, 0.0 );
 +
  glColor3f(0,1,0); //Kein Effekt
 +
  glVertex3f( 4.0, -1.0, 0.0 );
 +
  glColor3f(1,1,0);
 +
  glVertex3f( 2.0, -1.0, 0.0 ); //i=2 -> 2*3=Vetex Nr 6 gibt die Farbe an
 +
  //-> Dieses Dreieck wird Gelb (1,1,0)
 +
glEnd;
 +
</source>
 +
==== Polygon mit unbestimmter Anzahl an Eckpunkten ====
 +
<source lang="pascal">
 +
glShadeModel(GL_FLAT);
 +
// Zeichne Dreiecke
 +
glBegin( GL_POLYGON );
 +
  glColor3f(1,0,0); glVertex3f( 0.0, 0.0, 0.0 ); // Vertex Nr 1
 +
  // Ab hier ist die Farbe des Polygons schon festgelegt (Rot)
 +
  glColor3f(0,1,0); glVertex3f( 0.0, 1.0, 0.0 );
 +
  glColor3f(1,1,0); glVertex3f( 0.5, 1.5, 0.0 );
 +
  glColor3f(1,0,1); glVertex3f( 1.0, 1.0, 0.0 );
 +
  glColor3f(0,1,0); glVertex3f( 1.0, 0.0, 0.0 );
 +
glEnd;
 +
</source>
  
−
Die aktuelle Einstellung erhält man durch den Aufruf von [[glGet]] mit dem Parameter GL_SHADE_MODEL.
+
=== GL_FLAT vs. GL_SMOOTH ===
 +
<div align="center">
 +
{|{{Prettytable_B1}}
 +
!colspan="2" align="center" | Smooth Shading (GL_SMOOTH)
 +
|-
 +
|<source lang="pascal">
 +
glShadeModel(GL_SMOOTH);
 +
glBegin(GL_QUADS);
 +
  glColor3f(1, 0, 0); glVertex3f(0, 0, 0);
 +
  glColor3f(0, 1, 0); glVertex3f(1, 0, 0);
 +
  glColor3f(0, 0, 1); glVertex3f(1, 1, 0);
 +
  glColor3f(1, 1, 0); glVertex3f(0, 1, 0);
 +
glEnd;</source>
 +
|[[Bild:GlShadeModel_SMOOTH.jpg]]  
 +
|-
 +
!colspan="2" align="center" | Flat Shading (GL_FLAT)
 +
|-
 +
|<source lang="pascal">
 +
glShadeModel(GL_FLAT);
 +
glBegin(GL_QUADS);
 +
  glColor3f(1, 0, 0); glVertex3f(0, 0, 0);
 +
  glColor3f(0, 1, 0); glVertex3f(1, 0, 0);
 +
  glColor3f(0, 0, 1); glVertex3f(1, 1, 0);
 +
  glColor3f(1, 1, 0); glVertex3f(0, 1, 0);
 +
glEnd;</source>
 +
|[[Bild:GlShadeModel_FLAT.jpg]]
 +
|-
 +
|}
 +
</div>
  
 
==Fehlermeldungen==
 
==Fehlermeldungen==
−
'''GL_INVALID_ENUM''' Wird erstellt wenn ein anderer Wert als '''GL_FLAT''' oder '''GL_SMOOTH''' übergeben wurde.<br>
+
'''GL_INVALID_ENUM''' wird generiert, wenn ein anderer Wert als '''GL_FLAT''' oder '''GL_SMOOTH''' übergeben wurde.<br>
−
'''GL_INVLID_OPERATION''' Wird erzeugt wenn '''glShadeModel''' zwischen [[glBegin]] und glEnd aufgerufen wird.
+
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glShadeModel''' zwischen [[glBegin]] und [[glEnd]] aufgerufen wird.
 +
 
 +
==Zugehörige Wertrückgaben==
 +
[[glGet]] mit dem Parameter '''GL_SHADE_MODEL'''.
 +
 
 +
==Links==
 +
http://www.opengl.org/sdk/docs/man/xhtml/glShadeModel.xml<br>
  
 
==Siehe auch==
 
==Siehe auch==
Zeile 25: Zeile 148:
  
 
[[Kategorie:GL|ShadeModel]]
 
[[Kategorie:GL|ShadeModel]]
 +
[[Kategorie:GL1.0]]

Aktuelle Version vom 2. Mai 2009, 10:14 Uhr

Hinweis: Dieser Artikel wurde von den Benutzern des Wikis zum exzellenten Artikel berufen!
(weitere exzellente Artikel)
Excelent.jpg

glShadeModel

Syntax

procedure glShadeModel(mode: GLenum);

Parameter

mode Bestimmt einen symbolischen Wert der eine Färbetechnik (Shadingtechnique) repräsentiert. Akzeptierte Werte sind GL_FLAT und GL_SMOOTH.

Der Vorgabewert ist GL_SMOOTH.

Beschreibung

Farbverlauf bei Smoothshading

GL_SMOOTH

Es bilden sich Farbverläufe zwischen den Eckpunkten eines Primitiven.

GL_FLAT

Das gesamte Primitiv erhält die Farbe die als letztes dem Polygon zugewiesen wurde.


Primitive können entweder mittels Flat- oder Smoothshading gefärbt werden. Der Vorgabewert GL_SMOOTH sogt dafür, dass ein Farbverlauf über die Polygonfläche bei der Rasterisierung berechnet wird. Dies wird angewendet, wenn die Eckpunkte eines Polygons unterschiedlich gefärbt sein sollen.

Beim sogenannten Flat Shading legt ein Eckpunkt die Farbe des Polygons fest. Welcher Vertex das ist, kann der Tabelle entnommen werden. Für gewöhnlich ist dies der letzte Vertex eines Polygons oder Lineabschnittes. Die Ausnahme hierbei bilden einzelne Polygone, bei denen der erste Vertex die Farbe bestimmt. Flat Shading ist im allgemeinen schneller als Smooth Shading, da hierbei keine Farbinterpolation berechnet werden muss.

Die Farbe eines Eckpunktes ist bei deaktiverter Beleuchtung nur von glColor, bei aktivierter Beleuchtung zusätzlich noch von der Lichtberechnung abhängig.

Farbberechnung bei Flat Shading
glBegin Parameter farbbestimmender Vertex
für Polygon/Punkt/Linie i
GL_POLYGON 1
GL_POINTS i
GL_LINES 2i
GL_LINE_STRIP i + 1
GL_LINE_LOOP i + 1 ; letzte Linie: 1
GL_TRIANGLES 3i
GL_TRIANGLE_STRIP i + 2
GL_TRIANGLE_FAN i + 2
GL_QUADS 4i
GL_QUAD_STRIP 2i + 2

Beispiel

Farbfestlegung bei GL_FLAT

Dreiecke

 glShadeModel(GL_FLAT);
 // Zeichne Dreiecke
 glBegin( GL_TRIANGLES );
   //Beginn des ersten Dreiecks -> i=1
   glColor3f(1,0,0); //Kein Effekt
   glVertex3f( 0.0, 1.0, 0.0 );
   glColor3f(0,1,0); //Kein Effekt
   glVertex3f( 1.0, -1.0, 0.0 );
   glColor3f(0,0,1);
   glVertex3f( -1.0, -1.0, 0.0 );  //i=1 -> 1*3=Vetex Nr 3 gibt die Frabe an
   //-> dieses Dreick wird Blau (0,0,1)
 
   //Beginn des zweiten Dreiecks -> i=2
   glColor3f(1,0,0); //Kein Effekt
   glVertex3f( 3.0, 1.0, 0.0 );
   glColor3f(0,1,0); //Kein Effekt
   glVertex3f( 4.0, -1.0, 0.0 );
   glColor3f(1,1,0);
   glVertex3f( 2.0, -1.0, 0.0 ); //i=2 -> 2*3=Vetex Nr 6 gibt die Farbe an
   //-> Dieses Dreieck wird Gelb (1,1,0)
 glEnd;

Polygon mit unbestimmter Anzahl an Eckpunkten

 glShadeModel(GL_FLAT);
 // Zeichne Dreiecke
 glBegin( GL_POLYGON );
   glColor3f(1,0,0); glVertex3f( 0.0, 0.0, 0.0 ); // Vertex Nr 1
   // Ab hier ist die Farbe des Polygons schon festgelegt (Rot)
   glColor3f(0,1,0); glVertex3f( 0.0, 1.0, 0.0 );
   glColor3f(1,1,0); glVertex3f( 0.5, 1.5, 0.0 );
   glColor3f(1,0,1); glVertex3f( 1.0, 1.0, 0.0 );
   glColor3f(0,1,0); glVertex3f( 1.0, 0.0, 0.0 );
 glEnd;

GL_FLAT vs. GL_SMOOTH

Smooth Shading (GL_SMOOTH) 
 glShadeModel(GL_SMOOTH); 
 glBegin(GL_QUADS);
   glColor3f(1, 0, 0); glVertex3f(0, 0, 0);
   glColor3f(0, 1, 0); glVertex3f(1, 0, 0);
   glColor3f(0, 0, 1); glVertex3f(1, 1, 0);
   glColor3f(1, 1, 0); glVertex3f(0, 1, 0);
 glEnd;
GlShadeModel SMOOTH.jpg
Flat Shading (GL_FLAT) 
 glShadeModel(GL_FLAT); 
 glBegin(GL_QUADS);
   glColor3f(1, 0, 0); glVertex3f(0, 0, 0);
   glColor3f(0, 1, 0); glVertex3f(1, 0, 0);
   glColor3f(0, 0, 1); glVertex3f(1, 1, 0);
   glColor3f(1, 1, 0); glVertex3f(0, 1, 0);
 glEnd;
GlShadeModel FLAT.jpg

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn ein anderer Wert als GL_FLAT oder GL_SMOOTH übergeben wurde.
GL_INVALID_OPERATION wird generiert, wenn glShadeModel zwischen glBegin und glEnd aufgerufen wird.

Zugehörige Wertrückgaben

glGet mit dem Parameter GL_SHADE_MODEL.

Links

http://www.opengl.org/sdk/docs/man/xhtml/glShadeModel.xml

Siehe auch

glColor, glLight, glLightModel, glBegin

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