EditableImage

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat

EditableImage memungkinkan pembuatan dan manipulasi gambar saat eksekusi.

Untuk membuat EditableImage kosong, gunakan AssetService:CreateEditableImage() . Untuk membuat EditableImage dari gambar yang sudah ada, gunakan 1> Class.AssetService:CreateEditableImageAsync()1> .

Class.EditableImage dapat digunakan di setiap Content property yang mengambil gambar, seperti ImageLabel.ImageContent atau 0> Class.MeshPart.TextureContent0> . Ini dilakukan dengan menetapkan konten property ke 3> Datatype.Content.fromObject(editableImage)</

Sistem koordinasi EditableImage adalah relatif terhadap bagian atas kiri gambar:

  • Top-kiri: (0, 0)
  • Bawah: kanan: (Size.X - 1, Size.Y - 1)

Ketika Anda menggunakan AssetService:PromptCreateAssetAsync() untuk menerbitkan objek yang memiliki Content propietas y referensi ke EditableImage, gambar yang dapat diubah diterbitkan sebagai gambar dan prop adalah tetap sebagai ID baru.

Mengaktifkan EditableImage untuk Pengalaman Terbit

Untuk tujuan keamanan, menggunakan EditableImage gagal secara default untuk pengalaman yang diterbitkan. Untuk mengaktifkan penggunaan EditableImage, Anda harus berusia 13+ dan ID yang diverifikasi. Setelah Anda diverifikasi, buka **Studio. Select

Izinkan

Untuk mencegah penyalahgunaan, AssetService:CreateEditableImageAsync() hanya memungkinkan Anda untuk memuat dan mengedit aset gambar:

  • Itu dimiliki oleh pembuatnya pengalaman (jika pengalaman dimiliki oleh seorang individu).
  • Itu dimiliki oleh kelompok (jika pengalaman dimiliki oleh grup).
  • Itu dimiliki oleh pengguna Studio yang masuk (jika file tempat belum disimpan atau diterbitkan ke Roblox).

API menyebabkan kesalahan jika mereka digunakan untuk memuat aset yang tidak memenuhi kriteria di atas.

Rangkuman

Properti

Lihat semua yang diwarisi dari Object

Metode

Lihat semua yang diwarisi dari Object

Properti

Size

Vector2
Hanya Baca
Tidak Direplikasi
Baca Paralel

Ukuran EditableImage dalam pixel. Ukuran maksimum adalah 1024×1024. Sebuah EditableImage tidak dapat diubah; property ini hanya dibaca. Unt

Lihat semua yang diwarisi dari Object

Metode

Destroy

void

Menghancurkan konten gambar, segera mengklaim kembali memori yang digunakan.


Memberikan nilai

void

DrawCircle

void

Menggambar lingkaran di titik yang ditentukan di EditableImage . Jika lingkaran semi-transparan, itu akan dicampur dengan pixel di belakang menggunakan sumber over bluring.

Parameter

center: Vector2

Pusat dari lingkaran, relatif ke sudut atas kiri dari EditableImage . Posisi di luar batas kanvas diperbolehkan.

radius: number

Radius dari lingkaran dalam pixel.

color: Color3

Warna lingkaran.

transparency: number

Transparansi lingkaran dengan 0 menjadi benar-benar opak dan 1 menjadi benar-benar transparan.

combineType: Enum.ImageCombineType

Bagaimana pixel dari gambar sumber dicampur dengan pixel dari gambar yang ditambahkan.


Memberikan nilai

void

DrawImage

void

Menggambar another EditableImage into this EditableImage at the given position. Posisi di luar batas kanvas diizinkan sehingga hanya bagian dari gambar baru yang dibuat.

Parameter

position: Vector2

Posisi di mana sudut kiri atas gambar yang ditambahkan akan dibuat.

image: Object

Class.EditableImage untuk menarik ke dalam ini EditableImage .

combineType: Enum.ImageCombineType

Bagaimana pixel dari gambar sumber harus dicampur dengan pixel dari gambar yang ditambahkan.


Memberikan nilai

void

DrawImageProjected

void

Parameter

mesh: Object
projection: Dictionary
brushConfig: Dictionary

Memberikan nilai

void

DrawImageTransformed

void

Metode ini memungkinkan Anda menarik EditableImage ke dalam EditableImage ini dengan transformasi diterapkan, seperti skalierung dan rotasi. Posisi parameter menentukan di mana posisi pivot dari gambar sumber akan ditempatkan di gambar ini setelah transformasi. Posisi di luar batas kanvas diizinkan sehingga hanya bagian dari gambar baru yang dibuat.

Parameter

position: Vector2

Posisi dalam pixel di mana titik pivot gambar sumber akan ditempatkan di gambar ini.

scale: Vector2

Mengubah faktor skalasi untuk gambar sumber di sumbu X dan Y.

rotation: number

Sudut rotasi dalam derajat, diterapkan di sekitar titik pivot gambar sumber.

image: Object

Sumber EditableImage untuk ditarik ke dalam gambar ini.

options: Dictionary

