As ferramentas de pivô e propriedades relacionadas oferecem controle total sobre os pontos ao redor dos quais os objetos giram e se traduzem.
Ferramentas do Studio Interativo
As ferramentas do Studio interativo estão localizadas na barra de ferramentas da aba Modelo.
Quando o Pivô está ativado, você pode mover ou girar o ponto de pivô de uma peça ou modelo. Uma vez definido, a rotação e o escalonamento ocorrem em torno do ponto de pivô. Para mais informações, consulte definindo uma parte primária.
Os seguintes diagramas mostram exemplos de locais de pivô em relação aos limites do objeto.
Quando você gira o pivô de um modelo, a caixa delimitadora do modelo também gira.
Você pode especificar uma PrimaryPart para modelos, que é uma BasePart dentro do modelo que você pode usar como base posicional. Em termos de pontos de pivô:
- Quando você atribui uma PrimaryPart a um modelo, o pivô existente muda para o ponto de pivô da PrimaryPart. Se você depois desassociar/limpar a PrimaryPart, o ponto de pivô se redefinirá para o centro da caixa delimitadora do modelo.
- Se você deletar a PrimaryPart de um modelo, o ponto de pivô permanece na mesma localização e não reverte para sua posição anterior. Isso impede um "salto" repentino se você excluir qualquer parte do modelo.
Encaixar
A caixa de seleção Encaixar, disponível ao clicar e segurar a pequena seta no canto do botão Pivô, alterna se o ponto de pivô se encaixa em pontos de referência como cantos, arestas ou centros quando você o move com a ferramenta Editar Pivô. Quando o encaixe está habilitado, os pontos de referência aparecem como pequenos pontos magenta.
Redefinir
O botão Redefinir move o ponto de pivô para o centro de uma caixa delimitadora de objeto ou modelo. Esta operação é útil após você ter mudado a composição de um modelo e desejar colocar seu ponto de pivô no centro de sua nova caixa delimitadora.
Propriedades do Pivô
Além das ferramentas interativas, os valores de pivô podem ser definidos diretamente na janela de Propriedades.
| Propriedade | Descrição |
|---|---|
| Posição de Origem | Localização atual no mundo do objeto com base em seu ponto de pivô, em vez de sua caixa delimitadora. Útil para definir a localização precisa de um Model. |
| Orientação de Origem | Orientação atual do objeto baseada em seu ponto de pivô, em vez de sua caixa delimitadora. |
| Posição de Deslocamento do Pivô | Localização precisa do pivô em relação ao objeto.¹ |
| Orientação de Deslocamento do Pivô | Orientação precisa do pivô.¹ |
| Posição do Pivô Mundial | A localização precisa no mundo do pivô para Models sem um PrimaryPart. Se uma PrimaryPart estiver definida, o modelo usará Posição de Deslocamento do Pivô uma vez que o pivô se torna relativo a essa parte.¹ |
| Orientação do Pivô Mundial | A orientação precisa no mundo para Models sem um PrimaryPart. Se uma PrimaryPart estiver definida, o modelo usará Orientação de Deslocamento do Pivô uma vez que o pivô se torna relativo a essa parte.¹ |
Manipular pivôs em scripts
Além das ferramentas do Studio, os pontos de pivô podem ser acessados e manipulados em scripts.
| Função ou Propriedade | Descrição |
|---|---|
| GetPivot() | Consulta a localização atual no mundo do pivô de um objeto como um CFrame. Isso retorna a posição de um objeto no espaço 3D, independentemente de ser uma peça individual ou um Model. |
| PivotTo() | Mover o objeto para que seu pivô fique localizado na CFrame especificada. Isso permite um movimento uniforme do objeto tanto de partes individuais quanto de modelos. |
| BasePart.PivotOffset | O CFrame que especifica o deslocamento do pivô; efetivamente o deslocamento do pivô a partir do CFrame do BasePart.² |
| Model.WorldPivot | Para Models sem um PrimaryPart, o CFrame que especifica o pivô do modelo no espaço mundial. Se uma PrimaryPart estiver definida, o modelo usará BasePart.PivotOffset, uma vez que o pivô se torna relativo a essa parte.² |