> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Vistas do editor

> Mova-se nas vistas Mapa e Planta, ajuste o grid, a caixa de renderização e os rótulos, use a barra de transformação e a árvore da estrutura, e conheça os atalhos.

Uma estrutura aberta tem duas vistas do mesmo documento. O **Mapa** edita dentro do mundo, com o prédio e a rua ao redor. A **Planta** é um corte horizontal visto de cima. Seleção, ferramentas e desfazer são compartilhados; alterne com **Planta** e **Mapa** na barra da estrutura.

![Editor de Estruturas na vista Planta com uma sala selecionada, suas alças, a ficha Sala e uma lista de problemas que bloqueiam](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-editor-plan.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=4a195201d5384821db331a68637654df)

Vista Planta: uma sala selecionada e a faixa Exportação bloqueada sobre a vista.

## O layout

De cima para baixo: a barra da estrutura, a barra de transformação e a vista, com o dock à esquerda e a coluna de detalhes à direita.

| Parte | O que contém |
| - | - |
| Barra da estrutura | **Voltar à lista de estruturas**, os nomes da estrutura e da parte, o controle de nível (**Sala**, **Face**, **Aresta**, **Vértice**), as opções da ferramenta ativa, **Planta** / **Mapa**, o selo **Hot reload** e o selo do projeto. |
| Barra de transformação | Mover, girar, escalar, pivô, trava de eixo, encaixe, **Enquadrar** e modo de câmera. Veja [Barra de transformação](#barra-de-transformação). |
| Dock de ferramentas | Borda esquerda da vista. Três níveis: estrutura, **Interior** e props. **Voltar à estrutura** no topo dos dois últimos leva ao primeiro. |
| Dock geral | Centro inferior: **Selecionar** (**V**), **Seleção por Caixa** (**B**), **Selecionar objetos do mapa** (**Shift+M**) e **Vista** (**N**). |
| Coluna de detalhes | Árvore **Estrutura**, **Propriedades**, **Marcações**, **Verificador**. |

Os níveis **Face**, **Aresta** e **Vértice** mudam para **Editar geometria**: veja [Geometria](/pt-BR/projects/structures/geometry.md). O **Hot reload** está em [Hot reload](/pt-BR/projects/hot-reload.md). Uma engrenagem no canto superior esquerdo da vista abre **Renderização das estruturas**, as mesmas configurações da aba Mapa: veja [Qualidade de renderização](/pt-BR/map/rendering-quality.md).

Não há botões de Desfazer ou Refazer enquanto uma estrutura está aberta. Pressione **Ctrl+Z** e **Ctrl+Shift+Z** (ou **Ctrl+Y**). Ocultar e travar na árvore não podem ser desfeitos.

O nome da estrutura na barra fica travado enquanto ela tem alterações não salvas: pressione **Ctrl+S** e depois renomeie.

## Câmera e navegação

Na vista Mapa, o modo de câmera padrão é **Órbita**.

| Entrada | Efeito |
| - | - |
| Arrastar com o botão direito | Orbita em torno do ponto sob a vista. |
| Arrastar com o botão do meio | Desloca. |
| **Shift** ou **Ctrl** com arraste do meio | Orbita. |
| **Shift** ou **Ctrl** com arraste do botão direito | Desloca. |
| **Alt** com arraste do botão esquerdo | Orbita com qualquer ferramenta. **Shift** ou **Ctrl** desloca. |
| Roda | Zoom. |
| **C** | Alterna **Órbita** e **Livre**. |
| **F**, **Home**, **Numpad .** | Enquadra a seleção, ou o modelo inteiro sem seleção. |
| **Numpad 1** / **3** / **7** | Vista frontal, direita e de cima. **Ctrl** dá o lado oposto. |

O cubo de orientação no canto superior direito faz o mesmo: clique em uma face ou eixo para olhar daquele lado e clique de novo para o lado oposto.

Modo **Livre**: o botão direito olha ao redor, **W A S D** movem, **Space** ou **E** sobem, **Q** desce, **Shift** acelera e a roda muda a velocidade.

### Vista Planta

Um rótulo no canto superior esquerdo mostra `Map plan · Z cut …` com a altura do corte. Arrastar com o botão direito gira a planta, e **Shift** trava em passos de 15°. Arrastar com o botão do meio ou **Alt** com o esquerdo desloca, e a roda dá zoom em direção ao ponteiro. **Enquadrar** (**F**) restaura o enquadramento com o norte para cima. A seção **Câmera** do painel Vista fica desativada na Planta.

Entrar na Planta enquadra a caixa de renderização, ou a estrutura se não houver caixa, e liga o corte de seção. O corte não é salvo.

## O painel Vista

Clique em **Vista** (**N**) para abrir uma coluna ao lado da coluna de detalhes. Ela fica aberta enquanto você voa.

![Painel Vista rolado até Câmera, Grid de orientação com centro, altura, tamanho, espaçamento e rotação, e Recorte](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/structures/structures-view-panel.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=bbd02cb1d0701cadf49d4057816d8e54)

Câmera, Grid de orientação e o começo de Recorte.

| Seção | O que muda |
| - | - |
| **Renderização** | **Mostrar** escolhe o que a prévia desenha: **Tudo**, **Ocultar o mapa**, **Apenas salas** ou **Apenas geometria editável**. **Salas** e **Geometria** escolhem o estilo de desenho: **Limpo**, **Contorno**, **Arestas** ou **Wireframe**. **Texturizado** desligado desenha todas as superfícies lisas. Isso muda só a prévia, não a exportação. |
| **Seleção** | O que **Selecionar objetos do mapa** pode atingir: **Objetos**, **Estruturas**, **Vegetação**, **Terreno**, **Água** e o **Estilo de marcação**. Com tudo desligado, clicar não seleciona nada. Salvo nesta máquina, não na estrutura. |
| **Visualização técnica** | A mesma seção da aba Mapa. Veja [Visualizações técnicas](/pt-BR/map/technical-views.md). |
| **Câmera** | **Posição (m)**, **Direção (°)** e **Inclinação (°)** da câmera ao vivo. Digitar a move. Desativada na Planta. |
| **Grid de orientação** | O grid ao qual salas e geometria se encaixam. Veja [Grid](#grid). |
| **Recorte** | A caixa de renderização e o corte de seção. Veja [Caixa de renderização e corte](#caixa-de-renderização-e-corte). |
| **Rótulos** | Texto sobre a cena. Veja [Rótulos](#rótulos). |

### Grid

**Desenhar no grid** mostra o grid. O grid define o piso das salas novas, mesmo dentro de um modelo existente.

| Opção | O que faz | Padrão |
| - | - | - |
| **Centro (m)** | Onde fica o cruzamento do grid. | A caixa, ou a origem |
| **Altura Z (m)** | Altura do grid, como altura absoluta no mundo. O conta-gotas pega a altura de um vértice, aresta ou marca em que você clicar. | Origem da estrutura mais o primeiro piso |
| **Tamanho (m)** | **Largura** e **Comprimento**, de 1 a 10000. | 100 |
| **Espaçamento (m)** | Tamanho da célula, de 0,05 a 100. Quando as linhas ficariam densas demais, o painel diz qual passo está visível. | 1 |
| **Rotação (°)** | Ângulo do grid. Com uma caixa de renderização vira **Ajuste de rotação (°)**, e 0° alinha o grid à caixa. | 0 |

Se o grid acabar fora do espaço visível, um aviso pede para ajustar a altura do grid ou o corte.

### Caixa de renderização e corte

A caixa de renderização limita o que o Mapa desenha à área em volta do seu trabalho, para você ver a estrutura em vez da cidade inteira. O corte esconde tudo acima de uma altura.

![Seção Recorte com Limitar renderização e Mostrar contorno da caixa ligados, margens, valores mínimo e máximo, Selecionar caixa, Enquadrar, Remover caixa e Cortar acima da seção](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/structures/structures-view-clipping.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=11a131d070a4d73184b3712a9a6d2708)

Recorte com a caixa de renderização ligada: margens, mínimo e máximo, e Cortar acima da seção.

| Opção | O que faz |
| - | - |
| **Limitar renderização**, **Mostrar contorno da caixa** | Ligam e desligam a caixa, e mostram ou escondem o contorno e as alças. Visíveis quando existe uma caixa. |
| **Usar geometria da parte**, **Usar modelo selecionado**, **Definir manualmente** | Criam a caixa em volta da geometria editável da parte, em volta do modelo do mapa selecionado, ou a 10 m em volta da parte. **Definir manualmente** só aparece enquanto não há caixa. |
| **Margens do modelo (m)** | Folga somada à caixa em cada eixo. Padrão 2, 2, 2. |
| **Mínimo (m)**, **Máximo (m)** | A caixa digitada. Viram **Centro (m)** e **Dimensões (m)** quando a caixa está girada. |
| **Selecionar caixa**, **Enquadrar**, **Remover caixa** | Selecionam a caixa para arrastar as alças, voam até ela, ou a apagam e desligam o corte. |
| **Cortar acima da seção** | Remove tudo acima da **Altura Z (m)**, incluindo modelos do jogo e a geometria da estrutura. Padrão desligado, 1,2 m acima do grid. |

A caixa, o grid, o corte e os rótulos são auxílios de edição. São salvos com a estrutura e nunca exportados.

### Rótulos

![Seção Rótulos com Mostrar rótulos ligado e chaves para Interiores, Salas, Portais, Props, Objetos, Vãos, Guias e Medidas](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/structures/structures-view-labels.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=21ff224e5e79d44a3558546e3bb93c0b)

Rótulos com uma chave para cada tipo de texto na cena.

**Mostrar rótulos** é a chave geral: desligada, esconde todos os rótulos sem perder os outros ajustes. Os tipos são **Interiores**, **Salas**, **Portais**, **Adereços**, **Objetos**, **Vãos**, **Guias** e **Medidas**. **Salas**, **Portais**, **Adereços** e **Objetos** começam desligados. Salvos com a estrutura.

## Selecionar coisas

**Shift** soma à seleção e **Ctrl** alterna. **Shift** ou **Ctrl** com um arraste no espaço vazio desenha um retângulo sobre os centros dos itens. **Seleção por Caixa** (**B**) faz o mesmo com uma ferramenta de retângulo.

O marcador do interior é um quadrado com o nome da estrutura, mostrado enquanto nada está selecionado e só depois que a parte tem salas, geometria ou props. Selecione-o e o gizmo age sobre a parte inteira: **Mover interior** (**G**) e **Girar interior** (**R**) mudam a posição e a direção, e **Enquadrar interior** (**F**) voa até ele.

**Selecionar objetos do mapa** (**Shift+M**, vista Mapa) seleciona prédios e props do mapa do mundo. O nó **Objeto** que aparece tem um menu **Ações**. **Focar renderização** põe a caixa de renderização em volta do objeto, move o grid para a altura da base dele e define o corte 1,2 m acima desse piso. Enquanto a parte está vazia, também move a origem da parte para o centro da base do objeto. **Editar geometria**, **Nova parte com este modelo** e **Remover do mapa** estão em [Geometria](/pt-BR/projects/structures/geometry.md).

### Encaixe

Ao desenhar ou mover, o cursor se encaixa no que está sob ele e mostra um quadrado e um rótulo: **Vértices**, **Meios de arestas**, **Interseções**, **Centros de faces**, **Arestas**, **Pontos de referência**, **Réguas** ou **Medidas**. Segure **Ctrl** ao desenhar, ou **Alt** nas alças, para posicionar livremente.

## Barra de transformação

| Controle | O que faz | Padrão |
| - | - | - |
| **Mover** (**G**), **Girar** (**R**), **Escala** (**S**) | Modo do gizmo. | **Mover** |
| **Origem** (**O**) | Escolhe o ponto do prop selecionado em torno do qual o gizmo age. | Desligado |
| **Pivô**: **Mediana**, **Ativo**, **Individual** | Age em torno do centro da seleção, da última peça marcada, ou de cada peça por conta própria. | **Mediana** |
| **Travar eixo**: **X**, **Y**, **Z** | Trava o gizmo em um eixo. Clique de novo para soltar. | Nenhum |
| **Mundo** / **Local** | Eixos do mundo ou da peça. Aparece quando a seleção tem rotação. | **Local** |
| **Encostar** | **Livre**, ou um passo de distância de 0,05, 0,1, 0,25, 0,5 ou 1 m, sempre com passo de rotação de 15°. | **0,25 m / 15°** |
| **Ponteiro**, **Alinhar à superfície** | Onde os cliques de colocação caem, e se props e geometria nova seguem a superfície sob o ponteiro. Aparecem só com **Criar geometria**, **Luz**, **Água** ou **Adereços** com um prop armado; **Alinhar à superfície** não existe para **Luz** e **Água**. | Os três alvos, desligado |
| **Enquadrar** | Voa até a seleção. | |
| **Órbita** / **Livre** | Modo de câmera, só na vista Mapa. | **Órbita** |

Com **G**, **R** ou **S** armado, você pode digitar um valor: `-` inverte o sinal, **X**, **Y**, **Z** escolhem o eixo, **Enter** confirma e **Esc** cancela. **Shift** com um arraste de alça duplica a seleção antes. Salas e portais têm alças próprias: veja [Salas](/pt-BR/projects/structures/rooms.md) e [Portais e aberturas](/pt-BR/projects/structures/portals-and-openings.md).

## A árvore da estrutura

A seção **Estrutura** lista tudo da cena por parte, na ordem em que você a deixa: salas, portais, aberturas, props, luzes, conjuntos de entidades, marks, objetos e grupos. Clicar em uma linha a seleciona, ativa a parte dela e troca para a ferramenta que a edita.

![Popover Filtrar tipos com chaves para Salas, Portais, Vãos, Adereços, Luzes, Objetos e Marcações, e botões Tudo e Nenhum](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-tree-filter.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=f4bc2e987f4b9c88fa8d17f8529e01d0)

Filtrar tipos na árvore e nos cliques da vista.

* **Filtrar tipos** esconde tipos da árvore e dos cliques na vista. Fica laranja enquanto algo está desligado.
* O olho esconde um nó na vista, e o cadeado o protege de edições. Em uma parte, valem para tudo dentro dela.
* Arraste linhas para reordenar, para movê-las para dentro ou fora de grupos e conjuntos, ou entre partes. Solte um prop ou luz no meio de uma sala para colocá-lo nela.
* **F2** ou um clique duplo renomeia salas, luzes, objetos, marks, grupos, conjuntos e partes. Portais, aberturas e props não podem ser renomeados ali. A linha de um portal mostra um id interno.
* **Delete** remove as linhas selecionadas. Apagar uma parte pergunta antes. Apagar um grupo o desfaz: os filhos voltam para a raiz da parte.

![Menu Adicionar à estrutura com Novo grupo, Novo prop, Novo conjunto, Importar modelo e Nova parte](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-tree-add-menu.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=25a29b58c3ba586b39e4d63c0ba794b4)

O menu Adicionar à estrutura.

**Adicionar à estrutura** (**+**) adiciona **Novo grupo**, **Novo prop**, **Novo conjunto**, **Importar modelo…** (um arquivo `.glb`, `.ydr` ou `.ydr.xml`) e **Nova parte**. Pressione **F2** para renomear uma parte nova. Um grupo é só organização na árvore: não vai na exportação.

![Menu de contexto com Renomear, Enquadrar, Ocultar, Isolar, Travar, Duplicar, Agrupar e Apagar](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-tree-menu.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=98cb512b106641ffc4298299043b545e)

O menu de clique direito de uma linha da árvore.

Segurar **Alt** sobre a vista abre um menu parecido com mover, girar, escalar, enquadrar, duplicar e apagar, além dos submenus **Seleção** e **Ferramentas**. Ele fecha quando você solta o **Alt**.

> [!TIP]
>
> **H** oculta as peças marcadas, **Shift+H** as isola e **Alt+H** mostra a parte inteira. **Ctrl+C**, **Ctrl+X** e **Ctrl+V** copiam, recortam e colam peças dentro da sessão. Colar vai para a parte ativa e mantém a mesma posição no mundo. A área de transferência não é compartilhada com o sistema.

## Atalhos

Os atalhos são ignorados enquanto um campo de texto, um select ou um diálogo tem o foco.

| Tecla | Ação |
| - | - |
| **Ctrl+S** | Salvar o projeto. |
| **Ctrl+Z**, **Ctrl+Shift+Z** ou **Ctrl+Y** | Desfazer, refazer. |
| **Ctrl+E** | Exportar com o destino lembrado. |
| **V**, **B**, **Shift+M** | **Selecionar**, **Seleção por Caixa**, **Selecionar objetos do mapa**. |
| **1**, **2**, **3**, **4** | **Criar sala**, **Portal**, **Entrada**, **Tesoura**. Cada uma também abre o nível **Interior**. |
| **5**, **Shift+5**, **7**, **8**, **9**, **0** | **Adereços**, **Remover prop**, **Editar geometria**, **Luz**, **Criar geometria**, **Água**. |
| **N** | Abrir e fechar o painel Vista. |
| **G**, **R**, **S** | Iniciar um gesto de mover, girar ou escalar. |
| **X**, **Y**, **Z** | Travar o eixo. Repita para soltar. |
| **C** | Alternar **Órbita** e **Livre**. |
| **F**, **Home**, **Numpad .** | Enquadrar. Com a ferramenta **Portal** e portais selecionados, **F** os inverte. |
| **Delete**, **Backspace** | Apagar a seleção. |
| **Esc** | Encerra a escolha de origem, depois solta a trava de eixo, depois limpa a seleção. Também cancela um desenho ou gesto. |
| **Enter** | Fecha um polígono ou contorno, ou confirma um valor digitado. |
| **Ctrl+D** | Duplicar a seleção. |
| **Ctrl+A**, **Ctrl+I** | Selecionar tudo, inverter a seleção. |
| **F2** | Renomear. |
| **Alt** (segurar) | Menu de contexto sobre a cena. |

## Solução de problemas

> **Preparando o mapa…**
>
> A vista carrega o mundo primeiro. Espere a barra de progresso. Se parar, clique em **Tentar novamente**.

> **A biblioteca do mapa ainda não está pronta. Gere-a na aba Mapa — ela é a mesma para as duas.**
>
> Abra a aba **Mapa** e gere a biblioteca. Veja [Biblioteca](/pt-BR/map/library.md).

> **Não foi possível mover a câmera: …**
>
> O painel da câmera precisa que o mundo esteja rodando, e fica desligado na Planta. Mude para **Mapa** e espere o mapa.

> **O grid está fora do espaço visível. Ajuste a altura do grid ou do corte.**
>
> Defina a **Altura Z (m)** em **Grid de orientação**, ou use o conta-gotas em um vértice, ou desligue o corte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.