DGL Wiki - Benutzerbeiträge [de]

glLoadMatrix

2004-07-25T18:20:35Z

Johannes: =Beispiel-Quelltext=

= glLoadMatrix =

 
== glLoadMatrix ==
----
'''glLoadMatrix''' - ersetzt die aktuelle Matrix durch eine Beliebige Matrix.

 
== Delphi-Spezifikation ==
----
'''procedure''' glLoadMatrixd('''const''' ''m'': PGLdouble); 
'''procedure''' glLoadMatrixf('''const''' ''m'': PGLfloat);

 
== Parameter ==
----
<table border=1 rules=all>
<tr>
<td>''m''</td>
<td>Zeiger auf eine 4x4 Matrix welche die aktuelle Matrix ersetzen soll.</td>
</tr>
</table>

 
== Beschreibung ==
----
'''glLoadMatrix''' ersetzt die aktuelle Matrix durch die, über ''m'' definierte. 
Die aktuelle Matrix ist entweder die Projektionsmatrix, die Modelviewmatrix oder die Texturematrix (je nach aktuellem Matrixmodus ([[glMatrixMode]]) ). 
Der Parameter ''m'' zeigt auf eine 4x4 Matrix welche spaltenweise Fließkommazahlen mit einfacher oder doppelter Genauigkeit enthält (single oder double). 
Eine solche Matrix würde so gespeichert werden:
===Beispiel-Quelltext===
{| border="1"
|+Als Ersatzt für [[glPushMatrix]] / [[glPopMatrix]]:
|
type
TVektor = record X,Y,Z,W:glFloat end;
TMatrix = array[(mat_XAchse,mat_YAchse,mat_ZAchse,mat_Position)] of TVertex;

var
TempMatrix:TMatrix;
begin
glClearColor(0,0,0,0);
glClear(GL_COLOR_BUFFER_BIT or GL_DEPTH_BUFFER_BIT);
glMatrixMode(GL_MODELVIEW);
glLoadIdentity;

glTranslatef(-0.8,-0.5,0); //Vorgebene Startposition
glGetFloatv(GL_MODELVIEW_MATRIX,@TempMatrix);//Matrix wird gespeichert

{Rotes Dreieck}
glColor3f(1,0,0);
gltranslatef(1,0,0);
glbegin(GL_TRIANGLES);
glvertex3f(1,0 ,-2);
glvertex3f(0,1 ,-2);
glvertex3f(0,0 ,-2);
glend;
glLoadMatrixf(@TempMatrix);//Gespeicherte Matrix wird wieder geladen

{Grünes Dreieck}
glColor3f(0,1,0);
glbegin(GL_TRIANGLES);
glvertex3f(1,0 ,-2);
glvertex3f(0,1 ,-2);
glvertex3f(0,0 ,-2);
glend;
end;
|}

 

== Fehlermeldungen ==
----
GL_INVALID_OPERATION wird generiert wenn glLoadMatrix innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
 
== Zugehörige Wertrückgaben ==
----
[[glGet]] mit Token GL_MATRIX_MODE 
[[glGet]] mit Token GL_MODELVIEW_MATRIX 
[[glGet]] mit Token GL_PROJECTION_MATRIX 
[[glGet]] mit Token GL_TEXTURE_MATRIX 

 
== Siehe auch ==
----
[[glLoadIdentity]], [[glMatrixMode]], [[glMultMatrix]], [[glPushMatrix]]

Diskussion:Tiefentest

2004-07-17T09:16:59Z

Johannes:

Wenn man Transparente Objekte verwendet sieht man doch gar nicht die Elemente dahinter, oder!?
Das Element im Vordergrund wird nur mit dem Bereits im Framebuffer liegenden Farbwerten verblendet. Wenn man denkt, man sieht durch ein Objekt durch, ist dies nur eine Täuschung. In Wirklichkeit hat das Weiter vorn stehende Objekt nur Partiell die Farbe des Dahinterliegenden Objekts angenommen.

Mein Nachhacken spielt auf den letzten Absatz an.

Naja ich denk das ist so gemeint wenn du ein transparentes Objekt in den Vordergrund zeichnest und danach ein anderes (transparentes oder nicht transparentes) Objekt "dahinter" zeicjnest dann wird doch durch den Tiefenbuffer das Objekt nicht angezeigt, da das transparente Objekt schon den Tiefenpuffer mit höheren Werten beschriebn hat.. Das kann man dadurch ändern, das transparente Objekte nicht auf den Tiefenpuffer schreiben (aber von ihm lesen)

Shader (historisch)

2004-07-13T11:21:13Z

Johannes: =Ressourcen=

= Shader =

== Konzept ==
----
Die traditionelle Funktionspipeline der OpenGL ist eine feste Pipeline, auf die man nur beschränkt Einfluß nehmen kann (durch Statechanges), man hat also an sehr vielen Stellen starre Vorgaben die nur minimal anpassbar sind. So sind z.B. Farbberechnungen oder die Beleuchtung fest definiert und nur wenige ihrere Attribute können variiert werden. Zurückzuführen war/ist dieser Umstand v.a. darauf dass Grafikkarten bis vor kurzem nur feste Berechnungseinheiten besaßen, die man auch nicht programmieren konnte. (siehe z.B. die fest verdrahtete T&L-Einheit der ersten GeForce-Karten)

Allerdings haben vor einigen Jahren Grafikkarten mit teilweise programmierbaren Einheiten (erst waren dies recht eingeschränkt programmierbare Vertexeinheiten, inzwsichen sind selbst die Fragmentprozessoren recht frei programmierbar, siehe z.B. VS/PS3.0) Einzug in den Consumermarkt gefunden, und so war es nötig OpenGL auch um programmierbare Pipeline-Teile zu erweitern, und die neuste Inkarnation sind dabei Shader.

Seit neustem gibt es neben den herstellerabhängigen Funktionen zum Programmieren der Vertex- und Fragmentprozessoren auch standardisierte Erweiterungen. Zuerst waren dies GL_VERTEX_PROGRAM_ARB/GL_FRAGMENT_PROGRAM_ARB, mit denen man diese beiden Prozessoren (sofern auf der Grafikkarte vorhanden) in einer an Assembler (recht primitiv, mit nur wenigen Befehlen, alle auf Grafikprogrammierung ausgelegt) angelehnten Sprache programmieren konnte. Man schreibt dazu also ein Programm dass den entsprechenden Teil der festen Funktionspipeline ersetzt und führt dieses dann auf der Grafikkarte aus. So kann man für Vertices und Fragmente komplett eigene Berechnungen durchführen. Allerdings ist eine solche Assemblersprache nicht nur recht eingeschränkt, sondern auch recht kryptisch und daher nicht zuletzt (besonders bei großen Programmen) schlecht zu warten. Also hat OpenGL hier genau wie die normalen Programmiersprachen als nächste Iteration für programmierbare Teile der Pipeline eine ''Hochsprache'' verpasst bekommen, namentlich als '''glSlang''' bekannt.

Hiessen die Programme unter der Assemblersprache noch (passen) Vertexprogramm bzw. Fragmentprogramm, so hat man sich unter glSlang etwas angepasst (an D3D) und nennt diese nun '''Vertexshader''' bzw. '''Fragmentshader''' (Shader bedeutet "schattieren", stimmt also nicht 100%ig).