Diksiopter dictionaire untuk konfigurasi tambahan:

  • CombineType : Menentukan cara pixel gambar sumber bergabung dengan Destinasi. Standar adalah Enum.ImageCombineType.AlphaBlend .
  • SamplingMode : Spesifikasi metode samplning (misalnya Default untuk bilinear atau Pixelated untuk tetangga terdekat). Standar adalah 0> Enum.ResamplerMode.Default0> .
  • PivotPoint : Menentukan titik pivot dalam gambar sumber untuk skalierung dan rotasi. Standar adalah pusat gambar sumber (yaitu Image.Size / 2).

Memberikan nilai

void

Contoh Kode

The following code draws a rotated and scaled image onto another.

EditableImage:DrawImageTransformed()
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

	}

)

The following code shows how cropping an image can be done using the EditableImage:DrawImageTransformed() method.

EditableImage:DrawImageTransformed() - Crop
local AssetService = game:GetService("AssetService")



-- Source image

local srcImage = AssetService:CreateEditableImageAsync(Content.fromUri(assetUri))



-- Crop area defined by offset and size

local cropOffset = Vector2.new(50, 50)

local cropSize = Vector2.new(100, 100)



-- Destination image with size of the crop area

local dstImage = AssetService:CreateEditableImage({ Size = cropSize })



-- Position (top-left corner)

local position = Vector2.new(0, 0)



-- Scale factors (no scaling)

local scale = Vector2.new(1, 1)



-- Rotation angle (no rotation)

local rotation = 0



-- Draw the source image onto the destination image with adjusted pivot to crop the image

dstImage:DrawImageTransformed(

	position,

	scale,

	rotation,

	srcImage,

	{

		CombineType = Enum.ImageCombineType.Overwrite,

		PivotPoint = cropOffset  -- Set pivot point to cropOffset to start drawing from there

	}

)

DrawLine

void

Menggambar garis anti-aliased pada EditableImage satu pixel kayu antara dua poin yang disediakan.

Parameter

p1: Vector2

Awali titik garis.

p2: Vector2

Akhir poin dari garis.

color: Color3

Warna garis.

transparency: number

Transparansi dari garis.

combineType: Enum.ImageCombineType

Bagaimana pixel dari gambar sumber dicampur dengan pixel dari gambar yang ditambahkan.


Memberikan nilai

void

DrawRectangle

void

Menggambar segi empat di EditableImage dari ukuran yang diberikan di posisi atas kiri yang diberikan.

Parameter

position: Vector2

Posisi bagian atas kiri dari persegi. Tidak seperti metode pembuatan lainnya, ini tidak dapat dibuat di luar batas kanvas Class.EditableImage .

size: Vector2

Ukuran persegi untuk ditambahkan, dalam pixel.

color: Color3

Warna persegi.

transparency: number

Transparansi persegi.

combineType: Enum.ImageCombineType

Bagaimana pixel dari gambar sumber dicampur dengan pixel dari gambar yang ditambahkan.


Memberikan nilai

void

ReadPixelsBuffer

buffer
Tulis Paralel

Sebuah versi dari ReadPixels() yang mengembalikan cache bukan tabel. Setiap nomor dalam cache adalah satu bit, sementara setiap nomor dalam tabel adalah 4 bit, menjadikan ReadPixelsBuffer() lebih efisien daripada

Catat bahwa metode ini menggunakan alfa bukan transparansi, berbeda dengan metode EditableImage menggambar.

Parameter

position: Vector2

Sudut kanan atas dari sudut region piksel untuk dilihat.

size: Vector2

Ukuran wilayah persegi pixel untuk dilihat.


Memberikan nilai

buffer

Buffer di mana setiap pixel diwakili oleh empat bit (merah, hijau, biru, dan alfa masing-masing). Panjang buffer dapat dihitung sebagai Size.X * Size.Y * 4 bytes.

Contoh Kode

The following code reads two pixels from a EditableImage and creates a part with the average color between them.

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

void

Sebuah versi dari WritePixels() yang mengambil cache bukan tabel. Setiap nomor dalam cache adalah satu bit, sementara setiap nomor dalam tabel adalah 4 bit, menjadikan WritePixelsBuffer() lebih efisien daripada

Catat bahwa metode ini menggunakan alfa bukan transparansi, berbeda dengan metode EditableImage menggambar.

Parameter

position: Vector2

Sudut kiri atas dari daerah persegi untuk menarik pixel ke dalam.

size: Vector2

Ukuran wilayah persegi pixel untuk ditulis.

buffer: buffer

Sebuah buffer di mana setiap pixel diwakili oleh empat bit (merah, hijau, biru, dan alfa masing-masing). Panjang buffer harus menjadi Size.X * Size.Y * 4 bytes.


Memberikan nilai

void

Contoh Kode

The following code reads the pixels of a EditableImage and writes back the inverted color values of those pixels.

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))

	-- Set alpha to 255 to make all pixels fully opaque.

	buffer.writeu8(pixelsBuffer, pixelIndex + 3, 255)

end



editableImage:WritePixelsBuffer(Vector2.zero, editableImage.Size, pixelsBuffer)
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Object