ImageLabel

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir ImageLabel bir dikdörtgen çizer, bir Frame gibi, bir görüntü öğesi ile.Resmin görüntülenmesi ImageColor3 ve ImageTransparency özellikleri aracılığıyla manipüle edilebilir.Sadece resmi görüntülemek ve dikdörtgeni gizlemek için, GuiObject.BackgroundTransparency ile 1 arasında ayarlayın.

Gelişmiş ImageLabel kullanımı şunları içerir:

  • Kareli görüntüler, ScaleType ile Enum.ScaleType.Tile ayarlanarak oluşturulabilir, ardından TileSize render edilen karelerin boyutuna ayarlanır.

  • 9 dilimli görüntüler, ScaleType 9 dilimli görüntünün merkez alanına yerleştirilerek Enum.ScaleType.Slice ayarlanarak oluşturulabilir, ardından SliceCenter 9 dilimli görüntünün merkez alanına yerleştirilir.

  • Sprite sayfaları ImageRectOffset ve ImageRectSize kullanılarak uygulanabilir.Birden fazla görüntüyü bir araya getirip bu özelliği kullanmak, özellikle de GUI'lerinizde çok sayıda küçük ikon kullandığınızda, deneyim görüntü kaynaklarının yüklenmesini çok daha hızlı hale getirebilir.

Özet

Özellikler

Şuradan alınan Özellikler: GuiObjectŞuradan alınan Özellikler: GuiBase2d

Yöntemler

Şuradan alınan Yöntemler: GuiObject

Etkinlikler

Şuradan alınan Etkinlikler: GuiObjectŞuradan alınan Etkinlikler: GuiBase2d

Özellikler

Image

ContentId
Paralel oku

Bu özellik, Roblox'a yüklenen bir rozet veya görüntünün ID'sini tutan bir içerik türü özelliğidir.Roblox'tan görüntü yükleme konusunda aynı şekilde çalışır Decal.Texture .Kararlı görüntü ImageColor3 ve ImageTransparency kullanılarak değiştirilebilir.

ImageColor3

Paralel oku

Bu özellik, bir görüntünün nasıl renklendirileceğini belirler.Beyaz olarak ayarlanırsa, renklendirme gerçekleşmez.Bu özellik, görüntü varlıklarını yeniden kullanmak için çok yararlıdır; kaynak görüntü transparanlıkla tamamen beyazsa, tüm görüntünün rengini bu özellikle bir kerede ayarlayabilirsiniz.

ImageContent

Paralel oku

Bu özellik bir varlık URI'si veya bir EditableImage referans tutmalıdır.

Varlık URI, Roblox'a yüklenen bir rozet veya görüntü referansına işaret edebilir. Görüntü yükleme konusunda Decal.Texture ile aynı şekilde işlev görür.

Kararlı görüntü, ImageButton.ImageColor3 kullanarak renklendirilecektir.Görüntüyü döşemeli, ölçeklendirilmiş veya 9 parçaya bölünmüş olarak render etmek mümkündür, çünkü ImageButton.ScaleType özelliğini ayarlayabilirsiniz.

ImageRectOffset

Paralel oku

Bir görüntünün kısmi gösterimini ImageRectSize ile birleştirerek sağlar.Bu özellik, görüntü alanının görüntülenmesi gereken piksel ofsetini (en üst soldan) belirler.

ImageRectSize

Paralel oku

Bir görüntünün kısmi gösterimini ImageRectOffset ile birleştirerek sağlar.Bu özellik, görüntü alanında görüntülenecek piksel boyutunu belirler.Her iki boyut da 0 olarak ayarlanırsa, tüm görüntü yerine gösterilir.

ImageTransparency

Paralel oku

Bu özellik, bir UI öğesinin görüntüsünün alfa değerini belirler.Bir değer 0 bütünüyle opaktır ve bir değer 1 bütünüyle şeffaftır (görünmez).

Kod Örnekleri

This code sample oscillates the ImageTransparency of an ImageLabel/ImageButton from 0 to 1 using a sine wave.

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

Salt Okunur
Çoğaltılmamış
Paralel oku

Bu özellik, ImageLabel.Image özelliğinin Roblox'tan yüklenmesinin bitip bitmediğini gösterir. Moderasyon tarafından reddedilen görüntüler asla yüklenmez.

Kod Örnekleri

This code sample measures how long an ImageLabel or ImageButton takes to load an image. If the image was already loaded, this will be 0.

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

Paralel oku

Resmin ölçeklendirildiğinde nasıl göründüğünü belirler.Varsayılan olarak, görüntü, dokunma hafızasındaki boyutundan daha büyük veya daha küçük göründüğünde dokulu hale gelir.Enum.ResamplerMode.Pixelated olarak ayarlanırken, görüntü piksellerin keskin kenarlarını korur.

Paralel oku

Bu özellik, UI öğesinin mutlak boyutu kaynak görüntüsünün boyutundan farklı olduğunda bir ImageLabel.Image'nin nasıl görüntüleneceğini belirler.

Varsayılan olarak, bu özellik Enum.ScaleType.Stretch dir, ki bu sadece görüntü boyutlarını genişletir/kompaktlaştırır ve böylece UI öğesinin alanına uyar.Transparan pikseller Roblox'a yüklendiğinde siyaha ayarlandığından, transparan görüntüler ölçekli görüntülerin etrafında koyu bir çizgi önlemek için alfa karışımı uygulamalıdır.

For Enum.ScaleType.Slice için, SliceCenter özelliği Özellikler penceresinde gösterilecektir.Dokuz dilimli UI için bu: ölçeklendirme sırasında köşeler kaynak görüntü boyutunu korur.Görüntünün kenarları görüntünün genişliğine/yüksekliğine uzanacaktır.Son olarak, görüntünün merkezi, görüntünün merkezi alanını doldurmak için genişleyecektir.

Son olarak, Enum.ScaleType.Tile için, TileSize özelliği Özellikler penceresinde gösterilecektir.Bu, her bir görüntü karesinin boyutunun TileSize özelliği tarafından belirlendiği kareli görüntüler içindir.

SliceCenter

Paralel oku

Bu özellik, Class.ImageLabel.ScaleType|ScaleType``Enum.ScaleType.Slice|Enum.ScaleType.Slice >.Lütfen bu özelliğin bu koşul altında yalnızca Özellikler penceresinde görülebildiğini unutmayın.

9 dilimli görüntüler hakkında daha fazla bilgi edinmek için, UI 9 Slice Tasarımı'yi görün.

SliceScale

Paralel oku

9 dilim kenarlarını belirtilen oranla ölçeklendirir.Bu, 9 dilimin kenarlarının, yüksek çözünürlüklü dokunun yeni bir versiyonunu yüklemiş gibi büyüyeceği anlamına gelir.Varsayılan değeri 1.0 dir.

Ayrıca bakınız ScaleType , SliceCenter ve SliceScale .

TileSize

Paralel oku

Bu özellik, ImageLabel ile UDim2.new(1, 0, 1, 0) 'in yerleşim boyutunu varsayılan olarak ayarlar.Kare döşeme, görüntünün sol üst kısmında başlar.Bu özellik yalnızca ScaleType için ImageLabel ın Enum.ScaleType.Tile olarak ayarlanması halinde aktif olur.

Kod Örnekleri

This code sample demonstrates the different ScaleType options - Stretch, Tile and Slice. It does this by resizing an ImageLabel/ImageButton in a circle.

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

Yöntemler

Etkinlikler