Diese Shader kann man wie angesprochen nun in einer '''an C angelehnten Hochsprache''' schreiben, was zur Folge hat dass sich die Programmierung der entsprechenden Grafikprozessoren reichlich vereinfacht hat, und ausserdem hat man glSlang um recht viele Dinge erweitert die in der Assemblersprache nicht (oder nicht gerade einfach) möglich waren. Darunter Schleifen, Funktionen, uvm.

 
== Voraussetzungen ==
----
Shader sind ein recht neues Konzept unter OpenGL und mit glSlang wollte man eine reichlich zukunftsorientierte Hochsprache für Shader schaffen. Deshalb hat man gleich auf alte Shaderversionen verzichtet und setzt '''Vertexshader und Pixelshader in der Version 2.0''' voraus, die bei ATI ab der Radeon 9500 und bei NVidia ab der Geforce FX zur Verfügung stehen.

Momentan stellt glSlang eine Erweiterung zur OpenGL-Version 1.5 dar, also benötigt man neben der oben erwähnten Hardware auch noch passende Treiber und OpenGL-Header. Für Delphi bietet die DGL einen eigenen Header an, der diese Funktionalität mitbringt ([http://www.delphigl.com/do_download.php?f=12000 Download]).

 
== Extensions ==
----
<ul>
<li>[[GL_ARB_Shader_Objects]]</li>
Definiert die API-Aufrufe die zum Erstellen, Kompilieren, Linken, Anhängen und Aktivieren von Shader- und Programmobjekten nötig sind.
<li>[[GL_ARB_Vertex_Shader]]</li>
Fügt der OpenGL Programmierbarkeit auf Vertexebene hinzu.
<li>[[GL_ARB_Fragment_Shader]]</li>
Fügt der OpenGL Programmierbarkeit auf Fragmentebene hinzu.
<li>[[GL_ARB_Shading_Language_100]]</li>
Gibt die unterstützte Version von glSlang an, momentan 1.00.
</ul>

 
== Funktionen ==
----
<ul>
<li>[[glAttachObjectARB]]</li>
<li>[[glBindAttribLocationARB]]</li>
<li>[[glCompileShaderARB]]</li>
<li>[[glCreateProgramObjectARB]]</li>
<li>[[glCreateShaderObjectARB]]</li>
<li>[[glDeleteObjectARB]]</li>
<li>[[glDetachObjectARB]]</li>
<li>[[glEnableVertexAttribArrayARB]]</li>
<li>[[glGetActiveAttribARB]]</li>
<li>[[glGetActiveUniformARB]]</li>
<li>[[glGetAttachedObjectsARB]]</li>
<li>[[glGetAttribLocationARB]]</li>
<li>[[glGetHandleARB]]</li>
<li>[[glGetInfoLogARB]]</li>
<li>[[glGetObjectParameterARB]]</li>
<li>[[glGetShaderSourceARB]]</li>
<li>[[glGetUniformARB]]</li>
<li>[[glGetUnifromLocationARB]]</li>
<li>[[glGetVertexAttribARB]]</li>
<li>[[glGetVertexAttribPointervARB]]</li>
<li>[[glLinkProgramARB]]</li>
<li>[[glShaderSourceARB]]</li>
<li>[[glUniformARB]]</li>
<li>[[glUseProgramObjectARB]]</li>
<li>[[glValidateProgramARB]]</li>
<li>[[glVertexAttribARB]]</li>
<li>[[glVertexAttribPointerARB]]</li>
</ul>

 

== Ressourcen ==
----
<ul>
<li>[http://www.delphigl.com/do_download.php?f=12000 OpenGL1.5-Header für Delphi (mit glSlang-Extensions)]</li>
<li>[http://www.delphigl.com/script/do_show.php?name=glslang&action=2 glSlang-Tutorial auf DGL] (Deutsch)</li>
<li>[http://www.opengl.org/documentation/oglsl.html Offizielle glSlang-Dokumentation] (Englisch)</li>
<li>[http://developer.3dlabs.com/openGL2/index.htm Offizielle OpenGL2/OpenGL HLSL-Seiten] (Englisch)</li>
<li>[http://www.clockworkcoders.com/oglsl glSlang Tutorials] (Englisch)</li>
<li>[http://www.shadertech.com/ ShaderTech - GPU Programming] (Englisch)</li>
</ul>

Diskussion:Funktionsvorlage

2004-07-12T12:14:39Z

Johannes:

wie wäre es wenn man noch ein Beispiel zu jeder Funktion hinzufügen könnte (wie das z.B. bei begin end und bei glvertex* schion der fall ist) (bei zussamenhängenden funktion wie die ganzen list und texture funktionen kann man ja auf ein Beispiel verlinken)

Hilfe:Bearbeitungshilfe

2004-07-11T14:50:54Z

Johannes:

==Einfache Textgestalltung==

===Texthervorhebung===

{| border=1 cellspacing=0
! Bezeichnung
! Wiki Syntax
! HTML Code
! So sieht es aus
|-

|Fetter Text
| <nowiki>'''Text'''</nowiki>
| <nowiki>Text</nowiki>
|'''Text'''
|-

|Kursiver Text
| <nowiki>''Text''</nowiki>
| <nowiki>Text</nowiki>
|''Text''
|-

|Unterstrichener Text
|
| <nowiki>Text</nowiki>
| Text
|-

|Durchgestrichener Text
|
| <nowiki><strike>Text</strike></nowiki>
| <strike>Text</strike>
|-
|}
Nach Möglichkeit sollte man die Wikischreibweise nehemen.

===Überschriften===

Eine Überschirft wird mit '''<nowiki>==</nowiki>''' umgeben.
Möchte man zu einer Überschirft eine Unterüberschirft bilden so verwendet man ein = mehr.
'''Beispiel''':
{| border=1 cellspacing=0
|<nowiki>==Überschrift==</nowiki> 
<nowiki>===UnterüberschirftA===</nowiki> 
<nowiki>====Unter-Unterüberschirft1====</nowiki> 
<nowiki>====Unter-Unterüberschirft2====</nowiki> 
<nowiki>===UnterüberschirftB===</nowiki>
|}
Gibt es mehere Überschriften, wird automatisch ein Inhaltsverzeichnis gebildet.

 

==Absätze und der Zeilenumbruch==
Die Wiki-Software beginnt normalerweise nur einen neuen Absatz wenn eine Zeile freigelassen wird.
Möchte man die Absätze weiter auseinander, oder möchte einen manuellen Zeilenumbruch haben, so kann der HTML Tag '''<nowiki> </nowiki>''' genutzt werden

{| border=1 cellspacing=0
! Text im Editor
! Vorschau
|-
| Hallo, hier wird das Absatzzeichen ignoriert. 
Das ist ein <nowiki> </nowiki> manueller Umbruch.
| Hallo,
hier wird das Absatzzeichen ignoriert.

Das ist ein manueller Umbruch.
|}

 
==Unformatierter Text==
Es gibt zwei Arten Text nicht formatieren zu lassen.

===Absolut unformatierter Text===
Soll weder HTML noch Wiki Syntay greifen so wird der Text mit nowiki Tags umschlossen:
{| border=1 cellspacing=0
! Im Editor
! So sieht es aus
|-
|<nowiki><nowiki> Unformatierter ''Text'' </nowiki></nowiki>
|<nowiki> Unformatierter ''Text'' </nowiki>
|}

===Kein Wiki(für Quelltext)===
Möchte man etwa Delphi-Quelltext anzeigen so kann man dies tun indem man ein '''Leerzeichen''' dem Text vorranstellt und mit HTML formatiert. 
Ein nützliches Tool mit dem man unter anderem direkt aus der IDE HTML Code exportieren kann ist: http://www.gexperts.org/

{| border=1 cellspacing=0
! Im Editor
|
<nowiki>procedure Text;</nowiki> 
<nowiki>begin</nowiki> 
<nowiki>MyArray[Index] := Int2</nowiki>
|-
! So sieht es aus
|
procedure Text;
begin
MyArray[Index] := Int2

|}

 

==Links==
{| border=1 cellspacing=0
! Beschreibung
! Im Editor
! So sieht es aus
! Hinweise
|-
|Link inerhalb des Wikis
| <nowiki>[[glEnd]], [[glTranslate]]f]</nowiki>
| [[glEnd]], [[glTranslate]]f
| Exsistiert das Thema noch nicht erscheint der Link automatisch rot. Steht etwas direkt hinter dem Link wird es ebenfalls als Link dargestellt.
|-

|Link inerhalb des Wikis, mit einer anderen Bezeichnung
|<nowiki>[[Funktions_Anhang|Suffixe]]</nowiki>
|
|[[Funktions_Anhang|Suffixe]]
|-

| externer Link
| <nowiki>http://www.delphigl.com</nowiki>
|http://www.delphigl.com
| Ein Link brauch einfach nur vollständig angebenen werden.(mit http:\\)
|-

| Mehere externe Links
|<nowiki>[http://delphigl.com], [http://www.opengl.org]</nowiki>
|[http://delphigl.com], [http://www.opengl.org]
| Eine einfache eckige Klammer um den vollständigen Link
|-

| externer Link mit anderer Bezeichnung
|<nowiki>[http://delphigl.com DGL]</nowiki>
|[http://delphigl.com DGL],
| Eine einfache eckige Klammer um den vollständigen Link inklusive alternativ Text
|-

|}

 

==Tabellen==
Eine Tabelle kann entweder mit Hilfe der Wiki Syntax oder mit HTML erstellt werden.

===Eine Einfache Tabelle===
{| border="1" cellspacing="0"
!Wiki Syntax A
!Wiki Syntax B
!HTML Code
!So sieht es aus
|-
|<nowiki>{|</nowiki> 
<nowiki>|A1</nowiki> 
<nowiki>|B1</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>|A2</nowiki> 
<nowiki>|B2</nowiki> 
<nowiki>|}</nowiki>
|<nowiki>{|</nowiki> 
<nowiki>|A1 || B1</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>|A2 || B2</nowiki> 
<nowiki>|}</nowiki>
|<nowiki><table></nowiki> 
<nowiki><tr><td>A1</td><td>B1</td></tr></nowiki> 
<nowiki><tr><td>A2</td><td>B2</td></tr></nowiki> 
<nowiki></table></nowiki>
|
{|
|A1 || B1
|-
|A2 || B2
|}
|}

===Erweiterte Einstellungen===
Um eine Tabelle mehr zu modifizieren, können Einstellungen übergeben werden.
Eine Einstellung sieht so aus:

Name = "Wert"

Bei einer '''Wiki''' Tabelle können die Parameter hinter '''<nowiki>{|</nowiki>''' geschrieben werden.

Bei einer '''HTML''' Tabelle kommen diese zwischen '''<nowiki><table</nowiki>''' und '''<nowiki>></nowiki>'''.

{| border="1" cellspacing="0"
|+ Folgende Parameter stehen dabei zur Auswahl:
!Name
!Standart
!Beschreibung
|-
|border
|0
|Legt die Dicke des Rahmen fest.
|-
|cellspacing
|1
|Legt den Platz zwischen den einzelen Zellen fest.
|-
|align
|
|Legt fest wo sich die Tabelle befindet. Mögliche Werte sind: "right","center","left"
|}

'''Beispiel''':
{| border="1" cellspacing="0"
! Im Editor
! Vorschau
|-
|<nowiki>{| border="1" cellspacing="0" align="center"</nowiki> 
<nowiki>| B</nowiki> 
<nowiki>| ei</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>| s</nowiki> 
<nowiki>| p</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>| ie</nowiki> 
<nowiki>| l</nowiki> 
<nowiki>|}</nowiki>
|
{| border="1" cellspacing="0" align="center"
| B
| ei
|-
| s
| p
|-
| ie
| l
|}
|}

===Beschriftungen===
Möchte man das eine Zelle eine Bezeichnung beinhaltet verwendet man statt '''<nowiki>|</nowiki>''' einfach ein Ausrufezeichen ('''<nowiki>!</nowiki>''')

Möchte man hingen der Tabelle einen Namen geben schreibt man dieses mit folgenden Zeichen vorrangestellt '''<nowiki>|+</nowiki>''' unter '''<nowiki>{|</nowiki>'''.

'''Beispiel'''
{| border="1" cellspacing="0"
! Im Editor
! Vorschau
|-
|
<nowiki>{| border="1"</nowiki> 
<nowiki>|+ Tabellen Beispiel</nowiki> 
<nowiki>! Tabelle</nowiki> 
<nowiki>! A</nowiki> 
<nowiki>! B</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>! 1</nowiki> 
<nowiki>| A1</nowiki> 
<nowiki>| B1</nowiki> 
<nowiki>|-</nowiki> 
<nowiki>! 2</nowiki> 
<nowiki>| A2</nowiki> 
<nowiki>| B2</nowiki> 
<nowiki>|}</nowiki>
|
{| border="1"
|+ Tabellen Beispiel
! Tabelle
! A
! B
|-
! 1
| A1
| B1
|-
! 2
| A2
| B2
|}
|}
 

==Aufzählungen und Einrückungen==
Man kann Einrückungen und Aufzählungen erstellen in dem man an den Begin einer Zeile ein oder mehre Zeichen schreibt.
{| border=1 cellspacing=0
! Typ
! Zeichen
! Beispiel Code
! So sieht es aus
|-
|Einrückung
| '''<nowiki>:</nowiki>'''
|
<nowiki>Dies</nowiki> 
<nowiki>:Ist</nowiki> 
<nowiki>:ein</nowiki> 
<nowiki>::eingerückter</nowiki> 
<nowiki>:::Text</nowiki>
|
Dies
:Ist
:ein
::eingerückter
:::Text
|-
|Aufzählung
|'''<nowiki>#</nowiki>'''
|
<nowiki>#Zahlen</nowiki> 
<nowiki>##In richtiger Reinfolge</nowiki> 
<nowiki>##ganz automatisch</nowiki> 
<nowiki>#Keine Punke</nowiki>
|
#Zahlen
##In richtiger Reinfolge
##ganz automatisch
#Keine Punke
|-
|
Aufzählung mit Punkten
|'''<nowiki>*</nowiki>'''
|<nowiki>Aufzählung</nowiki> 
<nowiki>*Mit Punkten</nowiki> 
<nowiki>**Durch Sternzeichen</nowiki> 
<nowiki>**Die schön aussehen</nowiki> 
<nowiki>*Ohne Zahlen</nowiki> 
|
Aufzählung
*Mit Punkten
**Durch Sternzeichen
**Die schön aussehen
*Ohne Zahlen
|}
Naürilich kann man auch alle drei Aufzähltypen miteinander kombinieren.
 

== Siehe Auch ==
*[http://de.wikipedia.org/wiki/Wikipedia:Hilfe Wikipedia:Hilfe]
*[http://de.wikipedia.org/wiki/Wikipedia:Seite_bearbeiten Wikipedia:Seite bearbeiten]

glNewList

2004-07-10T14:03:17Z

Johannes: =GL_COMPILE_AND_EXECUTE=

= glNewList, glEndList =

 
== Name ==

'''glNewList, glEndList''' - Erstellt oder ersetzt eine [[Displaylisten|Displayliste]]

 
== Delphi-Spezifikation ==

procedure '''glNewList'''(''list'' : TGLuint; ''mode'' : TGLenum); 
procedure '''glEndList''';

 
== Parameter ==

<table border=1 rules=all>
<tr>
<td>''list''</td>
<td>Name der Displayliste.</td>
</tr>
<tr>
<td>''mode''</td>
<td>Gibt den Kompilierungsmodus an; gültig ist hier '''GL_COMPILE''' und '''GL_COMPILE_AND_EXECUTE'''.</td>
</tr>
</table>

 

== Beschreibung ==

[[Displaylisten]] sind eine Gruppe von OpenGL-Befehlen die für eine nachfolgende Ausführung gespeichert werden und werden mit dem Befehl '''glNewList''' erstellt. Alle nachfolgenden Befehle werden in der Displayliste abgelegt bis '''glEndList''' aufgerufen wird.

'''glNewList''' erhält dabei als erstes Argument einen positiven Integerwert der den eindeutigen Namen der Displayliste darstellt (Namen können mit [[glGenLists]] erstellt und mit [[glIsList]] geprüft werden. Das zweite Argument, ''mode'', ist eine symbolische Konstante die die folgenden Wert annehmen kann :

=== GL_COMPILE ===
Die Befehlewerden nur kompiliert.

=== GL_COMPILE_AND_EXECUTE ===
Die Befehle werden gleichzeitig zur Kompilierung auch ausgeführt.

Bestimmte Befehle werden übrigens nicht in die Displayliste kompiliert, sondern dort direkt ausgeführt, unabhängig vom Modus der Displayliste, darunter [[glColorPointer]], [[glDeleteLists]], [[glDisableClientState]], [[glEdgeFlagPointer]], [[glEnableClientState]], [[glFeedbackBuffer]], [[glFinish]], [[glFlush]], [[glGenLists]], [[glIndexPointer]], [[glInterleavedArrays]], [[glIsEnabled]], [[glIsList]], [[glNormalPointer]], [[glPopClientAttrib]], [[glPixelStore]], [[glPushClientAttrib]], [[glReadPixels]], [[glRenderMode]], [[glSelectBuffer]], [[glTexCoordPointer]], [[glVertexPointer]], und alle [[glGet]]-Befehle.
Die Befehle [[glTexImage1D]], [[glTexImage2D]] und [[glTexImage3D]] werden auch direkt ausgeführt statt in die Liste hineinkompiliert zu werden, sobald ihr erstes Argument '''GL_PROXY_TEXTURE_1D''', '''GL_PROXY_TEXTURE_2D''' oder '''GL_PROXY_TEXTURE_3D''' ist.

Sobald '''glEndList''' aufgerufen wird, wird die Erstellung der Displayliste beendet und diese mit dem eindeutigen Namen verbunden. Wenn eine Displayliste mit dem gleichen Namen bereits existiert, wird diese überschrieben.

 

== Hinweise ==
[[glCallList]] und [[glCallLists]] können innerhalb einer Displayliste aufgerufen werden, aber Befehle innerhalb dieser aufgerufenen Displaylisten werden NICHT in die aufrufende Displayliste hineinkompiliert, unabhängig vom Modus.

Eine Displayliste ist eine Gruppe von Befehlen und Argumente, also werden Fehler innerhalb einer Displayliste ausgelöst sobald diese aufgerufen wird, nicht jedoch wenn diese nur kompiliert wird.

 
== Fehlermeldungen ==

'''GL_INVALID_VALUE''' wird generiert wenn ''list'' gleich 0 ist.

'''GL_INVALID_ENUM''' wird generiert wenn ''mode'' kein gültiges Token ist.

'''GL_INVALID_OPERATION''' wird generiert wenn '''glEndList''' ohne vorhergehendes '''glNewList''' aufgerufen wird, oder '''glNewList''' aufgerufen wird wenn bereits eine Displayliste definiert wird.
'''
'''GL_INVALID_OPERATION''' wird generiert wenn '''glNewList''' oder '''glEndList''' zwischen einem [[glBegin]] und dem zugehörigen [[glEnd]] aufgerufen werden.

'''GL_OUT_OF_MEMORY''' wird generiert wenn nicht genügend Speicher zur Verfügung steht um die Displayliste zu generieren. Wenn die GL-Version 1.1 (oder höher ist), dann werden keine Änderungen an einer (evtl.) bereits vorher definierten Displayliste getätigt.

 
== Zugehörige Wertrückgaben ==

[[glIsList]] 
[[glGet]] mit dem Token '''GL_LIST_INDEX''' 
[[glGet]] mit dem Token '''GL_LIST_MODE''' 

 
== Siehe auch ==

[[glCallList]], [[glCallLists]], [[glDeleteLists]], glGenLists

Hintergrundwissen : [[Displaylisten]]

glClearColor

2004-07-08T20:12:36Z

Johannes: =Aufgabe=

==glClearColor==

===Aufgabe===
Legt die Farbe fest welche ein Farben/Colorbuffer nach seiner Leerung mit [[glClear]] enthält.

===Syntax===
procedure glClearColor (red, green, blue, alpha: GLclampf); stdcall;

===Hinweise===
Die aktuelle Leerfarbe erhält man, in dem man die Funktion [[glGet]] mit dem Parameter GL_COLOR_CLEAR_VALUE aufruft.

Standart gemäß sind alle Farbwerte auf 0(->Schwarz).

Falls Farblisten verwendet werden, nutzt man die Funktion [[glClearIndex]] um die Leerfarbe für den Colorbuffer festzulegen.

===Siehe auch===
[[glClear]],[[glClearIndex]],[[glColor]]

glBegin

2004-07-07T10:16:23Z

Johannes: =Beispiele=

= glBegin, glEnd =

== Name ==

'''glBegin, glEnd''' - Umschliessen die [[Eckpunkt|Eckpunkte (Vertices)]] einer [[Primitive|Primitiven]], oder eine Gruppe gleicher [[Primitive|Primitiven]].

== Delphi-Spezifikation ==

procedure '''glBegin'''(''mode'' : GLEnum);
procedure '''glEnd''';

== Parameter ==

<table border=0>
<tr>
<td valign="top" width="80px">
''mode''
</td>
<td>
Bestimmt die [[Primitive]] bzw. Gruppe von [[Primitive|Primitiven]] die aus den von '''glBegin''' und '''glEnd''' umschlossenen [[Eckpunkt|Eckpunkten (Vertices)]] erstellt wird.
Erlaubt sindhier die folgenden zehn symbolischen Konstanten :
GL_POINTS, GL_LINES, GL_LINE_STRIP, GL_LINE_LOOP, GL_TRIANGLES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_QUADS, GL_QUAD_STRIP, and GL_POLYGON.
</td>
</table>

== Beschreibung ==

'''glBegin''' und '''glEnd''' umschliessen eine Liste von [[Eckpunkt|Eckpunkten (Vertices)]] die eine [[Primitive]] oder Gruppe von [[Primitive|Primitiven]] darstellt. '''glBegin''' erhält ein einzelnes Argument (''mode'') das angibt auf welche Art und Weise die [[Eckpunkt|Eckpunkte (Vertices)]] interpretiert werden.
Unter der Annahme ''n'' sei ein Integerwert der bei Eins beginnt und ''N'' als Integerwert der die Gesamtanzahl der übergebenen Eckpunkte angibt, ergeben sich folgende Interpretationen :

'''GL_POINTS'''

Behandelt jeden Eckpunkt als einzelnen Punkt. Eckpunkt ''n'' definiert Punkt ''n'', und ''N'' Punkte werden gerendert.

'''GL_LINES'''

Behandelt jedes Eckpunkt-Paar als unabhängigen Linienabschnitt. Eckpunkte 2*''n''-1 und 2*''n'' beschreiben Linie n. N/2 Linien werden gerendert.

'''GL_LINE_STRIP'''

Rendert eine Gruppe von miteinander verbundenen Liniensegmenten, beginnend beim ersten Eckpunkt bis zum letzten. Eckpunkte ''n'' und ''n+1'' beschreiben dabei Linie ''n''. ''N-1'' Linien werden gerendert.

'''GL_LINE_LOOP'''

Rendert eine miteinander verbundene Gruppe von Linienabschnitten, beginnend beim ersten Eckpunkt und endend beim letzten, und dann wieder abschliessend zurück zum ersten. Eckpunkte ''n'' und ''n+1'' definieren Linie ''n''. Die letzte Linie wird jedich durch die Eckpunkte ''N'' und 1 definiert. ''N'' Linien werden gerendert.

'''GL_TRIANGLES'''

Behandelt jedes Eckpunkt-Trio als unabhängiges Dreieck. Eckpunkte 3*''n''-2, 3*''n''-1 und 3*''n'' beschreiben Dreieck ''n''. ''N''/3 Dreiecke werden gerendert.

'''GL_TRIANGLE_STRIP'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt der nach den beiden ersten Eckpunkten definiert wird gerendert. Für ein ungerades ''n'' definieren die Eckpunkte ''n'', ''n''+1 und ''n''+2 Dreieck ''n'', für gerade ''n''s definieren die Eckpunkte ''n''+1, ''n'' und ''n''+2 ein Dreieck. ''N''-2 Dreiecke werden gerendert.

'''GL_TRIANGLE_FAN'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt gerendert der nach den ersten beiden definiert wird. Eckpunkte 1, ''n''+1 und ''n''+2 definieren Dreieck ''n''. ''N''-2 Dreiecke werden gerendert.

'''GL_QUADS'''

Behandelt jeweils vier Eckpunkte als unabhängiges Viereck. Eckpunkte 4*''n''-3, 4*''n''-2, 4*''n''-1 und 4*''n'' beschreiben Viereck ''n''. ''N''/4 Vierecke werden gerendert.

'''GL_QUAD_STRIP'''

Renderd eine verbundene Gruppe von Vierecken. Ein Viereck wird wird für jedes nach den ersten beiden Eckpunkten übergebene Eckpunktepaar gerendert. Eckpunkte 2*''n''-1, 2*''n'', 2*''n''+2 und 2*''n''+1 beschreiben Viereck ''n''. ''N''/2-1 Vierecke werden gerendert. Es gilt allerdings zu beachten, das die Reihenfolge der Eckpunkte die genutzt werden um Vierecke aus einem Streifen (=Strip, evtl. unangemessene Übersetzung - --[[Benutzer:Sascha Willems|Sascha Willems]] 12:23, 29. Jun 2004 (CEST)) zu generieren unterschiedlich ggü. der unabhängigen Konstruktion sind.

'''GL_POLYGON'''

Rendert eine einzelnes, [[konvex|konvexes]] Polygon (=Vieleck). Eckpunkte 1 bis ''N'' definieren dieses Polygon.

Nur eine Untergruppe von GL Befehlen kann zwischen '''glBegin''' und '''glEnd''' genutzt werden. Die Befehle sind [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], und [[glEdgeFlag]]. Ausserdem ist es erlaubt [[glCallList]] oder [[glCallLists]] zu nutzen um [[Displaylisten]] auszuführen, die nur oben erwähnte Kommandos enthalten. Sollte ein nicht erwähnter GL Befehl zwischen '''glBegin''' und '''glEnd''' ausgeführt werden, dann wird das Fehlerflag gesetzt und der Befehl ignoriert.

Unabhängig des für ''mode'' übergebenen Wertes gibt es keine Begrenzung für die Anzahl der übergebenen Eckpunkte die zwischen '''glBegin''' und '''glEnd''' definiert werden. Linien, Dreiecke, Vierecke und Polygone die nicht genügenden beschrieben wurden werden nicht gerendert.
Ungenügende Beschreibung bedeutet entweder dass zu wenige Eckpunkte angegeben wurden um eine einzelne [[Primitive]] zu beschreiben, oder ein inkorrektes Vielfaches and Eckpunkten übergeben wurde. Nicht komplette Primitiven werden ignoriert; der Rest wird gerendet.

Das Minimum an zu spezifizierenden Eckpunkten für jede Primitive ist wie folgt :
1 für einen Punkt, 2 für eine Linie, 3 für ein Dreieck, 4 für ein Viereck (Sture Übersetzungen hören sich manchmal leider recht sinnentleert an --[[Benutzer:Sascha Willems|Sascha Willems]] 12:33, 29. Jun 2004 (CEST)) und 3 für ein Polygon. Modi die ein festgelegtes Vielfaches an Eckpunkten brauchen sind '''GL_LINES''' (2), '''GL_TRIANGLES''' (3), '''GL_QUADS''' (4), und '''GL_QUAD_STRIP''' (2).

== Fehlermeldungen ==

GL_INVALID_ENUM wird ausgelöst wenn ''mode'' einen ungültigen Wert besitzt.

GL_INVALID_OPERATION wird ausgelöst, wenn zwischen '''glBegin''' und dem zugehörigen '''glEnd''' ein weiteres '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird ausgelöst, wenn '''glEnd''' ohne ein vorhergehendes '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird aufgerufen, wenn ein anderer Befehl als [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], [[glEdgeFlag]], [[glCallList]], oder [[glCallLists]] zwischen '''glBegin''' und dem zugehörigen '''glEnd'' aufgerufen wird.

Ein Aufruf von [[glEnableClientState]], [[glDisableClientState]], [[glEdgeFlagPointer]], [[glTexCoordPointer]], [[glColorPointer]], [[glIndexPointer]], [[glNormalPointer]], [[glVertexPointer]], [[glInterleavedArrays]], oder [[glPixelStore]] nach einem Aufruf von '''glBegin'' und dem zugehörigen '''glEnd'' ist nicht erlaubt, aber je nach Implementation wird möglicherweise kein Fehler ausgelöst.

==Beispiele==

glBegin(GL_TRIANGLES);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glEnd;

Zwischen glBegin und glEnd können natürlich auch nicht OpenGL Befehle stehen was man dazu nutzen kann komplexere Gebilde direkt mit einer Schleife zeichnen zu lassen:

glBegin(GL_LINE_STRIP);
for i:=0 to 50 do
begin
glVertex3f(0,i,sin(i/50)*20);
end;
glEnd;

== Siehe auch ==

[[glArrayElement]], [[glCallList]], [[glCallLists]], [[glColor]], [[glEdgeFlag]], [[glEvalCoord]], [[glEvalPoint]], [[glIndex]], [[glMaterial]], [[glNormal]], [[glTexCoord]], [[glVertex]]

glBegin

2004-07-06T14:41:19Z

Johannes: =Beispiele=

= glBegin, glEnd =

== Name ==

'''glBegin, glEnd''' - Umschliessen die [[Eckpunkt|Eckpunkte (Vertices)]] einer [[Primitive|Primitiven]], oder eine Gruppe gleicher [[Primitive|Primitiven]].

== Delphi-Spezifikation ==

procedure '''glBegin'''(''mode'' : GLEnum);
procedure '''glEnd''';

== Parameter ==

<table border=0>
<tr>
<td valign="top" width="80px">
''mode''
</td>
<td>
Bestimmt die [[Primitive]] bzw. Gruppe von [[Primitive|Primitiven]] die aus den von '''glBegin''' und '''glEnd''' umschlossenen [[Eckpunkt|Eckpunkten (Vertices)]] erstellt wird.
Erlaubt sindhier die folgenden zehn symbolischen Konstanten :
GL_POINTS, GL_LINES, GL_LINE_STRIP, GL_LINE_LOOP, GL_TRIANGLES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_QUADS, GL_QUAD_STRIP, and GL_POLYGON.
</td>
</table>

== Beschreibung ==

'''glBegin''' und '''glEnd''' umschliessen eine Liste von [[Eckpunkt|Eckpunkten (Vertices)]] die eine [[Primitive]] oder Gruppe von [[Primitive|Primitiven]] darstellt. '''glBegin''' erhält ein einzelnes Argument (''mode'') das angibt auf welche Art und Weise die [[Eckpunkt|Eckpunkte (Vertices)]] interpretiert werden.
Unter der Annahme ''n'' sei ein Integerwert der bei Eins beginnt und ''N'' als Integerwert der die Gesamtanzahl der übergebenen Eckpunkte angibt, ergeben sich folgende Interpretationen :

'''GL_POINTS'''

Behandelt jeden Eckpunkt als einzelnen Punkt. Eckpunkt ''n'' definiert Punkt ''n'', und ''N'' Punkte werden gerendert.

'''GL_LINES'''

Behandelt jedes Eckpunkt-Paar als unabhängigen Linienabschnitt. Eckpunkte 2*''n''-1 und 2*''n'' beschreiben Linie n. N/2 Linien werden gerendert.

'''GL_LINE_STRIP'''

Rendert eine Gruppe von miteinander verbundenen Liniensegmenten, beginnend beim ersten Eckpunkt bis zum letzten. Eckpunkte ''n'' und ''n+1'' beschreiben dabei Linie ''n''. ''N-1'' Linien werden gerendert.

'''GL_LINE_LOOP'''

Rendert eine miteinander verbundene Gruppe von Linienabschnitten, beginnend beim ersten Eckpunkt und endend beim letzten, und dann wieder abschliessend zurück zum ersten. Eckpunkte ''n'' und ''n+1'' definieren Linie ''n''. Die letzte Linie wird jedich durch die Eckpunkte ''N'' und 1 definiert. ''N'' Linien werden gerendert.

'''GL_TRIANGLES'''

Behandelt jedes Eckpunkt-Trio als unabhängiges Dreieck. Eckpunkte 3*''n''-2, 3*''n''-1 und 3*''n'' beschreiben Dreieck ''n''. ''N''/3 Dreiecke werden gerendert.

'''GL_TRIANGLE_STRIP'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt der nach den beiden ersten Eckpunkten definiert wird gerendert. Für ein ungerades ''n'' definieren die Eckpunkte ''n'', ''n''+1 und ''n''+2 Dreieck ''n'', für gerade ''n''s definieren die Eckpunkte ''n''+1, ''n'' und ''n''+2 ein Dreieck. ''N''-2 Dreiecke werden gerendert.

'''GL_TRIANGLE_FAN'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt gerendert der nach den ersten beiden definiert wird. Eckpunkte 1, ''n''+1 und ''n''+2 definieren Dreieck ''n''. ''N''-2 Dreiecke werden gerendert.

'''GL_QUADS'''

Behandelt jeweils vier Eckpunkte als unabhängiges Viereck. Eckpunkte 4*''n''-3, 4*''n''-2, 4*''n''-1 und 4*''n'' beschreiben Viereck ''n''. ''N''/4 Vierecke werden gerendert.

'''GL_QUAD_STRIP'''

Renderd eine verbundene Gruppe von Vierecken. Ein Viereck wird wird für jedes nach den ersten beiden Eckpunkten übergebene Eckpunktepaar gerendert. Eckpunkte 2*''n''-1, 2*''n'', 2*''n''+2 und 2*''n''+1 beschreiben Viereck ''n''. ''N''/2-1 Vierecke werden gerendert. Es gilt allerdings zu beachten, das die Reihenfolge der Eckpunkte die genutzt werden um Vierecke aus einem Streifen (=Strip, evtl. unangemessene Übersetzung - --[[Benutzer:Sascha Willems|Sascha Willems]] 12:23, 29. Jun 2004 (CEST)) zu generieren unterschiedlich ggü. der unabhängigen Konstruktion sind.

'''GL_POLYGON'''

Rendert eine einzelnes, [[konvex|konvexes]] Polygon (=Vieleck). Eckpunkte 1 bis ''N'' definieren dieses Polygon.

Nur eine Untergruppe von GL Befehlen kann zwischen '''glBegin''' und '''glEnd''' genutzt werden. Die Befehle sind [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], und [[glEdgeFlag]]. Ausserdem ist es erlaubt [[glCallList]] oder [[glCallLists]] zu nutzen um [[Displaylisten]] auszuführen, die nur oben erwähnte Kommandos enthalten. Sollte ein nicht erwähnter GL Befehl zwischen '''glBegin''' und '''glEnd''' ausgeführt werden, dann wird das Fehlerflag gesetzt und der Befehl ignoriert.

Unabhängig des für ''mode'' übergebenen Wertes gibt es keine Begrenzung für die Anzahl der übergebenen Eckpunkte die zwischen '''glBegin''' und '''glEnd''' definiert werden. Linien, Dreiecke, Vierecke und Polygone die nicht genügenden beschrieben wurden werden nicht gerendert.
Ungenügende Beschreibung bedeutet entweder dass zu wenige Eckpunkte angegeben wurden um eine einzelne [[Primitive]] zu beschreiben, oder ein inkorrektes Vielfaches and Eckpunkten übergeben wurde. Nicht komplette Primitiven werden ignoriert; der Rest wird gerendet.

Das Minimum an zu spezifizierenden Eckpunkten für jede Primitive ist wie folgt :
1 für einen Punkt, 2 für eine Linie, 3 für ein Dreieck, 4 für ein Viereck (Sture Übersetzungen hören sich manchmal leider recht sinnentleert an --[[Benutzer:Sascha Willems|Sascha Willems]] 12:33, 29. Jun 2004 (CEST)) und 3 für ein Polygon. Modi die ein festgelegtes Vielfaches an Eckpunkten brauchen sind '''GL_LINES''' (2), '''GL_TRIANGLES''' (3), '''GL_QUADS''' (4), und '''GL_QUAD_STRIP''' (2).

== Fehlermeldungen ==

GL_INVALID_ENUM wird ausgelöst wenn ''mode'' einen ungültigen Wert besitzt.

GL_INVALID_OPERATION wird ausgelöst, wenn zwischen '''glBegin''' und dem zugehörigen '''glEnd''' ein weiteres '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird ausgelöst, wenn '''glEnd''' ohne ein vorhergehendes '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird aufgerufen, wenn ein anderer Befehl als [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], [[glEdgeFlag]], [[glCallList]], oder [[glCallLists]] zwischen '''glBegin''' und dem zugehörigen '''glEnd'' aufgerufen wird.

Ein Aufruf von [[glEnableClientState]], [[glDisableClientState]], [[glEdgeFlagPointer]], [[glTexCoordPointer]], [[glColorPointer]], [[glIndexPointer]], [[glNormalPointer]], [[glVertexPointer]], [[glInterleavedArrays]], oder [[glPixelStore]] nach einem Aufruf von '''glBegin'' und dem zugehörigen '''glEnd'' ist nicht erlaubt, aber je nach Implementation wird möglicherweise kein Fehler ausgelöst.

==Beispiele==

glBegin(GL_TRIANGLES);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glEnd;

Zwischen glBegin und glEnd können natürlich auch nicht OpenGL Befehle stehen was man dazu nutzen kann komplexere Gebilde direkt mit einer Schleife zeichnen zu lassen:

glBegin(GL_LINE_STRIP);
for i:=0 to 50 do
begin
glVertex3f(0,0,sin(i/50)*20);
end;
glEnd;

== Siehe auch ==

[[glArrayElement]], [[glCallList]], [[glCallLists]], [[glColor]], [[glEdgeFlag]], [[glEvalCoord]], [[glEvalPoint]], [[glIndex]], [[glMaterial]], [[glNormal]], [[glTexCoord]], [[glVertex]]

glBegin

2004-07-06T14:39:28Z

Johannes:

= glBegin, glEnd =

== Name ==

'''glBegin, glEnd''' - Umschliessen die [[Eckpunkt|Eckpunkte (Vertices)]] einer [[Primitive|Primitiven]], oder eine Gruppe gleicher [[Primitive|Primitiven]].

== Delphi-Spezifikation ==

procedure '''glBegin'''(''mode'' : GLEnum);
procedure '''glEnd''';

== Parameter ==

<table border=0>
<tr>
<td valign="top" width="80px">
''mode''
</td>
<td>
Bestimmt die [[Primitive]] bzw. Gruppe von [[Primitive|Primitiven]] die aus den von '''glBegin''' und '''glEnd''' umschlossenen [[Eckpunkt|Eckpunkten (Vertices)]] erstellt wird.
Erlaubt sindhier die folgenden zehn symbolischen Konstanten :
GL_POINTS, GL_LINES, GL_LINE_STRIP, GL_LINE_LOOP, GL_TRIANGLES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_QUADS, GL_QUAD_STRIP, and GL_POLYGON.
</td>
</table>

== Beschreibung ==

'''glBegin''' und '''glEnd''' umschliessen eine Liste von [[Eckpunkt|Eckpunkten (Vertices)]] die eine [[Primitive]] oder Gruppe von [[Primitive|Primitiven]] darstellt. '''glBegin''' erhält ein einzelnes Argument (''mode'') das angibt auf welche Art und Weise die [[Eckpunkt|Eckpunkte (Vertices)]] interpretiert werden.
Unter der Annahme ''n'' sei ein Integerwert der bei Eins beginnt und ''N'' als Integerwert der die Gesamtanzahl der übergebenen Eckpunkte angibt, ergeben sich folgende Interpretationen :

'''GL_POINTS'''

Behandelt jeden Eckpunkt als einzelnen Punkt. Eckpunkt ''n'' definiert Punkt ''n'', und ''N'' Punkte werden gerendert.

'''GL_LINES'''

Behandelt jedes Eckpunkt-Paar als unabhängigen Linienabschnitt. Eckpunkte 2*''n''-1 und 2*''n'' beschreiben Linie n. N/2 Linien werden gerendert.

'''GL_LINE_STRIP'''

Rendert eine Gruppe von miteinander verbundenen Liniensegmenten, beginnend beim ersten Eckpunkt bis zum letzten. Eckpunkte ''n'' und ''n+1'' beschreiben dabei Linie ''n''. ''N-1'' Linien werden gerendert.

'''GL_LINE_LOOP'''

Rendert eine miteinander verbundene Gruppe von Linienabschnitten, beginnend beim ersten Eckpunkt und endend beim letzten, und dann wieder abschliessend zurück zum ersten. Eckpunkte ''n'' und ''n+1'' definieren Linie ''n''. Die letzte Linie wird jedich durch die Eckpunkte ''N'' und 1 definiert. ''N'' Linien werden gerendert.

'''GL_TRIANGLES'''

Behandelt jedes Eckpunkt-Trio als unabhängiges Dreieck. Eckpunkte 3*''n''-2, 3*''n''-1 und 3*''n'' beschreiben Dreieck ''n''. ''N''/3 Dreiecke werden gerendert.

'''GL_TRIANGLE_STRIP'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt der nach den beiden ersten Eckpunkten definiert wird gerendert. Für ein ungerades ''n'' definieren die Eckpunkte ''n'', ''n''+1 und ''n''+2 Dreieck ''n'', für gerade ''n''s definieren die Eckpunkte ''n''+1, ''n'' und ''n''+2 ein Dreieck. ''N''-2 Dreiecke werden gerendert.

'''GL_TRIANGLE_FAN'''

Rendert eine verbundene Gruppe von Dreiecken. Ein Dreieck wird für jeden Eckpunkt gerendert der nach den ersten beiden definiert wird. Eckpunkte 1, ''n''+1 und ''n''+2 definieren Dreieck ''n''. ''N''-2 Dreiecke werden gerendert.

'''GL_QUADS'''

Behandelt jeweils vier Eckpunkte als unabhängiges Viereck. Eckpunkte 4*''n''-3, 4*''n''-2, 4*''n''-1 und 4*''n'' beschreiben Viereck ''n''. ''N''/4 Vierecke werden gerendert.

'''GL_QUAD_STRIP'''

Renderd eine verbundene Gruppe von Vierecken. Ein Viereck wird wird für jedes nach den ersten beiden Eckpunkten übergebene Eckpunktepaar gerendert. Eckpunkte 2*''n''-1, 2*''n'', 2*''n''+2 und 2*''n''+1 beschreiben Viereck ''n''. ''N''/2-1 Vierecke werden gerendert. Es gilt allerdings zu beachten, das die Reihenfolge der Eckpunkte die genutzt werden um Vierecke aus einem Streifen (=Strip, evtl. unangemessene Übersetzung - --[[Benutzer:Sascha Willems|Sascha Willems]] 12:23, 29. Jun 2004 (CEST)) zu generieren unterschiedlich ggü. der unabhängigen Konstruktion sind.

'''GL_POLYGON'''

Rendert eine einzelnes, [[konvex|konvexes]] Polygon (=Vieleck). Eckpunkte 1 bis ''N'' definieren dieses Polygon.

Nur eine Untergruppe von GL Befehlen kann zwischen '''glBegin''' und '''glEnd''' genutzt werden. Die Befehle sind [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], und [[glEdgeFlag]]. Ausserdem ist es erlaubt [[glCallList]] oder [[glCallLists]] zu nutzen um [[Displaylisten]] auszuführen, die nur oben erwähnte Kommandos enthalten. Sollte ein nicht erwähnter GL Befehl zwischen '''glBegin''' und '''glEnd''' ausgeführt werden, dann wird das Fehlerflag gesetzt und der Befehl ignoriert.

Unabhängig des für ''mode'' übergebenen Wertes gibt es keine Begrenzung für die Anzahl der übergebenen Eckpunkte die zwischen '''glBegin''' und '''glEnd''' definiert werden. Linien, Dreiecke, Vierecke und Polygone die nicht genügenden beschrieben wurden werden nicht gerendert.
Ungenügende Beschreibung bedeutet entweder dass zu wenige Eckpunkte angegeben wurden um eine einzelne [[Primitive]] zu beschreiben, oder ein inkorrektes Vielfaches and Eckpunkten übergeben wurde. Nicht komplette Primitiven werden ignoriert; der Rest wird gerendet.

Das Minimum an zu spezifizierenden Eckpunkten für jede Primitive ist wie folgt :
1 für einen Punkt, 2 für eine Linie, 3 für ein Dreieck, 4 für ein Viereck (Sture Übersetzungen hören sich manchmal leider recht sinnentleert an --[[Benutzer:Sascha Willems|Sascha Willems]] 12:33, 29. Jun 2004 (CEST)) und 3 für ein Polygon. Modi die ein festgelegtes Vielfaches an Eckpunkten brauchen sind '''GL_LINES''' (2), '''GL_TRIANGLES''' (3), '''GL_QUADS''' (4), und '''GL_QUAD_STRIP''' (2).

== Fehlermeldungen ==

GL_INVALID_ENUM wird ausgelöst wenn ''mode'' einen ungültigen Wert besitzt.

GL_INVALID_OPERATION wird ausgelöst, wenn zwischen '''glBegin''' und dem zugehörigen '''glEnd''' ein weiteres '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird ausgelöst, wenn '''glEnd''' ohne ein vorhergehendes '''glBegin''' aufgerufen wird.

GL_INVALID_OPERATION wird aufgerufen, wenn ein anderer Befehl als [[glVertex]], [[glColor]], [[glIndex]], [[glNormal]], [[glTexCoord]], [[glEvalCoord]], [[glEvalPoint]], [[glArrayElement]], [[glMaterial]], [[glEdgeFlag]], [[glCallList]], oder [[glCallLists]] zwischen '''glBegin''' und dem zugehörigen '''glEnd'' aufgerufen wird.

Ein Aufruf von [[glEnableClientState]], [[glDisableClientState]], [[glEdgeFlagPointer]], [[glTexCoordPointer]], [[glColorPointer]], [[glIndexPointer]], [[glNormalPointer]], [[glVertexPointer]], [[glInterleavedArrays]], oder [[glPixelStore]] nach einem Aufruf von '''glBegin'' und dem zugehörigen '''glEnd'' ist nicht erlaubt, aber je nach Implementation wird möglicherweise kein Fehler ausgelöst.

==Beispiele==

<nowiki>
glBegin(GL_TRIANGLES);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glVertex3f(1,1,0);
glEnd;
</nowiki>
 
Zwischen glBegin und glEnd können natürlich auch nicht OpenGL befehle stehen was man dazu nutzen kann komplexere Gebilde direkt mit einer Schleife zeichnen zu lassen:
<nowiki>
glBegin(GL_LINE_STRIP);
for i:=0 to 50 do
begin
glVertex3f(0,0,sin(i/50)*20);
end;
glEnd;
</nowiki>

== Siehe auch ==

[[glArrayElement]], [[glCallList]], [[glCallLists]], [[glColor]], [[glEdgeFlag]], [[glEvalCoord]], [[glEvalPoint]], [[glIndex]], [[glMaterial]], [[glNormal]], [[glTexCoord]], [[glVertex]]

glGenLists

2004-07-05T13:11:13Z

Johannes: =Fehlermeldungen=

= glGenLists =

 
== Name ==

'''glGenLists''' - Erstellt einen kontinuierlichen Satz leerer [[Displayliste|Displaylisten]].

 
== Delphi-Spezifikation ==

function TGLUInt '''glGenLists'''(''range'' : TGLSizei) : TGLUInt;

 

== Parameter ==

<table border=1>
<tr>
<td>''range''</td>
<td>Gibt die Anzahl der (aufeinander folgenden) zu erstellenden Displaylisten an.</td>
</tr>
</table>

 
== Beschreibung ==

'''glGenLists''' erwartet als Argument eine Reichweite und gibt den Integerwert ''n'' zurück, der eine Liste aufeinander folgender Werte für leere Displaylisten anführt (n = erste Liste, n+1 = zweite Liste, etc.). Wenn ''range'' gleich Null ist, oder nicht mehr genug freie Namen für die via ''range'' angegebene Listenreichweite vorhanden sind, oder ein Fehler generiert wird, werden keine leeren Displaylisten erstellt und es wird 0 zurückgegeben.

 
== Fehlermeldungen ==

GL_INVALID_VALUE wird generiert wenn ''range'' negativ ist. 

GL_INVALID_OPERATION wird generiert wenn '''glGenLists''' zwischen [[glBegin]] und dem passenden [[glEnd]] aufgerufen wird.

 

== Zugehörige Wertrückgaben ==

[[glIsList]]

 
== Siehe auch ==
[[glCallList]], [[glCallLists]], [[glDeleteLists]], [[glNewList]]

Hintergrundwissen

2004-07-05T06:26:26Z

Johannes:

== Was hier hinein gehört ==

In diese Kategorie kommt alles rein was zum Verständnis im Bereich OpenGL/3D-Programmierung nützlich sein könnte. Also u.a. welche Puffer es unter OpenGL gibt, und für was die gut sind.

Auch hier sollte man möglichst aufspalten und dann eine Überschrift setzen. So macht man das Auffinden bestimmter Dinge leichter und auch die Verlinkung darauf ist oft etwas das man in anderen Dokumenten benötigt.

P.S. : Ob hier Deutsche Begriffe oder Anglizismen genutzt werden ist jedem selbst überlassen. Ich persönlich bevorzuge ersteres.

== Übersicht ==

'''Bildentstehung'''
[[Fragment]]e
[[Pixel]]

'''Puffer'''
[[Akkumulationspuffer]] (Accumulationbuffer)
[[Doppelpufferung]] (Doublebuffering)
[[Farbpuffer]] (Colorbuffer)
[[Framebuffer]]
[[Stempelpuffer]] (Stencilbuffer)
[[Tiefenpuffer]] (Depthbuffer)

[[Primitive]]

'''Effekte'''
[[ZFighting]]

'''Bücher zu diesem Thema'''

ZFighting

2004-07-04T14:11:38Z

Johannes:

ZFighting ist ein Effekt, der auftritt wenn der Tiefenpuffer nicht hoch genug Auflösst, und/oder wenn zwei Polygone genau auf der gleichen Stelle sind.
Den Effekt erkennt man daran, das das Bild bei Bewegung der Kamaera flimmert und man mal das eine mal das andere Polygon sieht.

Das kann durch verschieden Techniken verhindert werden:
1. Größe des Tiefenbuffers hochsetzen (zb. 32 bit statt 16 bit)
2. Die Werte der near/far clipping plane verändern (siehe auch den link am ende des Artikels)
3. Keine zwei Polygone an der selben Stelle zeichenen lassen..
4. "Polygon Offset" verwenden ( [[glPolygonOffset]] )

weitere Infos im Web:

[http://www.sjbaker.org/steve/omniv/love_your_z_buffer.html Ein interresanter Artikel über Z-Buffer]

ZFighting

2004-07-04T14:10:44Z

Johannes:

ZFighting ist ein Effekt, der auftritt wenn der Tiefenpuffer nicht hoch genug Auflösst, und/oder wenn zwei Polygone genau auf der gleichen Stelle sind.
Den Effekt erkennt man daran, das das Bild bei Bewegung der Kamaera flimmert und man mal das eine mal das andere Polygon sieht.

Das kann durch verschieden Techniken verhindert werden:
1. Größe des Tiefenbuffers hochsetzen (zb. 32 bit statt 16 bit)
2. Die Werte der near/far clipping plane verändern (siehe auch den link am ende des Artikels)
3. Keine zwei Polygone an der selben Stelle zeichenen lassen..
4. "Polygon Offset" verwenden ( glPolygonOffset )

weitere Infos im Web:

[http://www.sjbaker.org/steve/omniv/love_your_z_buffer.html Ein interresanter Artikel über Z-Buffer]

Benutzer:Johannes

2004-07-02T21:09:52Z

Johannes:

also ein bisschen was über mich...
Ich programmier schon ne Zeit lang mit Delphi+OpenGL hab aber bis jetzt nix besonderst herrausragendes gemacht....
Mein einziges einigermassen gescheites Projekt war: [http://binf.sourceforge.net/ Beyond Infinity] wie ihr sehen könnt ist das Projekt zur zeit tot (weil ich den Quellcode bei einem HD problem verloren hab und der Code im CVS zu alt ist ...)
naja zurzeit arbeit ich an einem neuen Projekt aber da gibt's noch nicht viel vorzuzeigen ;)