ImageLabel
*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
Arayüz elemanı tarafından gösterilen görüntü içeriği. Okuyor ve ImageContent yazıyor.
Render edilmiş bir görüntünün nasıl renklendirileceğini belirler.
Arayüz elemanı tarafından gösterilen görüntü içeriği. varlık URI'lerini ve EditableImage destekler.
Görüntünün alt alanındaki piksellerdeki ofset. Görüntü gösterilecek.
Görüntünün alt alanının piksel boyutunu belirler ve görüntü görüntülenir.
Rendelenen görüntünün transparanlığını belirler.
Resmin Roblox'tan yüklenmesi bitip bitmediğini gösterir.
Etiket için görüntü yeniden boyutlandırma modunu seçer.
Bir görüntünün kaynağından farklı bir boyuta sahip bir UI öğesinde görüntülenmesi durumunda ölçekleneceğini belirler.
9 dilimli bir görüntünün dilim sınırlarını ayarlar.
9 dilim kenarlarını belirtilen oranla ölçeklendirir.
ImageLabel 'nin kare boyutunu ayarlar.
Bu UI öğesinin girişi alıp almadığını belirler.
Bir GuiObject 'in mutlak boyutuna göre kaynağı noktasını belirler, mutlak boyutuna göre.
Yeniden boyutlandırmanın çocuk içeriğine dayalı olup olmadığını belirler.
GuiObject arka plan rengini belirler.
GuiObject arka planının ve sınırının saydamlığını belirler.
GuiObject sınırının rengini belirler.
GuiObject sınırının boyutlarına göre nasıl düzenleneceğini belirler.
GuiObject sınırının piksel genişliğini belirler.
Ebeveyn bir GUI öğesinin sınırlarının dışında olup olmadığına bakarak altının GuiObjects renderlanması gereip geremediğini belirler.
oyuncumouse'unun GuiObject üzerinde aktif olarak basılıp basılmadığını belirler.
GuiButton ile etkileşime girilebilir olup olmadığını veya GuiState 'nin değişip değişmediğini belirler, ya da GuiObject 'nin değişip değişmediği.
Bir GuiObject ile kullanıldığında UIGridStyleLayout sıralama düzenini kontrol eder.
Oyun kolu seçicisi aşağıya kaydırıldığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sola taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sağa taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisi yukarı taşındığında seçilecek GuiObject ayarını ayarlar
GuiObject 'nin piksel ve skalar konumunu belirler.
GuiObject döndürüldüğünde döndürülen derece sayısını belirler.
GuiObject bir oyun kolu tarafından seçilebilir olup olmadığını belirleyin.
Oyun konsolları için kullanılan varsayılan seçim aksesuarlarını değiştirir.
Oyun kumanda UI seçimi tarafından seçilen GuiObjects sırası.
GuiObject 'nin piksel ve skalar büyüklüğünü belirler.
Size eksenlerini ayarlar, üzerinde ebeveynin boyutuna göre yapılacak GuiObject , ebeveynin boyutuna göre yapılacak
BackgroundTransparency ve TextTransparency 'in karışık bir özelliği.
GuiObject ve onun soyundakilerin render edilecek olup olmadığını belirler.
Bir GuiObject'nin diğerlerine göre hangi sırayla görüntüleneceğini belirler.
Bir GuiBase2d öğesinin gerçek ekran konumunu, piksel olarak tanımlar.
Bir GuiBase2d öğesinin gerçek ekran dönüşünü derecelerle tanımlar.
Bir GuiBase2d öğesinin gerçek ekran boyutunu, piksel olarak tanımlar.
true olarak ayarlanırsa, yerelleştirme bu GuiBase2d ve onun soyundakilere uygulanacaktır.
Bu GuiBase2d ve onun soyundakilere otomatik yerelleştirme uygulamak için kullanılacak bir LocalizationTable.
Aşağı yönünde oyun kolu seçim davranışını özelleştirir.
Oyun kolu seçim davranışını sol yönde özelleştirir.
Oyun kolu seçim davranışını doğru yönde özelleştirir.
Oyun kolu seçim davranışını yukarı yönünde özelleştirir.
Oyun kolu seçim hareketinin özelleştirilmesine izin verir.
Yöntemler
Şuradan alınan Yöntemler: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir UDim2 'ye taşır.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GuiObject 'yi yumuşak bir şekilde yeni bir UDim2 'ye yeniden boyutlandırır.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir boyuta ve konuma taşır.
Etkinlikler
Şuradan alınan Etkinlikler: GuiObjectBir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime başladığında ateş edilir (Fare düğmesi aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla nasıl etkileşime girdiğini değiştirdiğinde ateş edilir (Fare düğmesü aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime son verdiğinde ateş edilir (Mouse düğmes aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcının fareini bir GUI öğesine taşıdığında ateş eder.
Bir kullanıcı GUI öğesinden fareni taşıdığında ateş eder.
Bir kullanıcı bir GUI öğesinin içindeyken fareyi hareket ettirdiğinde herhangi bir zamanda ateş eder.
Bir kullanıcı, fare bir GUI öğesinin üzerinde olduğunda fare tekerleğini geri sürüklediğinde ateş eder.
Bir kullanıcı, fare işaretçisi bir GUI öğesinin üzerinde olduğunda fare tekerleğini ileriye doğru kaydırdığında ateş eder.
GuiObject, Gamepad seçicisi ile odaklanırken ateş edildi.
Oyun Konsolu seçicisi GuiObject'e odaklanmayı bıraktığında ateş edilir.
Oyuncu başladığında, devam ettiğinde ve uzun süre UI öğesine basmayı bıraktığında ateş eder.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Oyuncu UI öğesine parmağını hareket ettirdiğinde ateş eder.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir kıskaç veya çekme hareketi gerçekleştirdiğinde ateş eder.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir dönüş hareketi gerçekleştirdiğinde ateş eder.
Oyuncu UI öğesine kaydırma hareketi yaptığında ateş eder.
Oyuncu UI öğesine dokunma hareketi yaptığında ateş eder.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Oyun kolu seçimi, hareket eder, değişir veya bağlantılı GuiBase2d veya herhangi bir altın içinde değişir, bağlantılı GuiObjects .
Özellikler
Image
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
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
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
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
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
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.
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
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.
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
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.
ScaleType
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
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
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
Bu özellik, ImageLabel ile
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.
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