Destacando objetos

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

A instância Highlight é um efeito visual que você pode usar para chamar atenção para um objeto específico dentro de um jogo. Cada efeito de destaque tem um contorno de silhueta que envolve o objeto e um interior sólido que é exibido sobre o objeto. Você pode personalizar ambos os componentes de forma independente para modificar a aparência visual do destaque.

Uma malha de árvore contra um fundo cinza.
Objeto base
A mesma malha de árvore com um contorno amarelo e um interior de destaque preto.
Contorno amarelo e interior preto
A mesma malha de árvore com um contorno preto e um interior de destaque amarelo.
Contorno preto e interior amarelo

Aplicações úteis do efeito de destaque incluem:

  • Fornecer feedback visual de que um objeto é importante e/ou interativo.
  • Tornar objetos distantes visíveis através de objetos que estão mais próximos do usuário.
  • Indicar a posição atual e o status de outros personagens.

Adicionar destaques

Como limite de desempenho, o Estúdio só exibe 255 instâncias simultâneas de Highlight no lado do cliente a qualquer momento. Se você adicionar mais do que esse limite, as instâncias adicionais de Highlight são ignoradas silenciosamente.

Note também que os destaques em dispositivos de baixo desempenho podem ser mais pixelizados, mas de outra forma terão a mesma aparência que em outros dispositivos com qualquer combinação de configurações.

Parentear a objetos

Para adicionar um efeito de destaque a um objeto, você pode parentear uma nova Highlight diretamente ao objeto.

  1. Na janela Explorer, passe o mouse sobre um Model ou um BasePart, e clique no botão ⊕. Um menu contextual será exibido.

  2. No menu, insira um Destaque. O destaque é exibido no objeto com seus valores de propriedade padrão que criam um contorno branco e um sobreposição de tom vermelho.

Definir o adornee

Alternativamente, você pode colocar a instância Highlight fora de uma relação pai/filho, seja dentro da workspace, StarterPlayer, StarterGui, StarterPack, ou ReplicatedStorage, e depois definir a propriedade Adornee para o Model ou BasePart que você deseja destacar.

Personalizar destaques

Você pode alterar as propriedades de uma instância Highlight para criar efeitos visuais interessantes que destacam adequadamente objetos em sintonia com o seu jogo.

OutlineColor

A propriedade OutlineColor define o valor Color3 do contorno do destaque.

Uma malha de árvore com contorno vermelho.
OutlineColor = [255, 100, 50]
Uma malha de árvore com contorno verde.
OutlineColor = [0, 255, 125]
Uma malha de árvore com contorno azul.
OutlineColor = [75, 150, 255]

OutlineTransparency

A propriedade OutlineTransparency define a visibilidade do contorno do destaque para qualquer valor entre o valor padrão de 0 (opaco) e 1 (invisível).

Uma malha de árvore com contorno preto opaco.
OutlineTransparency = 0
Uma malha de árvore com contorno transparente.
OutlineTransparency = 1

FillColor

A propriedade FillColor define o valor Color3 do interior do destaque.

Uma malha de árvore com um preenchimento vermelho.
FillColor = [255, 100, 50]
Uma malha de árvore com um preenchimento verde.
FillColor = [0, 255, 125]
Uma malha de árvore com um preenchimento azul.
FillColor = [75, 150, 255]

FillTransparency

A propriedade FillTransparency define a visibilidade do interior do destaque para qualquer valor entre o valor padrão de 0 (opaco) e 1 (invisível). Você pode usar essa propriedade para determinar quanto da cor existente do objeto você deseja que os espectadores vejam.

Uma malha de árvore com um preenchimento preto opaco.
FillTransparency = 0
Uma malha de árvore com um preenchimento preto semi-transparente.
FillTransparency = 0.5
Uma malha de árvore com um preenchimento preto transparente.
FillTransparency = 1

DepthMode

A propriedade DepthMode controla como o efeito é exibido em relação a outros objetos no mundo.

  • AlwaysOnTop — Permite que o destaque seja exibido independentemente de haver objetos entre a câmera e o objeto destacado. Isso significa que o espectador sempre consegue ver o destaque, independentemente do que há entre o objeto destacado e a câmera.

  • Occluded — Esconde o destaque se houver objetos entre a câmera e o objeto destacado. Isso significa que o espectador só consegue ver o objeto se não houver objetos obstrutivos entre o objeto destacado e a visão da câmera.

Dois objetos estão atrás de pilares, mas como sua propriedade AlwayOnTop está definida como verdadeira, você ainda consegue ver os objetos e seu destaque.

Enabled

A propriedade Enabled permite que você ative ou desative rapidamente o destaque sem impactar no desempenho.

Dicas de desempenho

Embora você tenha muitas opções para personalizar instâncias de Highlight, as seguintes dicas são recomendadas para aumentar o desempenho do seu jogo em todos os dispositivos:

  • Adicionar ou remover um Highlight pode causar uma etapa de reconstrução de geometria que pode levar a picos de desempenho e chamadas de desenho extras. Se você deseja mudar a aparência de uma instância de Highlight ou escondê-la/exibi-la temporariamente em um objeto, é melhor personalizar as propriedades da instância Highlight diretamente, uma vez que mudar qualquer propriedade da instância Highlight é leve e não impacta o desempenho.

  • O Roblox desenha objetos em uma ordem de trás para frente, o que pode causar problemas se você embutir objetos com um Highlight filho dentro de outros objetos que também têm instâncias Highlight filhas. Por causa disso, é melhor manter objetos com instâncias de Highlight fora de uma relação pai/filho com outros objetos que têm instâncias de Highlight.

  • O primeiro Highlight renderizado na tela incorre na maior parte do custo de desempenho (até 1 milissegundo de tempo de GPU em dispositivos móveis). Para destaques adicionais além do primeiro, você não deve ver um impacto significativo no desempenho em qualquer plataforma.

  • Em dispositivos móveis, os destaques são mais custosos em termos de desempenho quando cobrem mais da tela. Em outras plataformas, os destaques têm o mesmo custo de desempenho, independentemente da sua cobertura na tela.

  • Em todas as plataformas, destaques que não estão visíveis na tela (seja desativados ou totalmente transparentes) não incorrem em custo de desempenho.

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.