WebGLRenderingContext: viewport() 方法

语法

viewport(x, y, width, height)

参数

x

一个 GLint，指定视口原点左下角的水平坐标。默认值：0。

y

一个 GLint，指定视口原点左下角的垂直坐标。默认值：0。

width

一个非负的 GLsizei，指定视口的宽度。默认值：canvas 的宽度。

height

一个非负的 GLsizei，指定视口的高度。默认值：canvas 的高度。

返回值

无（undefined）。

异常

如果 *width* 或 *height* 是负值，则会抛出 `gl.INVALID_VALUE` 错误。

示例

当您首次创建 WebGL 上下文时，视口大小将与 canvas 大小匹配。但是，如果您调整 canvas 的大小，您需要告诉 WebGL 上下文新的视口设置。在这种情况下，您可以使用 `gl.viewport`。

gl.viewport(0, 0, canvas.width, canvas.height);

视口的宽度和高度会被限制在一个依赖于实现的范围内。要获取此范围，您可以使用 `MAX_VIEWPORT_DIMS` 常量，它会返回一个 Int32Array。

gl.getParameter(gl.MAX_VIEWPORT_DIMS);
// e.g. Int32Array[16384, 16384]

要获取当前的视口，请查询 `VIEWPORT` 常量。

gl.getParameter(gl.VIEWPORT);
// e.g. Int32Array[0, 0, 640, 480]

规范

浏览器兼容性

另见

• WebGLRenderingContext.scissor()
• WebGLRenderingContext.getParameter()