Contêineres de UI na experiência mantêm GuiObjects que você deseja exibir dentro do mundo 3D da sua experiência.
- Um SurfaceGui permite o renderizamento de objetos de UI na superfície de uma peça no mundo 3D, enquanto também permite que a interação básica do usuário ocorrer.
- Um BillboardGui é um contêiner para objetos de UI aparecerem no espaço 3D, mas sempre enfrentam a Câmera.
Interface de usuário de surface
Semelhante a e , objetos de UI como e estão ligados à mesma direção da superfície em que estão, editáveis através da propriedade .
Para aplicar um SurfaceGui a uma experiência em andamento BasePart, simplesmente associá-lo a essa parte e definir a propriedade SurfaceGui.Face.Objetos de UI filhos então aparecem naquela face da parte pai.
Alternativamente, você pode colocar o SurfaceGui dentro de um contêiner como StarterGui e então definir sua propriedade Adornee para qualquer BasePart , bem como o alvo Face.Configurando Adornee substituições diretas de associação parente, permitindo mais flexibilidade no posicionamento, pois pode ser definido a partir de um script durante o tempo de execução.
Os elementos de interface interativa como ImageButtons e TextButtons dentro de um SurfaceGui só receberão a entrada do usuário se forem parentados ao jogador's PlayerGui , geralmente através da colocação do SurfaceGui dentro de StarterGui como observado acima.
Para ajudar a escolher o rosto correto para um SurfaceGui , clique com o botão direito na peça alvo e selecione Mostrar Indicador de Orientação .Isso exibe um círculo azul com um F e uma linha anexada ao rosto do ObjetoFront e uma seta verde que aponta na direção do rosto do ObjetoTop.
Tamanho e posição
O "canvas" de um SurfaceGui ocupa todo o Face da parte pai ou Adornee da parte.Como melhor prática, é recomendado que você use escala valores para o tamanho e posição de objetos de UI filhos como ImageLabels.Você também pode aplicar um UIAspectRatioConstraint aos filhos do SurfaceGui para manter sua proporção de aspecto desejada, independentemente do tamanho do rosto.
Modo de occlusão
A propriedade AlwaysOnTop determina se o SurfaceGui renderizará sobre o conteúdo 3D ou será ocultado por ele.Quando definido para false (padrão), o SurfaceGui renderiza como outro conteúdo 3D e é ocultado por outros objetos 3D.Quando definido para true , ele sempre é renderizado sobre o conteúdo 3D e não é influenciado por brilho/iluminação no ambiente 3D.
Influência de brilho e luz
Brightness e LightInfluence trabalham em conjunto para determinar como a luz ambiental afeta o conteúdo da interface do usuário do SurfaceGui.
Brightness determina o fator pelo qual a luz emitida é escalada em um alcance de 0 a 1000, permitindo que você corresponda ao SurfaceGui ao seu ambiente.Por instância, um letreiro de vídeo pode ser iluminado dentro de uma sala escura aumentando Brightness para 10.
LightInfluence controla quanto o SurfaceGui é influenciado pela iluminação no local, em um alcance de 0 a 1 .Definir isso para 1 significa que a iluminação envolvente tem controle completo sobre a aparência, enquanto definir para 0 significa que a iluminação não tem efeito.
Observe que Brightness é inacessível no Studio e não tem efeito quando LightInfluence é 1 ou AlwaysOnTop é true.
Visibilidade de distância
MaxDistance controla até onde da câmera o SurfaceGui será exibido antes de parar de renderizar.Um valor de 0 significa que não há limite e ele renderizará infinitamente longe.O valor padrão de 1000 funciona bem para a maioria dos casos.
Para SurfaceGuis que aparecem ao ar livre, é recomendado que MaxDistance seja suficientemente alto para garantir que a interface do usuário do contêiner seja suficientemente pequena na tela quando aparece ou desaparece, minimizando o efeito pop-in/out repentino.
Ordem de exibição
Se vários SurfaceGui existirem no mesmo rosto, você pode empilá-los por Z‑index através de sua propriedade ZOffset (alterar isso não "levanta" ou "afunda" visualmente o contêiner da superfície).
Interface de anúncio de bilboard
O contêiner BillboardGui exibe objetos de interface de usuário no espaço 3D, mas, ao contrário de SurfaceGui, os filhos de um BillboardGui sempre enfrentam a Câmera.Este contêiner é útil para exibir informações voltadas para a frente acima em objetos na experiência, como medidores de saúde ou nomes acima de personagens de jogadores, marcadores que guiam os jogadores para um objeto no mundo 3D e muito mais.
Para vincular um BillboardGui a um na experiência BasePart ou Attachment , simplesmente associá-lo a essa parte ou anexo e, se desejado, ajustar seu tamanho/posição .
Alternativamente, você pode colocar o BillboardGui dentro de um contêiner como StarterGui e então definir sua propriedade Adornee para qualquer BasePart ou Attachment.Este método oferece mais flexibilidade no posicionamento desde que Adornee possa ser definido a partir de um script durante o tempo de execução, por exemplo, para colocar um BillboardGui sobre a cabeça de personagens do jogador durante o tempo de execução.
Os elementos de interface interativa como ImageButtons e TextButtons dentro de um BillboardGui só receberão a entrada do usuário se forem parentados ao jogador's PlayerGui , geralmente através da colocação do BillboardGui dentro de StarterGui como observado acima.
Tamanho e posição
Para o tamanho do bilhete, os componentes de escala da propriedade Size definem o tamanho do estudo do bilhete no espaço de 3D.Por exemplo, uma configuração de {10, 0},{2, 0}( UDim2.fromScale(10, 2) ) forma um cartaz com uma proporção de 10:2 que escala maior ou menor dependendo de sua distância da Câmera.
Para posicionamento, a propriedade StudsOffset move o canvas de bilboard no eixo X (esquerda/direita), no eixo Y (para cima/para baixo) e no eixo Z (para frente/para trás) em relação à Câmera.
Ao criar um tamanho escalonado BillboardGui que contém um TextLabel , é útil habilitar a propriedade de rótulo TextScaled para que seu texto aumente ao longo da janela de exibição à medida que a distância da câmera muda.
Modo de occlusão
A propriedade AlwaysOnTop determina se o BillboardGui renderizará sobre o conteúdo 3D ou será ocultado por ele.Quando definido para false (padrão), o BillboardGui renderiza como outro conteúdo 3D e é ocultado por outros objetos 3D.Quando definido para true , ele sempre é renderizado sobre o conteúdo 3D e não é influenciado por brilho/iluminação no ambiente 3D.
Influência de brilho e luz
Brightness e LightInfluence trabalham em conjunto para determinar como a luz ambiental afeta o conteúdo da interface do usuário do BillboardGui.
Brightness determina o fator pelo qual a luz emitida é escalada em um alcance de 0 a 1000, permitindo que você corresponda ao BillboardGui ao seu ambiente.Por instância, um letreiro de vídeo pode ser iluminado dentro de uma sala escura aumentando Brightness para 10.
LightInfluence controla quanto o BillboardGui é influenciado pela iluminação no local, em um alcance de 0 a 1 .Definir isso para 1 significa que a iluminação envolvente tem controle completo sobre a aparência, enquanto definir para 0 significa que a iluminação não tem efeito.
Observe que Brightness é inacessível no Studio e não tem efeito quando LightInfluence é 1 ou AlwaysOnTop é true.
Visibilidade de distância
MaxDistance controla até onde da câmera o BillboardGui será exibido antes de parar de renderizar.Um valor de 0 ou inf (padrão) significa que não há limite e ele renderizará infinitamente longe.