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

WebGLRenderingContext.scissor()

· 52CE 我爱测

`WebGLRenderingContext.scissor()`** 方法指定了一个裁剪区域,用来将绘图区域限制在其限定的盒形区域内。

WebGL

WebGLRenderingContext.scissor() 方法指定了一个裁剪区域,用来将绘图区域限制在其限定的盒形区域内。

语法

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

参数

  • x
    • : GLint ,指定盒形裁剪区域左下角所在的横坐标,默认为 0。
  • y
    • : GLint 指定盒形裁剪区域左下角的纵坐标,默认为 0。
  • width
    • : Glsizei,用来确定盒型裁剪区域宽度的非负数,默认为 canvas 的宽度。
  • height
    • : Glsizei ,用以指定盒形裁剪区域高度的非负数,默认为 canvas 的高度。

返回值

无。

抛错

宽或高为负值时,抛出 gl.INVALID_VALUE 错误。

示例

当裁剪区域可用的时候,只有处于此区域内的像素才能由绘图命令修改。

// turn on scissor test
gl.enable(gl.SCISSOR_TEST);

// set the scissor rectangle
gl.scissor(x, y, width, height);

// execute drawing commands in the scissor box (e.g. clear)

// turn off scissor test again
gl.disable(gl.SCISSOR_TEST);

通过查询 SCISSOR_BOX 常量来获取裁剪区域的维度信息,返回值是一个 Int32Array 对象。

gl.scissor(0, 0, 200, 200);
gl.getParameter(gl.SCISSOR_BOX);
// Int32Array[0, 0, 200, 200]

规范

浏览器兼容性

参见

  • WebGLRenderingContext.viewport()
  • WebGLRenderingContext.enable()
  • WebGLRenderingContext.disable()

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

资料来源与适用范围

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

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

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