Um ViewportFrame usa uma câmera para renderizar objetos 3D em um viewport 2D. Casos de uso ideais incluem:
- Um minimapa do seu jogo diretamente no canto da tela de um usuário.
- Modelos 3D de itens em um menu de inventário.
- Objetos rotacionando que um personagem possui equipado.
Configurações do viewport
Objetos 3D que os usuários visualizam através de um ViewportFrame podem se mover com sua câmera, permanecer estáticos ou rotacionar dentro do ViewportFrame. Este objeto também pode incluir um filho Sky como um cubemap para reflexões.
Se você quiser que um objeto 3D se mova com a câmera:
Posicione a visualização da sua câmera dentro do jogo para que o objeto que você deseja ver dentro do quadro esteja visível.
Adicione um novo ViewportFrame à tela e então certifique-se de que ele está selecionado no Explorer.
Na janela Properties, atribua a propriedade CurrentCamera à câmera:
- Selecione a propriedade CurrentCamera. Seu cursor muda.
- Na janela Explorer, clique no objeto Camera de nível superior.
Faça o parent do objeto 3D desejado ao novo ViewportFrame. Note que se você ainda quiser ver o objeto dentro do seu jogo, você deve duplicá-lo no Workspace e então fazer o parent do objeto duplicado ao ViewportFrame.
Quando você mover sua câmera, o objeto também se moverá dentro do ViewportFrame.
Quando você quiser 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 de iluminação aplicado à área dentro do quadro de visualização. O padrão é Color3.fromRGB(200, 200, 200) (cinza fantasma). |
| LightDirection | Um Vector3 representando a direção da fonte de luz a partir da posição (0, 0, 0). O padrão é (-1, -1, -1). |
| LightColor | Cor da luz direcional. O 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/tintura da imagem sem modificação do objeto renderizado. O valor de coloração padrão é Color3.new(1, 1, 1) (branco) no qual 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). |