EditableImage 允许运行时创建和操作图像。
要创建一个空白 EditableImage ，请使用 AssetService:CreateEditableImage() 。要从现有图像中创建一个 EditableImage ，请使用 AssetService:CreateEditableImageAsync() 。
EditableImage 可以用于任何带有图像的 Content 属性，例如 ImageLabel.ImageContent 或 MeshPart.TextureContent .这可以通过将内容属性设置为 Content.fromObject(editableImage) 来实现。
EditableImage 坐标系是相对于图像的左上角：
- 顶部左侧：(0, 0)
- 右下：(Size.X - 1, Size.Y - 1)
当你使用 AssetService:PromptCreateAssetAsync() 来发布一个具有 Content 属性的对象，该属性引用一个 EditableImage 时，编辑图像将发布为图像，属性将设置为新的资产ID。
更新限制
仅在显示侧每帧更新一次 EditableImage 。例如，如果你更新了三个正在显示的 EditableImage 对象，那么为它们全部更新将需要三个框架。
启用可编辑图像对已发布体验
为了安全目的，默认情况下，使用 EditableImage 对发布的体验失败。要启用使用，您必须年满 13 岁并身份验证通过。验证通过后，打开 Studio 的 游戏设置，选择 安全 ，然后启用 允许网格/图像 API 切换。
权限
为了防止滥用，AssetService:CreateEditableImageAsync()仅允许您加载和编辑图像资产：
- 这些是由体验的创建者拥有的（如果体验由个人拥有）。
- 这些是由群组拥有的（如果体验由群组拥有）。
- 这些是由登录的 Studio 用户拥有的（如果地点文件尚未保存或发布到 Roblox）。
如果使用 API 来加载不满足上述条件的资产，它们将抛出错误。
概要
方法
- DrawCircle(center : Vector2,radius : number,color : Color3,transparency : number,combineType : Enum.ImageCombineType):()
在指定位置绘制圆圈。
在指定位置绘制另一个 EditableImage 到这个 EditableImage 。
将另一个 EditableImage 项目转换为 EditableMesh 并将结果存储在这个 EditableImage 上。
- DrawImageTransformed(position : Vector2,scale : Vector2,rotation : number,image : EditableImage,options : Dictionary?):()
将图像绘制到这个 EditableImage 中，包括缩放和旋转等变形，放置在指定位置。
绘制两个提供点之间的线。
- DrawRectangle(position : Vector2,size : Vector2,color : Color3,transparency : number,combineType : Enum.ImageCombineType):()
在给定的左上位置绘制给定尺寸的长方形。
将像素矩形区域读入缓冲区。
将像素形成的长方形区域写入图像。
属性
Size
像素内的 EditableImage 的大小。最大尺寸为 1024×1024。一个 EditableImage 无法调整大小；该属性为读写不可变。为了调整图像大小或裁剪图像，创建一个新的 EditableImage 并使用 DrawImageTransformed() 来转移内容；然后调用 Destroy() 。
方法
Destroy
摧毁图像的内容，立即回收使用的内存。
返回
DrawCircle
在 EditableImage 上的指定位置绘制圆圈。如果圆圈是半透明的，它将使用源过滤与它后面的像素混合。
参数
圆圈中心，相对于左上角的 EditableImage 。允许位置超出画布边界。
圆圈的半径以像素计。
圆圈的颜色。
圆圈的透明度，0完全不透明，1完全透明。
源图像的像素与添加的图像的像素如何融合。
返回
DrawImage
在指定位置绘制另一个 EditableImage 到这个 EditableImage 。允许超出画布边界的位置，只绘制新图像的一部分。
参数
添加的图像顶左角的位置将被绘制。
将 EditableImage 绘制到这个 EditableImage 。
源图像的像素应如何与添加的图像的像素融合。
返回
DrawImageProjected
将另一个 EditableImage 项目转换为 EditableMesh 并将结果存储在这个 EditableImage 上，使用指定的投影和画笔配置进行转换。
参数
用于投射的 EditableMesh。
包括以下键值对的刷子配置词典：
- AlphaBlendType （Enum.ImageAlphaType）决定这个投影将如何融合 alpha 值。
- ColorBlendType （Enum.ImageCombineType）决定这个投影将如何融合颜色值。
- Decal （EditableImage）用于投影的图像。
- FadeAngle （数字）作为投影边落下的角度以度。
- BlendIntensity （数字）作为在 0 和 1 之间的值，控制投影是否融入到最终图像中的多少。
返回
DrawImageTransformed
这种方法可以让你将 EditableImage 绘制到这个 EditableImage 中，应用变形，例如缩放和旋转。位置参数指定源图的旋转点将在变形后放置在这个图像上的位置。允许超出画布边界的位置，只绘制新图像的一部分。
参数
位于像素中的位置，在这个图像上将放置来源图像的旋转点。
沿 X 和 Y 轴的源图像的缩放因子。
应用于来源图像的旋转角度，以度为单位，环绕其旋转点。
源 EditableImage 将被绘制到这个图像中。
可选词典用于额外配置：
- CombineType : 指定源图像的像素与目标像素融合的方式。默认值为 Enum.ImageCombineType.AlphaBlend 。
- PivotPoint : 指定源图像内的旋转点以进行缩放和旋转。默认是源图像的中心(即 Image.Size / 2 )。
返回
代码示例
The following code draws a rotated and scaled image onto another.
local AssetService = game:GetService("AssetService")
-- Example of drawing a rotated and scaled image onto another EditableImage
local srcImage = AssetService:CreateEditableImage({ Size = Vector2.new(256, 256) })
local dstImage = AssetService:CreateEditableImage({ Size = Vector2.new(512, 512) })
-- Drawing with a rotation of 45 degrees, scaling by 2x, and placing at (100, 100)
dstImage:DrawImageTransformed(
Vector2.new(100, 100), -- Position
Vector2.new(2, 2), -- Scale
45, -- Rotation (degrees)
srcImage, -- Source image
{
CombineType = Enum.ImageCombineType.AlphaBlend, -- Optional, default is AlphaBlend
SamplingMode = Enum.ResamplerMode.Default, -- Optional, default is Default
PivotPoint = srcImage.Size / 2, -- Optional, default is center of the source image
}
)以下代码显示了使用 EditableImage:DrawImageTransformed() 方法对图像进行裁剪的方法。
local AssetService = game:GetService("AssetService")
-- 来源图像
local srcImage = AssetService:CreateEditableImageAsync(Content.fromUri(assetUri))
-- 由偏移和尺寸定义的作物区域
local cropOffset = Vector2.new(50, 50)
local cropSize = Vector2.new(100, 100)
-- 作物区域尺寸的目标图像
local dstImage = AssetService:CreateEditableImage({ Size = cropSize })
-- 位置（左上角）
local position = Vector2.new(0, 0)
-- 缩放因子（无缩放）
local scale = Vector2.new(1, 1)
-- 旋转角度（无旋转）
local rotation = 0
-- 将来源图像绘制到目标图像上，调整旋转以裁剪图像
dstImage:DrawImageTransformed(position, scale, rotation, srcImage, {
CombineType = Enum.ImageCombineType.Overwrite,
PivotPoint = cropOffset, -- 将旋转点设置为 cropOffset，从那里开始绘制
})DrawLine
在两个提供的点之间绘制一条反折线，厚度为一像素 EditableImage
参数
线的起始点。
线的末端。
线的颜色。
线的透明度。
源图像的像素与添加的图像的像素如何融合。
返回
DrawRectangle
在给定的左上角位置绘制一个长方形在给定的尺寸EditableImage。
参数
长方形的左上角位置。与其他绘画方法不同，这不能超出 EditableImage 画布边界。
绘制长方形的大小，以像素计算。
长方形的颜色。
矩形的透明度。
源图像的像素与添加的图像的像素如何融合。
返回
ReadPixelsBuffer
从 EditableImage 读取一个长方形区域的像素，并将其返回为缓冲区。缓冲区中的每个数字都是单个字节，像素存储在四个字节顺序（红色、绿色、蓝色和 Alpha）中。
请注意，此方法使用 alpha 而不是透明，与 EditableImage 绘制方法不同。
参数
返回
每个像素由四个字节表示的缓冲区（红色、绿色、蓝色和 Alpha 分别）。缓冲区的长度可以计算为 Size.X * Size.Y * 4 字节。
代码示例
The following code reads two pixels from a EditableImage and creates a part with the average color between them.
local AssetService = game:GetService("AssetService")
local options = { Size = Vector2.new(32, 32) }
local editableImage = AssetService:CreateEditableImage(options)
local pixelsBuffer = editableImage:ReadPixelsBuffer(Vector2.zero, Vector2.new(2, 1))
local color1 =
Color3.fromRGB(buffer.readu8(pixelsBuffer, 0), buffer.readu8(pixelsBuffer, 1), buffer.readu8(pixelsBuffer, 2))
local transparency1 = (255 - buffer.readu8(pixelsBuffer, 3)) / 255
local color2 =
Color3.fromRGB(buffer.readu8(pixelsBuffer, 4), buffer.readu8(pixelsBuffer, 5), buffer.readu8(pixelsBuffer, 6))
local transparency2 = (255 - buffer.readu8(pixelsBuffer, 7)) / 255
local averageColor = color1:Lerp(color2, 0.5)
local averageTransparency = (transparency1 + transparency2) / 2
local part = Instance.new("Part")
part.Color = averageColor
part.Transparency = averageTransparency
part.Parent = workspaceWritePixelsBuffer
从缓冲区中写一个长方形区域的像素到 EditableImage 。缓冲区中的每个数字都是单个字节，像素存储在四个字节顺序（红色、绿色、蓝色和 Alpha）中。
请注意，此方法使用 alpha 而不是透明，与 EditableImage 绘制方法不同。
参数
长方形区域的左上角，用于将像素绘制进来。
要写入的像素长方区域的大小。
每个像素由四个字节（分别为红色、绿色、蓝色和 Alpha）表示的缓冲区。缓冲区的长度应为 Size.X * Size.Y * 4 字节。
返回
代码示例
The following code reads the pixels of a EditableImage and writes back the inverted color values of those pixels.
local AssetService = game:GetService("AssetService")
local options = { Size = Vector2.new(32, 32) }
local editableImage = AssetService:CreateEditableImage(options)
local pixelsBuffer = editableImage:ReadPixelsBuffer(Vector2.zero, editableImage.Size)
for i = 1, editableImage.Size.X * editableImage.Size.Y do
local pixelIndex = (i - 1) * 4
buffer.writeu8(pixelsBuffer, pixelIndex, 255 - buffer.readu8(pixelsBuffer, pixelIndex))
buffer.writeu8(pixelsBuffer, pixelIndex + 1, 255 - buffer.readu8(pixelsBuffer, pixelIndex + 1))
buffer.writeu8(pixelsBuffer, pixelIndex + 2, 255 - buffer.readu8(pixelsBuffer, pixelIndex + 2))
-- Set alpha to 255 to make all pixels fully opaque.
buffer.writeu8(pixelsBuffer, pixelIndex + 3, 255)
end
editableImage:WritePixelsBuffer(Vector2.zero, editableImage.Size, pixelsBuffer)