Manual do Spectra 3D

Bem-vindo à documentação oficial. Aprenda a modelar e a gerir as suas cenas 3D.
Copyright © 2026 QOrigin Hub Tecnológica

1. Introdução

O Spectra 3D é um motor de visualização e modelação 3D focado em desempenho e simplicidade. Construído com Python e OpenGL Moderno, oferece as ferramentas essenciais para manipulação de malhas e gestão de geometria.

2. Navegação no Espaço 3D (Viewport)

A navegação foi desenhada para ser fluida e imitar os padrões da indústria 3D:

Botão Direito do Rato (Manter premido): Orbita e roda a câmara à volta do centro.
Shift + Botão Direito: Move a câmara lateralmente (Pan).
Roda do Rato (Scroll): Aproxima ou afasta a vista (Zoom In / Zoom Out).
F: Foca a câmara no objeto atualmente selecionado.

3. Atalhos Globais de Teclado (Hotkeys)

Acelere o seu fluxo de trabalho utilizando o teclado para as ações de transformação mais comuns:

Teclas	Ação	Descrição
`G`	Mover (Grab)	Ativa o Gizmo de translação nos eixos X, Y e Z.
`R`	Rodar	Ativa os anéis de rotação.
`S`	Escalar	Ativa o Gizmo de redimensionamento.
`X` ou `Delete`	Apagar	Apaga o objeto selecionado e os seus dependentes (children).
`Shift` + `D`	Duplicar	Cria uma cópia exata do objeto selecionado.
`Z`	Wireframe	Alterna entre o modo Sólido e Raio-X (Linhas).

4. Gestão de Projetos e Ficheiros

O motor possui o seu próprio sistema nativo de gravação (.spectra) que armazena as malhas e a hierarquia da cena.

Ctrl + N (Novo Projeto): Esvazia a tela, limpa a RAM e prepara um ambiente em branco.
Ctrl + S (Guardar Projeto): Guarda o estado atual.
Apagar Projeto: Permite apagar ficheiros fisicamente do disco rígido diretamente através da interface, usando o ícone do caixote do lixo.

5. Primitivas Geométricas (Menu Add)

Pode adicionar formas matemáticas puras à cena através do ícone de Cubo na barra lateral esquerda:

Cubo: Estrutura base com 6 faces.
Esfera: Geometria baseada em anéis e setores com mapeamento UV.
Plano: Piso simples.
Cilindro: Tubo perfeitamente modelado com topos.
Pirâmide: Base quadrada com faces conectadas no topo.
Cone: Base circular conectada a um único vértice superior.

6. Modificadores de Malha

Localizados no menu da "Chave Inglesa", os modificadores alteram a geometria do objeto selecionado em tempo real:

Subdividir: Aumenta a densidade poligonal da malha (Suavização).
Ruído (Noise): Aplica deslocamento aleatório aos vértices.
Extrusão Global: Expande a geometria empurrando as faces ao longo das suas normais.
Corte a Laser (Laser Cut - Eixo Y): Fatiamento matemático que remove a geometria acima da linha central.
Arredondar Cantos (Bevel): Aplica um algoritmo de suavização puxando os vértices de bordas afiadas.

7. Hierarquia e Organização (Outliner)

O painel do lado direito é o coração da organização da sua cena.

Dica de Produtividade: Para renomear um objeto (ex: mudar "Cube 1" para "Roda do Carro"), basta dar um Duplo Clique lento no nome dele na lista da Hierarquia, ou selecioná-lo e premir F2. O novo nome será gravado no seu ficheiro de projeto!