glRects-Funktion

Die glRects-Funktion zeichnet ein Rechteck.

Syntax

void WINAPI glRects(
   GLshort x1,
   GLshort y1,
   GLshort x2,
   GLshort y2
);

Parameter

x1

Die x-Koordinate des Scheitelpunkts eines Rechtecks.

y1

Die y-Koordinate des Scheitelpunkts eines Rechtecks.

x2

Die x-Koordinate des gegenüberliegenden Scheitelpunkts des Rechtecks.

y2

Die y-Koordinate des entgegengesetzten Scheitelpunkts des Rechtecks.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL_INVALID_OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glRects-Funktion unterstützt die effiziente Spezifikation von Rechtecken als zwei Eckpunkte. Jeder Rechteckbefehl akzeptiert vier Argumente, die entweder als zwei aufeinander folgende Paare von (x, y) Koordinaten oder als zwei Zeiger auf Arrays organisiert sind, die jeweils ein (x, y)-Paar enthalten. Das resultierende Rechteck wird in der Ebene z = 0 definiert.

Die glRects(x1,y1,x2,y2)-Funktion entspricht genau der folgenden Sequenz:

glBegin(GL_POLYGON);

glVertex2( x1,y1 );

glVertex2( x2,y1 );

glVertex2( x2,y2 );

glVertex2( x1,y2 );

glEnd( );

Wenn sich der zweite Scheitelpunkt oberhalb und rechts vom ersten Scheitelpunkt befindet, wird das Rechteck mit einer Wicklung gegen den Uhrzeigersinn konstruiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd

glVertex