Aprenda
Classe do mecanismo
EditableImage
Não criável

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Propriedades
Métodos
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):()
WritePixelsBuffer(position: Vector2,size: Vector2,buffer: buffer):()
Membros herdados

Referência API
Propriedades
Size
Somente leitura
Não replicado
Ler Parallel
Recursos: DynamicGeneration
EditableImage.Size:Vector2

Métodos
Destroy
Recursos: DynamicGeneration
EditableImage:Destroy():()
Devolução
()

DrawCircle
Recursos: DynamicGeneration
EditableImage:DrawCircle(
center:Vector2, radius:number, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing
):()
Parâmetros
center:Vector2
radius:number
color:Color3
transparency:number
antiAliasing:Enum.AntiAliasing
Valor Padrão: "Enabled"
Devolução
()

DrawImage
Recursos: DynamicGeneration
EditableImage:DrawImage(
position:Vector2, image:EditableImage, combineType:Enum.ImageCombineType
):()
Parâmetros
position:Vector2
Devolução
()

DrawImageProjected
Recursos: DynamicGeneration
EditableImage:DrawImageProjected(
mesh:EditableMesh, projection:Dictionary, brushConfig:Dictionary
):()
Parâmetros
projection:Dictionary
brushConfig:Dictionary
Devolução
()

DrawImageTransformed
Recursos: DynamicGeneration
EditableImage:DrawImageTransformed(
position:Vector2, scale:Vector2, rotation:number, image:EditableImage, options:Dictionary?
):()
Parâmetros
position:Vector2
scale:Vector2
rotation:number
options:Dictionary?
Devolução
()
Amostras de código
EditableImage:DrawImageTransformed()
local AssetService = game:GetService("AssetService")
-- Exemplo de desenhar uma imagem rotacionada e escalada sobre outra EditableImage
local srcImage = AssetService:CreateEditableImage({ Size = Vector2.new(256, 256) })
local dstImage = AssetService:CreateEditableImage({ Size = Vector2.new(512, 512) })
-- Desenhando com uma rotação de 45 graus, escalando por 2x e posicionando em (100, 100)
dstImage:DrawImageTransformed(
Vector2.new(100, 100), -- Posição
Vector2.new(2, 2), -- Escala
45, -- Rotação (graus)
srcImage, -- Imagem de origem
{
CombineType = Enum.ImageCombineType.AlphaBlend, -- Opcional, padrão é AlphaBlend
SamplingMode = Enum.ResamplerMode.Default, -- Opcional, padrão é Default
PivotPoint = srcImage.Size / 2, -- Opcional, padrão é o centro da imagem de origem
}
)
EditableImage:DrawImageTransformed() - Recortar
local AssetService = game:GetService("AssetService")
-- Imagem de origem
local srcImage = AssetService:CreateEditableImageAsync(Content.fromUri(assetUri))
-- Área de recorte definida por deslocamento e tamanho
local cropOffset = Vector2.new(50, 50)
local cropSize = Vector2.new(100, 100)
-- Imagem de destino com tamanho da área de recorte
local dstImage = AssetService:CreateEditableImage({ Size = cropSize })
-- Posição (canto superior esquerdo)
local position = Vector2.new(0, 0)
-- Fatores de escala (sem escala)
local scale = Vector2.new(1, 1)
-- Ângulo de rotação (sem rotação)
local rotation = 0
-- Desenhe a imagem de origem na imagem de destino com o pivot ajustado para recortar a imagem
dstImage:DrawImageTransformed(position, scale, rotation, srcImage, {
CombineType = Enum.ImageCombineType.Overwrite,
PivotPoint = cropOffset, -- Defina o ponto pivot como cropOffset para começar a desenhar a partir daí
})

DrawLine
Recursos: DynamicGeneration
EditableImage:DrawLine(
p1:Vector2, p2:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing
):()
Parâmetros
color:Color3
transparency:number
antiAliasing:Enum.AntiAliasing
Valor Padrão: "Enabled"
Devolução
()

DrawRectangle
Recursos: DynamicGeneration
EditableImage:DrawRectangle(
position:Vector2, size:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType
):()
Parâmetros
position:Vector2
size:Vector2
color:Color3
transparency:number
Devolução
()

ReadPixelsBuffer
Escrever Parallel
Recursos: DynamicGeneration
EditableImage:ReadPixelsBuffer(
position:Vector2, size:Vector2
Parâmetros
position:Vector2
size:Vector2
Devolução
Amostras de código
EditableImage: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 = workspace

WritePixelsBuffer
Recursos: DynamicGeneration
EditableImage:WritePixelsBuffer(
position:Vector2, size:Vector2, buffer:buffer
):()
Parâmetros
position:Vector2
size:Vector2
buffer:buffer
Devolução
()
Amostras de código
EditableImage:WritePixelsBuffer()
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))
-- Defina a opacidade para 255 para tornar todos os pixels totalmente opacos.
buffer.writeu8(pixelsBuffer, pixelIndex + 3, 255)
end
editableImage:WritePixelsBuffer(Vector2.zero, editableImage.Size, pixelsBuffer)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.