ImageLabel

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.

ImageLabel menyajikan segi empat, seperti yang dilakukan Frame , dengan aset gambar.显示图像可以 dimanipulasi melalui ImageColor3 dan

Penggunaan ImageLabel yang ditingkatkan termasuk:

  • Gambar berukuran besar dapat dibuat dengan menetapkan ScaleType ke Enum.ScaleType.Tile , lalu TileSize ke ukuran gambar yang di render.

  • Gambar 9-slot dapat dibuat dengan menetapkan ScaleType ke Enum.ScaleType.Slice , lalu SliceCenter ke area pusat dari gambar 9-slot.

  • Sprite sheet dapat dilaksanakan melalui penggunaan ImageRectOffset dan ImageRectSize . Mengemas banyak gambar ke dalam satu dan menggunakan property ini dapat membuat aset gambar pengalaman Anda berjalan lebih cepat, terutama jika Anda menggunakan banyak ikon kecil di GUI And

Rangkuman

Properti

Properti diwarisi dari GuiObjectProperti diwarisi dari GuiBase2d
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Metode diwarisi dari GuiObject
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Acara diwarisi dari GuiObjectAcara diwarisi dari GuiBase2d
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Properti

Image

ContentId
Baca Paralel

Properti ini adalah properti jenis konten yang harus menyimpan ID aset dari decal atau gambar yang diunggah ke Roblox. Ini berfungsi sama seperti Decal.Texture dengan mengenai pemuatan gambar dari Roblox. Gambar yang di render dapat diubah menggunakan Class.ImageLabel.Image

ImageColor3

Color3
Baca Paralel

Properti ImageColor3 menentukan cara gambar dikolor. Saat diatur ke putih, tidak ada kolorisasi yang terjadi. Propiedad ini sangat berguna untuk menggunakan kembali sumber gambar; jika gambar sumbernya benar-benar putih dengan transparansi, Anda dapat menetapkan seluruh warna gambar dengan satu properti ini.

ImageContent

Content
Tersembunyi
Baca Paralel

Properti ini harus menyimpan URI aset atau referensi ke objek EditableImage.

URL aset dapat mengacu pada decal atau gambar yang diunggah ke Roblox. Ini berfungsi secara identik dengan Decal.Texture dalam hal memuat gambar.

Gambar yang dihasilkan akan dikolor menggunakan ImageButton.ImageColor3 . Mungkin untuk membuat gambar rendah sebagai ubin, skala untuk menyesuaikan, atau 9-sliced, dengan menyesuaikan propinsi ImageButton.ScaleType .

ImageRectOffset

Vector2
Baca Paralel

Mengizinkan tampilan parcial dari gambar bersama dengan ImageRectSize . Item ini menentukan OFFSET PIXEL (dari bagian atas kiri) dari area gambar yang akan ditampilkan.

ImageRectSize

Vector2
Baca Paralel

Mengizinkan tampilan parcial dari gambar bersama dengan ImageRectOffset . Item ini menentukan ukuran pixel area gambar yang akan ditampilkan. Jika dimensi mana pun di set ke 0, seluruh gambar ditampilkan alih-alih.

ImageTransparency

number
Baca Paralel

ImageTransparency Determines the alpha of a UI element's rendered image. A value of 0 is completely opaque and a value of 1 is completely transparent (invisible).

Contoh Kode

Oscillate ImageTransparency
local RunService = game:GetService("RunService")



local imageLabel = script.Parent



local function onRenderStep()

	-- Oscillate ImageTransparency from 0 to 1 using a sine wave

	imageLabel.ImageTransparency = math.sin(workspace.DistributedGameTime * math.pi) * 0.5 + 0.5

end



RunService.RenderStepped:Connect(onRenderStep)

IsLoaded

bool
Hanya Baca
Tidak Direplikasi
Baca Paralel

Properti IsLoaded menunjukkan apakah properti ImageLabel.Image telah selesai dimuat dari Roblox. Gambar yang ditolak oleh moderasi tidak akan pernah load.

Contoh Kode

Image Load Time
local imageLabel = script.Parent



local startTime = workspace.DistributedGameTime



-- Wait for the image to load

