EditableImage | 文件 - Roblox 創作者中心

引擎類別

EditableImage

無法建立

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

概要

屬性

Size:Vector2

方法

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 參考

屬性

Size

唯讀

未複製

平行讀取

功能： DynamicGeneration

EditableImage.Size:Vector2

方法

Destroy

功能： DynamicGeneration

EditableImage:Destroy():()

()

DrawCircle

功能： DynamicGeneration

EditableImage:DrawCircle(

center:Vector2, radius:number, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing

):()

參數

center:Vector2

radius:number

color:Color3

transparency:number

combineType:Enum.ImageCombineType

antiAliasing:Enum.AntiAliasing

預設值："Enabled"

()

DrawImage

功能： DynamicGeneration

EditableImage:DrawImage(

position:Vector2, image:EditableImage, combineType:Enum.ImageCombineType

):()

參數

position:Vector2

image:EditableImage

combineType:Enum.ImageCombineType

()

DrawImageProjected

功能： DynamicGeneration

EditableImage:DrawImageProjected(

mesh:EditableMesh, projection:Dictionary, brushConfig:Dictionary

):()

參數

mesh:EditableMesh

projection:Dictionary

brushConfig:Dictionary

()

DrawImageTransformed

功能： DynamicGeneration

EditableImage:DrawImageTransformed(

position:Vector2, scale:Vector2, rotation:number, image:EditableImage, options:Dictionary?

):()

參數

position:Vector2

scale:Vector2

rotation:number

image:EditableImage

options:Dictionary?

()

範例程式碼

可編輯圖像: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

功能： DynamicGeneration

EditableImage:DrawLine(

p1:Vector2, p2:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType, antiAliasing:Enum.AntiAliasing

):()

參數

p1:Vector2

p2:Vector2

color:Color3

transparency:number

combineType:Enum.ImageCombineType

antiAliasing:Enum.AntiAliasing

預設值："Enabled"

()

DrawRectangle

功能： DynamicGeneration

EditableImage:DrawRectangle(

position:Vector2, size:Vector2, color:Color3, transparency:number, combineType:Enum.ImageCombineType

):()

參數

position:Vector2

size:Vector2

color:Color3

transparency:number

combineType:Enum.ImageCombineType

()

ReadPixelsBuffer

平行寫入

功能： DynamicGeneration

EditableImage:ReadPixelsBuffer(

position:Vector2, size:Vector2

):buffer

參數

position:Vector2

size:Vector2

buffer

範例程式碼

可編輯圖像:讀取像素緩衝區()

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

功能： DynamicGeneration

EditableImage:WritePixelsBuffer(

position:Vector2, size:Vector2, buffer:buffer

):()

參數

position:Vector2

size:Vector2

buffer:buffer

()

範例程式碼

可編輯圖片:寫入像素緩衝區()

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)

EditableImage

DrawImageTransformed()