WebGLRenderingContext.viewport()

WebGL APIWebGLRenderingContext.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]

规范

Specification Status Comment
WebGL 1.0
viewport
Recommendation Initial definition.
OpenGL ES 2.0
glViewport
Standard Man page of the OpenGL API.

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support9124.011125.1
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)25(Yes)(Yes)11128.1

另见

文档标签和贡献者

标签: 
 此页面的贡献者: shenwenkai
 最后编辑者: shenwenkai,