while not imageLabel.IsLoaded do

	task.wait()

end



-- Measure and display how long it took to load

local deltaTime = workspace.DistributedGameTime - startTime

print(("Image loaded in %.3f seconds"):format(deltaTime))

ResampleMode

Enum.ResamplerMode
Baca Paralel

Mengesankan bagaimana tampilan gambar ketika diubah skalanya. Secara default, gambar menyamarkan teksur ketika ditampilkan di layar lebih besar atau lebih kecil dari ukurannya dalam memori tekstur. Saat diatur ke Enum.ResamplerMode.Pixelated, gambar menyimpan sudut tajam dari pixel.

ScaleType

Enum.ScaleType
Baca Paralel

Properti ScaleType menentukan dengan cara apa sebuah ImageLabel.Image dibuat ketika ukuran elemen UI berbeda dari ukuran gambar sumber.

Secara default, property ini adalah Enum.ScaleType.Stretch yang hanya akan mengunggah dimensi gambar sehingga sesuai dengan ruang elemen UI tepat. Karena pixel transparan diatur untuk hitam saat mengunggah ke Roblox, gambar transparan harus menerapkan bluring alfa untuk menghindari kontur hitam di sekitar gambar skalable.

Untuk Enum.ScaleType.Slice , property SliceCenter akan diungkapkan dalam jendela Properti. Ini adalah untuk sembilan slot UI: saat menyesuaikan ukuran, sudut-sudut akan tetap menjadi ukuran gambar sumber. Ujung gambar akan diperpanjang ke le

Akhirnya, untuk Enum.ScaleType.Tile, property TileSize akan diungkapkan di jendela Properties. Ini untuk gambar berkilau, di mana ukuran setiap gambar diletakkan oleh propinsi Class.ImageLabel.TileSize|TileSize.

SliceCenter

Rect
Baca Paralel

Properti SliceCenter menetapkan batas potongan gambar 9-sliced ketika ScaleType di set ke Enum.ScaleType.Slice . Harap perhatikan bahwa property ini hanya terlihat di jendela 1>Properti1> di bawah kondisi ini.

Untuk mempelajari lebih lanjut tentang gambar 9 slot, lihat Desain UI 9 Slot .

SliceScale

number
Baca Paralel

Skala ujung 9 slot dengan rasio yang ditentukan. Ini berarti bahwa ujung-ujung di sekitar 9 slot akan tumbuh seolah-olah Anda mengunggah versi baru dari teksur yang ditingkatkan. Standar untuk 1.0 .

Lihat juga ScaleType , SliceCenter , dan SliceScale .

TileSize

UDim2
Baca Paralel

TileSize mengatur ukuran ubin dari ImageLabel dengan default UDim2.new(1, 0, 1, 0). Ubin dimulai di sudut kiri at

Contoh Kode

Image ScaleType Demo
local imageLabel = script.Parent



-- Set the source image to be a 64x64 padlock

imageLabel.Image = "rbxassetid://284402752"

imageLabel.BackgroundTransparency = 0

imageLabel.BackgroundColor3 = Color3.new(1, 1, 1) -- White

imageLabel.ImageColor3 = Color3.new(0, 0, 0) -- Black



local function resizeInACircle()

	for theta = 0, 2, 0.02 do

		imageLabel.Size = UDim2.new(

			0,

			100 + math.cos(theta * 2 * math.pi) * 50,

			0,

			100 + math.sin(theta * 2 * math.pi) * 50

		)

		task.wait()

	end

end



while true do

	-- Stretch simply stretches the source image to fit

	-- the UI element's space

	imageLabel.ScaleType = Enum.ScaleType.Stretch

	resizeInACircle()

	-- Tile will render the source image multiple times

	-- enough to fill the UI element's space

	imageLabel.ScaleType = Enum.ScaleType.Tile

	imageLabel.TileSize = UDim2.new(0, 64, 0, 64)

	resizeInACircle()

	-- Slice will turn the image into a nine-slice UI.

	imageLabel.ScaleType = Enum.ScaleType.Slice

	imageLabel.SliceCenter = Rect.new(30, 30, 34, 34)

	resizeInACircle()

end
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object