共计 1004 个字符，预计需要花费 3 分钟才能阅读完成。

平铺背景

该接口派生自 IWorldInstance，用于添加特定于 Tiled Background 插件的 API。

ITiledBackgroundInstance API

图像尺寸

• getImageSize(): 获取平铺背景当前图像的原始尺寸（以像素为单位）。这不包括平铺 – 它返回 Construct 图像编辑器中所示的大小。该方法允许同时检索两个值。

图像偏移

• setImageOffset(imageOffsetX, imageOffsetY)
• getImageOffset(): 显示的平铺背景图像的偏移量（以像素为单位）。这些方法允许同时设置或获取两个值。

图像缩放

• setImageScale(imageScaleX, imageScaleY)
• getImageScale(): 显示的平铺背景图像的比例，原始大小默认为 1。这些方法允许同时设置或获取两个值。

图像旋转

• imageAngle: 显示的平铺背景图像的角度（以弧度为单位）。如果更改，请相应地更新。
• imageAngleDegrees: 显示的平铺背景图像的角度（以度为单位）。如果更改，请相应地更新。

磁贴随机化

• enableTileRandomization: 指示是否启用磁贴随机化的布尔值。
• setTileRandom(tileXRandom, tileYRandom)
• getTileRandom(): 启用磁贴随机化后，要使用的随机水平和垂直偏移量，以 0-1 范围内的百分比表示。这些方法允许同时设置或获取两个值。
• tileAngleRandom: 启用磁贴随机化后，要使用的随机旋转量，以 0-1 范围内的百分比表示。

磁贴混合边距

• setTileBlendMargin(tileBlendMarginX, tileBlendMarginY)
• getTileBlendMargin(): 启用磁贴随机化后，将淡入相邻磁贴的磁贴宽度或高度的百分比，以 0-1 范围内的百分比表示。这些方法允许同时设置或获取两个值。

替换图像

• async replaceImage(blob): 将当前图像替换为表示图像文件（如 PNG 图像）的 Blob 的内容。可以在本地生成或从 URL 检索 Blob，例如：

// Loading an image from a URL
const response = await fetch(url);
const blob = await response.blob();
await tbInst.replaceImage(blob);