跳到主要内容

Grid

描述:

  用于将一张纹理渲染为一组网格状的图元的场景节点类,网格中每个图元可以被重新定位、着色和操纵其UV坐标。

类对象:Grid Class

继承自:Node

gridX

类型: 只读成员变量。

描述:

  网格中的列数。水平方向有 gridX + 1 个顶点用于渲染。

签名:

const gridX: integer

gridY

类型: 只读成员变量。

描述:

  网格中的行数。垂直方向有 gridY + 1 个顶点用于渲染。

签名:

const gridY: integer

depthWrite

类型: 成员变量。

描述:

  是否启用深度缓冲写入(默认为false)。

签名:

depthWrite: boolean

texture

类型: 成员变量。

描述:

  用于网格渲染的纹理。

签名:

texture: Texture2D

textureRect

类型: 成员变量。

描述:

  在纹理中用于渲染网格的矩形区域。

签名:

textureRect: Rect

blendFunc

类型: 成员变量。

描述:

  用于渲染网格的混合函数。

签名:

blendFunc: BlendFunc

effect

类型: 成员变量。

描述:

  应用于网格渲染的图元着色器效果。 默认值为SpriteEffect("builtin:vs_sprite", "builtin:fs_sprite")

签名:

effect: SpriteEffect

setPos

类型: 函数。

描述:

  设置网格中顶点的位置。

签名:

setPos: function(self: Grid, x: integer, y: integer, pos: Vec2, z?: number)

参数:

参数名类型描述
xinteger网格中顶点的x坐标。
yinteger网格中顶点的y坐标。
posVec2顶点的新位置。
znumber[可选] 顶点的新z坐标(默认为0)。

getPos

类型: 函数。

描述:

  获取网格中顶点的位置。

签名:

getPos: function(self: Grid, x: integer, y: integer): Vec2

参数:

参数名类型描述
xinteger网格中顶点的x坐标。
yinteger网格中顶点的y坐标。

返回值:

返回类型描述
Vec2顶点的当前位置。

getColor

类型: 函数。

描述:

  获取网格中顶点的颜色。

签名:

getColor: function(self: Grid, x: integer, y: integer): Color

参数:

参数名类型描述
xinteger网格中顶点的x坐标。
yinteger网格中顶点的y坐标。

返回值:

返回类型描述
Color顶点的当前颜色。

setColor

类型: 函数。

描述:

  设置网格中顶点的颜色。

签名:

setColor: function(self: Grid, x: integer, y: integer, color: Color)

参数:

参数名类型描述
xinteger网格中顶点的x坐标。
yinteger网格中顶点的y坐标。
colorColor顶点的新颜色。

moveUV

类型: 函数。

描述:

  移动网格中顶点的UV坐标。

签名:

moveUV: function(self: Grid, x: integer, y: integer, offset: Vec2)

参数:

参数名类型描述
xinteger网格中顶点的x坐标。
yinteger网格中顶点的y坐标。
offsetVec2移动UV坐标的偏移量。