大网数据广告活动
Web 标准与前端开发

WebGLRenderingContext.viewport()

· 52CE 我爱测

WebGL API 的 **`WebGLRenderingContext.viewport()`** 方法,用来设置视口,即指定从标准设备到窗口坐标的 x、y 仿射变换。

WebGL

WebGL API 的 WebGLRenderingContext.viewport() 方法,用来设置视口,即指定从标准设备到窗口坐标的 x、y 仿射变换。

语法

void gl.viewport(x, y, width, height);

参数

  • x
    • : GLint,用来设定视口的左下角水平坐标。默认值:0。
  • y
    • : GLint,用来设定视口的左下角垂直坐标。默认值:0。
  • width
    • : 非负数Glsizei,用来设定视口的宽度。默认值:canvas 的宽度。
  • height
    • : 非负数Glsizei,用来设定视口的高度。默认值:canvas 的高度。

返回值

None.

异常错误

只要宽度或高度有一个为负值,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()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。