Uma ViewportFrame utiliza uma câmera para renderizar objetos 3D em um viewport 2D. Casos de uso ideais incluem:
- Um minimapa da sua experiência diretamente no canto da tela de um usuário.
- Modelos 3D de itens em um menu de inventário.
- Objetos em rotação que um personagem possui equipado.
Configurações de Viewport
Objetos 3D que os usuários visualizam através de um ViewportFrame podem se mover com a câmera, permanecer estáticos ou rotacionar dentro do ViewportFrame. Este objeto também pode incluir um filho Sky como um cubo para reflexões.
Se você deseja que um objeto 3D se mova com a câmera:
Posicione sua visão da câmera dentro da experiência de modo que o objeto que você deseja ver dentro do quadro esteja visível.
Adicione um novo ViewportFrame à tela e então verifique se ele está selecionado no Explorer.
Na janela Properties, atribua a propriedade CurrentCamera à câmera:
- Selecione a propriedade CurrentCamera. O seu cursor mudará.
- Na janela Explorer, clique no objeto Camera de nível superior.
Parente o objeto 3D desejado ao novo ViewportFrame. Observe que se você ainda quiser ver o objeto dentro da sua experiência, deve duplicá-lo no Workspace e depois parentar o objeto duplicado ao ViewportFrame.
Quando você mover sua câmera, o objeto também se moverá dentro do ViewportFrame.
Quando você deseja atualizar a visualização do seu ViewportFrame, certifique-se de atualizar a câmera, não os objetos dentro da visualização.
Iluminação e aparência
A iluminação dentro de um ViewportFrame é controlada através de três propriedades:
| Propriedade | Descrição |
|---|---|
| Ambient | Determina o tom geral da iluminação aplicado à área dentro do quadro de viewport. O valor padrão é Color3.fromRGB(200, 200, 200) (cinza fantasma). |
| LightDirection | Um Vector3 representando a direção da fonte de luz da posição (0, 0, 0). O valor padrão é (-1, -1, -1). |
| LightColor | Cor da luz direcional. O valor padrão é Color3.fromRGB(140, 140, 140) (prata). |
Além disso, você pode ajustar a aparência geral renderizada do viewport através das seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| ImageColor3 | Muda a cor/tinta da imagem sem modificação do objeto renderizado. O valor de coloração padrão é Color3.new(1, 1, 1) (branco) em que nenhuma modificação de cor ocorre. |
| ImageTransparency | Muda a transparência da imagem sem modificação do objeto renderizado. Um valor de 0 (padrão) é completamente opaco e um valor de 1 é completamente transparente (invisível). |