glViewport-Funktion
Die glViewport-Funktion legt den Viewport fest.
Syntax
void WINAPI glViewport(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Parameter
-
x
-
Die linke untere Ecke des Viewportrechtecks in Pixel. Der Standardwert ist (0,0).
-
y
-
Die linke untere Ecke des Viewportrechtecks in Pixel. Der Standardwert ist (0,0).
-
width
-
Die Breite des Viewports. Wenn ein OpenGL-Kontext zuerst an ein Fenster angefügt wird, werden Breite und Höhe auf die Dimensionen dieses Fensters festgelegt.
-
height
-
Die Höhe des Viewports. Wenn ein OpenGL-Kontext zuerst an ein Fenster angefügt wird, werden Breite und Höhe auf die Dimensionen dieses Fensters festgelegt.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Breite oder Höhe war negativ. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glViewport-Funktion gibt die affine Transformation von x und y von normalisierten Gerätekoordinaten in Fensterkoordinaten an. Lassen Sie (xnd , ynd ) normierte Gerätekoordinaten sein. Die Fensterkoordinaten (xw , yw ) werden dann wie folgt berechnet:
Die Breite und Höhe des Viewports werden unbeaufsichtigt in einen Bereich eingespannt, der von der Implementierung abhängt. Dieser Bereich wird abgefragt, indem glGet mit dem Argument GL_MAX_VIEWPORT_DIMS aufgerufen wird.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glViewport ab:
glGet mit Argument GL_VIEWPORT
glGet with argument GL_MAX_VIEWPORT_DIMS
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|