概要
方法
Destroy():() |
DrawCircle(center: Vector2,radius: number,color: Color3,transparency: number,combineType: Enum.ImageCombineType,antiAliasing: Enum.AntiAliasing):() |
DrawImage(position: Vector2,image: EditableImage,combineType: Enum.ImageCombineType):() |
DrawImageProjected(mesh: EditableMesh,projection: Dictionary,brushConfig: Dictionary):() |
DrawImageTransformed(position: Vector2,scale: Vector2,rotation: number,image: EditableImage,options: Dictionary?):() |
DrawLine(p1: Vector2,p2: Vector2,color: Color3,transparency: number,combineType: Enum.ImageCombineType,antiAliasing: Enum.AntiAliasing):() |
DrawRectangle(position: Vector2,size: Vector2,color: Color3,transparency: number,combineType: Enum.ImageCombineType):() |
ReadPixelsBuffer(position: Vector2,size: Vector2):buffer |
WritePixelsBuffer(position: Vector2,size: Vector2,buffer: buffer):() |
继承成员
6 个继承自 Object
API 参考
属性
方法
Destroy
EditableImage:Destroy():()
返回
()
DrawCircle
EditableImage:DrawCircle(
center:Vector2, radius:number, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing
):()
参数
| 默认值："Enabled" |
返回
()
DrawImage
EditableImage:DrawImage(
):()
参数
返回
()
DrawImageProjected
EditableImage:DrawImageProjected(
):()
参数
返回
()
DrawImageTransformed
EditableImage:DrawImageTransformed(
):()
参数
返回
()
代码示例
可编辑图像:绘制变换图像()
local AssetService = game:GetService("AssetService")
-- 绘制一个旋转和缩放的图像到另一个可编辑图像的示例
local srcImage = AssetService:CreateEditableImage({ Size = Vector2.new(256, 256) })
local dstImage = AssetService:CreateEditableImage({ Size = Vector2.new(512, 512) })
-- 以45度旋转，缩放2倍，并放置在(100, 100)位置绘制
dstImage:DrawImageTransformed(
Vector2.new(100, 100), -- 位置
Vector2.new(2, 2), -- 缩放
45, -- 旋转（度）
srcImage, -- 源图像
{
CombineType = Enum.ImageCombineType.AlphaBlend, -- 可选，默认是 AlphaBlend
SamplingMode = Enum.ResamplerMode.Default, -- 可选，默认是 Default
PivotPoint = srcImage.Size / 2, -- 可选，默认是源图像的中心
}
)可编辑图像：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:DrawLine(
p1:Vector2, p2:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing
):()
参数
| 默认值："Enabled" |
返回
()
DrawRectangle
EditableImage:DrawRectangle(
position:Vector2, size:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType
):()
参数
返回
()
ReadPixelsBuffer
返回
代码示例
可编辑图像:读取像素缓冲区()
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
返回
()
代码示例
可编辑图像:写入像素缓冲区()
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))
-- 设置 alpha 为 255，使所有像素完全不透明。
buffer.writeu8(pixelsBuffer, pixelIndex + 3, 255)
end
editableImage:WritePixelsBuffer(Vector2.zero, editableImage.Size, pixelsBuffer)