跳到主要内容

RenderTarget

描述：

  用于将游戏场景节点渲染到一张纹理上的类。

类对象：RenderTarget Class。

继承自：Object。

width​

类型： 只读成员变量。

描述：

  渲染目标的宽度。

签名：

const width: integer

height​

类型： 只读成员变量。

描述：

  渲染目标的高度。

签名：

const height: integer

texture​

类型： 只读成员变量。

描述：

  渲染目标生成的纹理。

签名：

const texture: Texture2D

camera​

类型： 成员变量。

描述：

  用于渲染场景节点的相机。

签名：

camera: Camera

render​

类型： 函数。

描述：

  渲染节点到目标纹理，不清空之前渲染的内容。

签名：

render: function(self: RenderTarget, target: Node)

参数：

参数名类型描述
targetNode要渲染到渲染目标的节点。

renderWithClear​

类型： 函数。

描述：

  初始化渲染目标纹理上颜色，深度和模板值。

签名：

renderWithClear: function(
		self: RenderTarget,
		color: Color,
		depth?: number --[[1]],
		stencil?: number --[[0]]
	)

参数：

参数名类型描述
colorColor用于初始化渲染目标的颜色。
depthnumber[可选] 用于初始化渲染目标的深度缓冲区的值。默认为1。
stencilnumber[可选] 用于初始化渲染目标的模板缓冲区的值。默认为0。

renderWithClear​

类型： 函数。

描述：

  初始化渲染目标纹理之后，再将场景节点渲染到目标纹理。

签名：

renderWithClear: function(
		self: RenderTarget,
		target: Node,
		color: Color,
		depth?: number --[[1]],
		stencil?: integer --[[0]]
	)

参数：

参数名类型描述
targetNode要渲染到渲染目标的节点。
colorColor用于初始化渲染目标的颜色。
depthnumber[可选] 用于初始化渲染目标的深度缓冲区的值。默认为1。
stencilnumber[可选] 用于初始化渲染目标的模板缓冲区的值。默认为0。

saveAsync​

类型： 函数。

描述：

  异步将渲染目标的内容保存成一张PNG文件。

签名：

saveAsync: function(self: RenderTarget, filename: string)

参数：

参数名类型描述
filenamestring新生成的PNG文件的名称。