glViewport 函式

glViewport函式會設定檢視區。

語法

void WINAPI glViewport(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

參數

x

檢視區矩形的左下角，以圖元為單位。 預設值為 (0,0)。

y

檢視區矩形的左下角，以圖元為單位。 預設值為 (0,0)。

寬度

檢視區的寬度。 當 OpenGL 內容第一次附加至視窗時， 寬度 和 高度 會設定為該視窗的維度。

height (高度)

檢視區的高度。 當 OpenGL 內容第一次附加至視窗時， 寬度 和 高度 會設定為該視窗的維度。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_VALUE	寬度或高度為負數。
GL_INVALID_OPERATION	在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

glViewport函式會指定從標準化裝置座標到視窗座標的x和y的相依轉換。 讓 (x_nd 、 y_nd ) 正規化裝置座標。 視窗座標 (x w 、y_w ) 接著計算如下：

檢視區寬度和高度會以無訊息方式限制在相依于實作的範圍。 呼叫 glGet 搭配引數GL_MAX_VIEWPORT_DIMS來查詢此範圍。

下列函式會擷取 與 glViewport相關的資訊：

glGet 與引數GL_VIEWPORT

glGet with argument GL_MAX_VIEWPORT_DIMS

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glDepthRange