ImageLabel

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Um ImageLabel renderiza um retângulo, como um Frame faz, com um ativode imagem.O exibição da imagem pode ser manipulada através das propriedades ImageColor3 e ImageTransparency.Para exibir apenas a imagem e ocultar o retângulo, defina GuiObject.BackgroundTransparency para 1.

O uso avançado ImageLabel inclui:

  • Imagens em azulejos podem ser criadas definindo ScaleType para Enum.ScaleType.Tile , então TileSize para o tamanho dos azulejos renderizados.

  • imagens de 9 fatias podem ser criadas definindo ScaleType para Enum.ScaleType.Slice , então SliceCenter para a área central da imagem de 9 fatias.

  • Folhas de sprite podem ser implementadas através do uso de ImageRectOffset e ImageRectSize .Embalar várias imagens em uma e usar essa propriedade pode fazer com que os recursos de imagem de sua experiência carreguem muito mais rapidamente, especialmente se você usar muitas pequenas ícones em suas interfaces de usuário.

Resumo

Propriedades

Propriedades herdados de GuiObjectPropriedades herdados de GuiBase2d

Métodos

Métodos herdados de GuiObject

Eventos

Eventos herdados de GuiObjectEventos herdados de GuiBase2d

Propriedades

Image

ContentId
Ler Parallel

Esta propriedade é uma propriedade do tipo conteúdo que deve conter o ID do recurso de um decal ou imagem carregado no Roblox.Ela funciona de forma idêntica a Decal.Texture com relação ao carregamento da imagem do Roblox.A imagem renderizada pode ser modificada usando ImageColor3 e ImageTransparency.

ImageColor3

Ler Parallel

Essa propriedade determina como uma imagem é colorizada.Quando definido para branco, nenhuma colorização ocorre.Essa propriedade é muito útil para reutilizar recursos de imagem; se a imagem de origem for completamente branca com transparência, você pode definir toda a cor da imagem de uma vez com essa propriedade.

ImageContent

Ler Parallel

Essa propriedade deve conter um URI de recurso ou uma referência a um ObjetoEditableImage.

O URI de recurso pode referenciar um decalque ou imagem carregada no Roblox. Funciona de forma idêntica a Decal.Texture em relação ao carregamento da imagem.

A imagem renderizada será colorizada usando ImageButton.ImageColor3 .É possível fazer com que a imagem seja renderizada como azulejada, escalonada para caber ou 9-dividida, ajustando a propriedade ImageButton.ScaleType.

ImageRectOffset

Ler Parallel

Permite a exibição parcial de uma imagem em conjunto com ImageRectSize .Essa propriedade determina o deslocamento de pixels (a partir da esquerda superior) da área de imagem a ser exibida.

ImageRectSize

Ler Parallel

Permite a exibição parcial de uma imagem em conjunto com ImageRectOffset .Essa propriedade determina o tamanho do pixel da área de imagem a ser exibida.Se alguma dimensão for definida como 0, a imagem inteira será exibida em vez disso.

ImageTransparency

Ler Parallel

Essa propriedade determina o alfa da imagem renderizada de um elemento de UI.Um valor de 0 é completamente opaco e um valor de 1 é completamente transparente (invisível).

Amostras de código

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

Somente leitura
Não replicado
Ler Parallel

Essa propriedade indica se a propriedade ImageLabel.Image terminou de carregar do Roblox. Imagens rejeitadas pela moderação nunca serão carregadas.

Amostras de código

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

Ler Parallel

Determina como a imagem aparece quando é escalada.Por padrão, a imagem suaviza a textura ao ser exibida na tela maior ou menor do que seu tamanho na memória de textura.Quando definido para Enum.ResamplerMode.Pixelated, a imagem preserva as bordas afiadas dos pixels.

Ler Parallel

Essa propriedade determina de que maneira um ImageLabel.Image é renderizado quando o tamanho absoluto do elemento da interface difere do tamanho da imagem de origem.

Por padrão, esta propriedade é Enum.ScaleType.Stretch a qual simplesmente estenderá/compactará as dimensões da imagem para que ela se encaixe exatamente no espaço do elemento da interface.Como pixels transparentes são definidos como pretos ao fazer o upload para o Roblox, imagens transparentes devem aplicar fusão alfa para evitar um contorno negro em torno de imagens escalonadas.

Para Enum.ScaleType.Slice , a propriedade SliceCenter será revelada na janela Propriedades.Isto é para a interface de usuário de nove fatias: ao aumentar o tamanho, os cantos permanecerão como o tamanho da imagem de origem.Os cantos da imagem se estenderão para a largura/altura da imagem.Finalmente, o centro da imagem se estenderá para preencher a área central da imagem.

Finalmente, para Enum.ScaleType.Tile , a propriedade TileSize será revelada na janela Propriedades.Isto é para imagens com ladrilho, onde o tamanho de cada ladrilho de imagem é determinado pela propriedade TileSize.

SliceCenter

Ler Parallel

Essa propriedade define os limites de corte de uma imagem de 9 fatias quando é definido como .Observe que essa propriedade só é visível na janela Propriedades sob essa condição.

Para aprender mais sobre imagens de 9 fatias, veja Design da Interface de Usuário de 9 Fatias.

SliceScale

Ler Parallel

Escala as bordas de 9 fatias pela taxa especificada.Isso significa que as bordas ao redor da 9-slice crescerão como se você tivesse carregado uma nova versão da textura upscaled.Padrão para 1.0 .

Veja também ScaleType , SliceCenter e SliceScale .

TileSize

Ler Parallel

Essa propriedade define o tamanho do mosaico do ImageLabel com um padrão de UDim2.new(1, 0, 1, 0) . .O mosaico começa no canto superior esquerdo da imagem.Essa propriedade só está ativa se a ScaleType para o ImageLabel estiver definida como Enum.ScaleType.Tile.

Amostras de código

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

Métodos

Eventos