Scene viewport
O viewport é um render GPU do motor, lido de volta para o editor Rust e composto por baixo do gizmo, marcadores e HUD. Nunca bloqueia a thread da UI.
Pipeline de frame#
- O painel reporta o tamanho lógico. O editor guarda o tamanho de render desejado em pixels físicos e pede um frame no máximo a cada 16 ms.
caffeine_session_render_begin(width, height)inicia um render offscreen do motor.- O
ViewportTickde 16 ms faz polling decaffeine_session_render_pollpara um buffer RGBA reutilizado. Os estados sãoPending,Ready,IdleeFailed. - Em
Ready, os pixels são enviados para uma textura Iced/wgpu através deuikit/components/viewport_shader.rs. Um hash de conteúdo salta frames idênticos, por isso uma cena estática não reenvia a textura a cada tick. - O editor desenha toolbar, HUD, gizmo e marcadores por cima do frame. Esses overlays projetam com a mesma câmara que produziu a imagem.
Aviso. SDL_GPU não expõe um handle nativo de textura através da API pública. Uma textura wgpu partilhada não é possível sem alterar o renderer (backend wgpu, patch do SDL ou uma janela separada). O caminho de readback é o suportado; não o descreva como zero-copy.
Definições de qualidade#
| Definição | Valores | Notas |
|---|---|---|
| Anti-aliasing | Off, FXAA, TAA | FXAA é o padrão; TAA acumula entre frames e precisa de câmara estável. |
| Render scale | 0.5 … 2.0 | Supersampling interno; padrão 1.5. A UI fica na resolução lógica. |
| Grelha | on / off | G ou View → Show/Hide Grid. |
| Marcadores | on / off | View → Show/Hide Scene Markers. |
| Gizmo | Move / Rotate / Scale | 1, 2, 3 ou View → Move/Rotate/Scale Tool. |
O HUD mostra resolução, grelha, modo do gizmo, modelo de vista, FPS e latência do
render. Ctrl+R força um frame; Ctrl+0 repõe a câmara.
Câmara#
| Entrada | Ação |
|---|---|
| Arrastar | Orbitar em torno do ponto de foco |
| Arrastar com o botão direito ou do meio | Fazer pan do foco |
| Roda | Zoom (exponencial) |
W A S D |
Voar na horizontal |
Q / E |
Descer / subir |
Shift |
Boost de voo |
F ou duplo clique |
Focar a seleção |
Ctrl+0 |
Repor a câmara |
O estado da câmara vive em windows/main.rs; viewport_surface apenas converte
eventos de ponteiro e roda em mensagens de câmara. Essa separação mantém a matemática
fora do widget e torna-a testável.
Seleção e picking#
Um clique usa um raio do cursor através da câmara. Se o raio atingir um handle do gizmo, o gizmo consome-o; caso contrário, um marcador de cena; caso contrário, o motor faz picking da mesh. O resultado atualiza a seleção e o Inspector. O picking usa a transform mundial resolvida pela cadeia de pais, por isso filhos de grupos movidos são selecionados corretamente.
Estado vazio e fixtures#
Quando não há sessão de motor, o viewport mostra Waiting for the engine
viewport…. Isto é esperado nas fixtures headless entities e empty. A fixture
scene3d inicia uma sessão real com luzes, câmara e meshes, e é a usada pelos flows
de captura do gizmo e marcadores.
Páginas relacionadas#
- Toolbar do viewport — toolbar de ícones e projeções.
- Gizmos e marcadores
- Guia de materiais
- Performance