vizzio2

🚀 Guia Rápido - Vizzio 3D/VR Viewer

Desenvolvido por: Nícolas Ávila
Versão: 3.0
Última Atualização: 2025-12-21

⚡ Início Rápido (2 minutos)

1. Carregar um Modelo

Arraste um arquivo .IFC para a janela
OU
Pressione Ctrl+O para abrir

2. Navegar pelo Modelo

Botão Direito + Arrastar  → Rotacionar
Botão Meio + Arrastar     → Mover lateralmente
Scroll                     → Zoom
WASD                       → Mover câmera

3. Visualizações Rápidas

Numpad 7  → Vista de Cima (Planta)
Numpad 1  → Vista Frontal
Numpad 3  → Vista Lateral
Numpad 0  → Vista Isométrica

4. Ferramentas Essenciais

F         → Focar no modelo
G         → Mostrar/Ocultar Grid
T         → Tutorial interativo
F1        → Ajuda completa

🎯 Tarefas Comuns

Selecionar e Inspecionar Elementos

  1. Passe o mouse sobre um elemento → Aparece indicador cyan
  2. Clique no elemento → Anel dourado aparece
  3. Veja propriedades no painel direito
  4. Delete para deselecionar

Medir Distâncias

  1. Pressione M para ativar medição
  2. Clique em dois pontos no modelo
  3. Veja resultado no painel direito
  4. Pressione M novamente para desativar

Mudar Vista Rapidamente

Numpad 1  → Frente
Numpad 3  → Direita
Numpad 7  → Cima
Numpad 0  → Isométrica

O         → Alternar Orbital/FPS
G         → Grid de referência
H         → Eixos XYZ coloridos
N         → Mini-mapa
B         → Bússola

🎮 Controles Completos

🖱️ Mouse

| Ação | Controle | |——|———-| | Rotacionar | Botão Direito + Arrastar | | Pan | Botão Meio + Arrastar | | Zoom | Scroll | | Selecionar | Click Esquerdo |

⌨️ Teclado

| Tecla | Ação | |——-|——| | Navegação || | WASD | Mover câmera | | Space | Subir | | Shift | Descer | | +/- | Velocidade | | Visualização || | G | Toggle Grid | | H | Toggle Eixos | | N | Toggle Minimap | | B | Toggle Bússola | | L | Toggle Luz | | O | Orbital/FPS | | Presets || | Numpad 1 | Frente | | Numpad 3 | Direita | | Numpad 7 | Cima | | Numpad 0 | Isométrica | | F | Focar | | R | Reset | | Ferramentas || | M | Medir | | T | Tutorial | | F1 | Ajuda | | F11 | Fullscreen | | F12 | Screenshot | | Arquivos || | Ctrl+O | Abrir | | ESC | Sair |

💡 Dicas Profissionais

Para Análise de Projetos

  1. Use Numpad 7 para vista de planta
  2. Ative o Grid (G) para escala visual
  3. Use medições (M) para verificar dimensões
  4. Use F para focar rapidamente

Para Apresentações

  1. Prepare vistas com presets de câmera
  2. Oculte o grid (G) para visual limpo
  3. Ative lighting (L) para realismo
  4. Use F11 para fullscreen

Para Modelos Grandes

  1. Use lista de elementos para filtrar
  2. Oculte tipos desnecessários
  3. Ajuste velocidade (+/-) de navegação
  4. Use F para localizar elementos

Para Colaboração

  1. Tire screenshots (F12) de vistas importantes
  2. Use medições para discussões
  3. Anote coordenadas de pontos importantes
  4. Compartilhe arquivo com anotações

🎓 Tutorial Interativo

Iniciar Tutorial

Pressione T para iniciar o tutorial de 12 passos

O que você vai aprender:

  1. ✅ Carregar modelos IFC
  2. ✅ Rotacionar câmera (Orbital)
  3. ✅ Pan (movimento lateral)
  4. ✅ Zoom
  5. ✅ Selecionar elementos
  6. ✅ Presets de câmera
  7. ✅ Grid e orientação
  8. ✅ Lista de elementos
  9. ✅ Medições
  10. ✅ Modo VR (opcional)

Tempo estimado: 10 minutos

🥽 Modo VR (Avançado)

Requisitos

Ativar VR

F2  → Ativa modo VR
F3  → Ativa modo AR

Controles VR

❓ Problemas Comuns

Modelo não carrega

✅ Verifique se é arquivo .IFC válido ✅ Tente arrastar para a janela ✅ Use Ctrl+O para abrir diálogo

✅ Pressione - para diminuir velocidade ✅ Use modo Orbital (O) para controle fino

Não consigo selecionar

✅ Clique com botão esquerdo ✅ Certifique-se que não está em modo medição ✅ Verifique se elemento está visível

FPS baixo em modelo grande

✅ Oculte tipos desnecessários ✅ Use lista de elementos para filtrar ✅ Feche outros programas pesados

Grid/Eixos não aparecem

✅ Pressione G para grid ✅ Pressione H para eixos ✅ Verifique se está focado no modelo (F)

📊 Indicadores Visuais

Cores dos Indicadores

| Cor | Significado | |—–|————-| | 🔵 Cyan | Hover (elemento sob mouse) | | 🟡 Dourado | Selecionado | | 🔴 Vermelho | Eixo X / Teleporte inválido | | 🟢 Verde | Eixo Y / Teleporte válido | | 🔵 Azul | Eixo Z |

Animações

🎯 Atalhos para Produtividade

Fluxo de Análise Rápida

1. Ctrl+O        → Abrir modelo
2. F             → Focar
3. Numpad 7      → Vista de cima
4. G             → Ativar grid
5. M             → Medir pontos importantes
6. Numpad 0      → Vista isométrica
7. F12           → Screenshot

Fluxo de Apresentação

1. F11           → Fullscreen
2. G             → Desativar grid
3. L             → Ajustar luz
4. Numpad 1/3/7  → Alternar vistas
5. F             → Focar em elementos

📞 Suporte

Ajuda In-App

F1  → Lista completa de controles
T   → Tutorial interativo

Documentação Completa

/docs/3D_VR_IMPROVEMENTS.md       → Fase 1
/docs/COMPLETE_3D_VR_SYSTEM.md    → Sistema completo
/docs/TEST_CHECKLIST.md           → Checklist de testes
/docs/QUICK_START.md              → Este guia

Contato

🎉 Pronto para Começar!

  1. Execute run.bat ou dotnet run
  2. Arraste um arquivo .IFC
  3. Pressione T para tutorial
  4. Pressione F1 se precisar de ajuda

Aproveite o Vizzio! 🚀

Desenvolvido por: Nícolas Ávila
Versão: 3.0 - Complete 3D/VR System
Data: 2025-12-21
Status: ✅ Production Ready