CompositePaint

父项 Paint
库 display.*
修订 版本 2024.3703
关键字 复合式画笔、多重纹理
另请参阅 object.fill
object.stroke
滤镜、生成器、复合 (指南)

概述

复合式画笔包含多个图像，因此启用多重纹理。

语法

local paint = {
    type = "composite",
    paint1 = ,
    paint2 =
}
类型(必需)

字符串. "composite" 的字符串值。

paint1 (必需)

表. 指定 位图画笔 的表。请参阅以下局限性。

paint2 (必需)

表. 指定 位图画笔 的表。请参阅以下局限性。

baseDir (可选)

常量. 指定文件名所在的基本目录。选项包括 system.ResourceDirectory、system.DocumentsDirectory、system.TemporaryDirectory 和 system.CachesDirectory。默认值为 system.ResourceDirectory。

局限性

由于多重纹理的工作方式，paint1 和 paint2 都将使用相同的纹理坐标进行渲染。由于 梯度画笔 和 图像图集画笔 使用与普通 位图画笔 不同的纹理坐标，除非你对 paint1 和 paint2 使用普通 位图画笔，否则将得到意外结果。

属性

（继承自 画笔 的属性）

示例

local paint = {
    type = "composite",
    paint1 = { type="image", filename="wood.png" },
    paint2 = { type="image", filename="dust.png" }
}

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = paint
rect.fill.effect = "composite.average"