> For the complete documentation index, see [llms.txt](https://docs.solarvis.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solarvis.co/documentation/pt/project-design/create-a-project/roof-drawing.md).

# Desenho do Telhado

## Finalidade Desta Página <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

A página **Desenho do Telhado** é a base de todo o fluxo de trabalho de projeto e viabilidade no solarVis.

Os usuários começam desenhando um **contorno do telhado em 2D**, podendo dividi-lo opcionalmente usando arestas internas, e então atribuindo **inclinações** para converter o desenho em um **modelo de telhado em 3D**.

{% hint style="info" %}
Este modelo 3D é posteriormente utilizado para:

* Posicionamento de módulos
* Análise de sombreamento
* Cálculos de energia e viabilidade
  {% endhint %}

## O Que Você Pode Fazer Aqui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

Nesta página, você pode:

* Alternar entre **Modo de Visualização** e **Modo de Desenho**
* Desenhar e editar o contorno do telhado em 2D
* Utilizar guias de alinhamento e ângulo para precisão
* Usar o Detector de Arestas Internas para criar divisões internas
* Adicionar e gerenciar obstáculos no telhado
* Editar altura do edifício e faces do telhado
* Atribuir inclinações para converter a geometria 2D em faces de telhado 3D
* Ajustar altura do edifício e propriedades das faces do telhado
* Alterar o provedor de mapas ou fazer upload de imagens personalizadas
* Navegar e rotacionar a cena 3D

{% hint style="info" %}
Nesta página, as alterações são salvas automaticamente após serem feitas.
{% endhint %}

{% embed url="<https://app.arcade.software/share/MSHbtxFt4DZQT1q5cmR6?language=pt>" %}

## Modos <a href="#modes" id="modes"></a>

Explica os modos de interação disponíveis para visualizar, desenhar e modificar a geometria do telhado.

### Modo de Visualização <a href="#view-mode" id="view-mode"></a>

O Modo de Visualização é utilizado para **inspecionar** o modelo do telhado sem modificar sua geometria.

No Modo de Visualização, você pode:

* Rotacionar, mover e dar zoom na cena
* Acessar e revisar a altura do edifício
* Selecionar faces do telhado para inspecionar propriedades técnicas como inclinação, azimute e informações de área
* Selecionar o edifício para editar ou mover o telhado e nivelar as faces
* Voltar ao Modo de Desenho quando forem necessárias alterações na geometria

Este modo é recomendado para verificações de qualidade e validação.

### Modo de Desenho <a href="#draw-mode" id="draw-mode"></a>

O Modo de Desenho é utilizado para **criar e editar o contorno do telhado em 2D**.

#### Desenhando o Contorno

* Clique para posicionar vértices
* Continue clicando para definir as arestas
* Feche o polígono para completar o contorno
* Guias laranjas mostram alinhamento perpendicular e paralelo
* Os vértices se encaixam automaticamente para criar um contorno limpo do telhado
* Os comprimentos das arestas são exibidos automaticamente
* Botões de desfazer e refazer estão sempre disponíveis

{% hint style="info" %}
O contorno ainda está em 2D nesta etapa. É necessário atribuir uma inclinação para convertê-lo em 3D.
{% endhint %}

Ao subdividir ou dividir o telhado, utilize a **tecla Escape (Esc)** para finalizar o desenho da linha atual.

### Convertendo de 2D para 3D <a href="#converting-from-2d-to-3d" id="converting-from-2d-to-3d"></a>

Após o contorno do telhado estar completo, as inclinações são atribuídas às faces do telhado.

#### Atribuição de Inclinação

* Selecione uma face ou aresta
* Ajuste o valor da inclinação no painel à direita
* Ou arraste a seta de inclinação diretamente no modelo
* Cada inclinação transforma aquela face em um plano 3D

> A altura do edifício também pode ser ajustada numericamente ou visualmente.

> Cada inclinação transforma uma face plana em um plano 3D com orientação definida. Além disso, diferentes faces podem ter inclinações diferentes.

## Detector de Arestas Internas <a href="#inner-edge-detector" id="inner-edge-detector"></a>

O **Detector de Arestas Internas** auxilia os usuários a dividir rapidamente formas de telhado complexas em faces menores.

### Como Funciona <a href="#how-it-works" id="how-it-works"></a>

* Analisa os ângulos do contorno do telhado
* Gera uma linha interna ao longo da bissetriz
* Sugere essas linhas como possíveis divisões internas

### O Que os Usuários Podem Fazer <a href="#what-users-can-do" id="what-users-can-do"></a>

* Aceitar as arestas internas sugeridas
* Ajustá-las ou reposicioná-las
* Remover arestas desnecessárias
* Adicionar manualmente as arestas internas que faltam

> As arestas internas definem apenas a geometria; elas não atribuem inclinações automaticamente.

## Obstáculos <a href="#obstacles" id="obstacles"></a>

Obstáculos representam objetos físicos no telhado onde não é possível instalar módulos solares.

{% hint style="info" %}
Obstáculos afetam os cálculos de sombreamento.
{% endhint %}

### Adicionando Obstáculos <a href="#adding-obstacles" id="adding-obstacles"></a>

Você pode adicionar obstáculos como:

* Retângulos
* Círculos
* Polígonos

Cada obstáculo pode ser redimensionado, movido e posicionado com precisão.

{% hint style="info" %}
Você também pode duplicar obstáculos para modelar rapidamente elementos repetitivos no telhado, ou ajustar manualmente sua altura acima da superfície do telhado.
{% endhint %}

### Funcionalidades dos Obstáculos <a href="#obstacle-features" id="obstacle-features"></a>

* Desenhar obstáculos retangulares
* Redimensionar arrastando os cantos
* Mover obstáculos livremente sobre o telhado
* Definir a altura do obstáculo para cálculos de sombreamento

{% hint style="info" %}
Os obstáculos podem ser alinhados diretamente à superfície do telhado usando a opção **Flush**.
{% endhint %}

#### Exemplos Comuns de Obstáculos

* Chaminés
* Claraboias
* Antenas parabólicas

## Águas-Furtadas <a href="#roof-dormers" id="roof-dormers"></a>

Águas-furtadas são elementos estruturais do telhado que se projetam verticalmente a partir da superfície principal do telhado e criam faces adicionais.

<div align="left"><figure><img src="/files/OrDyXzeECNtjaNlRGf6S" alt=""><figcaption></figcaption></figure></div>

No solarVis, águas-furtadas são modeladas como parte da geometria do telhado, e não como simples obstáculos. Isso permite que as faces das águas-furtadas participem da lógica de inclinação e posicionamento de módulos.

Águas-furtadas são comuns em edifícios residenciais e do tipo hotel, e devem ser definidas com precisão para evitar layouts incorretos de módulos e resultados de sombreamento inadequados.

### Adicionando uma Água-Furtada <a href="#adding-a-dormer" id="adding-a-dormer"></a>

Águas-furtadas podem ser adicionadas enquanto se trabalha no Modo de Desenho.

Para adicionar uma água-furtada:

* Mude para o Modo de Desenho
* Selecione a ferramenta Água-Furtada na barra de ferramentas superior
* Escolha um tipo de água-furtada
* Clique na face do telhado desejada para posicionar a água-furtada

Uma vez posicionada, a água-furtada passa a fazer parte da estrutura do telhado.

### Tipos de Água-Furtada <a href="#dormer-types" id="dormer-types"></a>

O SolarVis suporta múltiplas geometrias de águas-furtadas para refletir estruturas reais de telhados.

Os tipos disponíveis incluem:

* **Água-Furtada Shed**

  Água-furtada de uma única inclinação com um plano de telhado.
* **Água-Furtada Gable**

  Água-furtada com duas faces inclinadas formando um espigão.
* **Água-Furtada Hip**

  Água-furtada com múltiplas faces inclinadas convergindo no topo.

Cada tipo de água-furtada gera automaticamente suas próprias faces de telhado.

### Propriedades das Faces das Águas-Furtadas <a href="#dormer-roof-faces-properties" id="dormer-roof-faces-properties"></a>

Quando uma água-furtada é selecionada, suas propriedades são exibidas no painel à direita.

Você pode ajustar os seguintes parâmetros:

* **Largura**

  Define o tamanho horizontal da água-furtada.
* **Comprimento**

  Define o quanto a água-furtada se estende ao longo da superfície do telhado.
* **Inclinação**

  Define o ângulo de inclinação das faces da água-furtada.

Todos os valores são inseridos numericamente e atualizam o modelo em tempo real. As faces das águas-furtadas são tratadas da mesma forma que as faces principais do telhado nos cálculos de posicionamento de módulos e sombreamento.

### Editando Água-Furtada <a href="#editing-dormer" id="editing-dormer"></a>

Águas-furtadas podem ser editadas após serem posicionadas.

Você pode:

* Redimensionar a água-furtada alterando a largura e o comprimento
* Ajustar a inclinação para corresponder aos desenhos arquitetônicos
* Mover a água-furtada pela face do telhado
* Reposicioná-la para evitar conflitos com módulos ou obstáculos

As edições são aplicadas instantaneamente a todas as faces da água-furtada.

### Duplicando uma Água-Furtada <a href="#duplicating-a-dormer" id="duplicating-a-dormer"></a>

Águas-furtadas podem ser duplicadas para recriar rapidamente estruturas repetitivas no telhado.

**Como Funciona a Duplicação**

* Selecione uma água-furtada existente
* Clique na ação **Duplicar** na barra de ferramentas ou no menu de contexto
* Uma cópia da água-furtada é criada com os mesmos:
  * Tipo de água-furtada
  * Dimensões
  * Valores de inclinação

A água-furtada duplicada pode então ser movida e ajustada independentemente.

{% hint style="info" %}
**Águas-Furtadas vs Obstáculos**

Águas-furtadas não são obstáculos.

Principais diferenças:

* Águas-furtadas criam nova geometria de telhado
* Obstáculos apenas bloqueiam o posicionamento de módulos

Use águas-furtadas quando a estrutura fizer parte do telhado.

Use obstáculos para objetos sobre o telhado, como chaminés ou dutos, na superfície do telhado.
{% endhint %}

## Botões Desfazer & Refazer & Excluir <a href="#undo-and-redo-and-delete-buttons" id="undo-and-redo-and-delete-buttons"></a>

#### **Desfazer**

Reverte o último desenho ou edição feita no layout do telhado.

#### **Refazer**

Restaura o último desenho ou edição que foi desfeita.

#### **Excluir**

Remove tudo o que você fez, como obstáculos ou desenhos do telhado.

## Atalhos de Teclado <a href="#keyboard-shortcuts" id="keyboard-shortcuts"></a>

Atalhos de teclado permitem trabalhar mais rápido e com mais precisão ao desenhar e editar telhados no solarVis.

#### Estados de Visualização

* **1:** Vista Superior
* **2:** Vista Frontal
* **3:** Vista Lateral
* **4:** Vista em Perspectiva
* **5:** Vista Isométrica
* **N**: Redefinir Norte

Os atalhos de visualização alteram a visão da câmera sem modificar a geometria.

#### Ferramentas de Projeto

* **E:** Modo de Edição
* **C**: Modo de Desenho
* **V:** Modo de Visualização
* **M:** Modo de Movimento
* **I:** Ferramenta de Aresta Interna

Esses atalhos alternam entre ferramentas de desenho e edição.

#### Controles de Visibilidade

* **L:** Mostrar ou Ocultar Dimensões
* **G:** Mostrar ou Ocultar Imagem de Satélite

Os atalhos de visibilidade reduzem a poluição visual durante a edição.

#### Ações

* **Ctrl + Z:** Desfazer
* **Ctrl + Shift + Z:** Refazer
* **Delete ou Backspace:** Excluir
* **Ctrl + C:** Duplicar

Os atalhos de ação gerenciam o histórico de edição e objetos.

#### Adição Rápida de Obstáculos

* **Alt + C:** Adicionar Obstáculo Circular
* **Alt + R:** Adicionar Obstáculo Retangular
* **Alt + P:** Adicionar Obstáculo Poligonal

Os atalhos de adição rápida criam instantaneamente obstáculos para áreas de sombreamento e zonas proibidas.

## Edição do Edifício <a href="#building-editing" id="building-editing"></a>

Permite gerenciar a estrutura geral do modelo do telhado após o contorno 2D ter sido convertido em 3D.

As edições em nível de edifício afetam todas as faces do telhado conectadas e são críticas para cálculos precisos de sombreamento, produção e viabilidade.

{% hint style="info" %}
O telhado desenhado pode ser duplicado facilmente, em vez de criá-lo novamente do zero.
{% endhint %}

### Acessando a Edição do Edifício <a href="#accessing-building-editing" id="accessing-building-editing"></a>

Para acessar as ferramentas de edição do edifício:

* Mude do Modo de Desenho para o Modo de Visualização
* Clique no corpo do edifício
* O painel do Edifício será aberto no lado direito

Este painel contém ações que se aplicam ao edifício inteiro ou às faces do telhado selecionadas.

### Ações do Painel do Edifício <a href="#building-panel-actions" id="building-panel-actions"></a>

A partir deste painel, você pode:

* Editar a geometria do telhado e inclinações numericamente

{% hint style="info" %}
Você pode redimensionar o edifício horizontalmente arrastando uma aresta horizontal para fora ou para dentro. Isso irá estender a aresta desenhada e ajustar o tamanho do edifício de acordo.
{% endhint %}

{% hint style="info" %}
Arrastando as arestas para cima, você pode definir a inclinação desejada do telhado
{% endhint %}

* Mover todo o telhado que você desenhou

{% hint style="info" %}
O movimento não altera a geometria, inclinações ou dimensões.
{% endhint %}

* Nivelar as faces do telhado selecionadas

{% hint style="info" %}
Nivelar é útil para redefinir atribuições de inclinação incorretas ou arestas internas.
{% endhint %}

* Ajustar a altura do edifício numericamente ou visualmente na cena

{% hint style="info" %}
A altura do edifício afeta os cálculos de sombreamento e o comportamento de telhados em múltiplos níveis.
{% endhint %}

### Seleção de Face do Telhado <a href="#roof-face-selection" id="roof-face-selection"></a>

Faces individuais do telhado podem ser selecionadas para inspeção detalhada ou edição.

Para selecionar uma face do telhado:

* Clique duas vezes na face
* O painel de Informações da Face do Telhado será aberto

Isso permite controle em nível de face sem afetar todo o edifício.

#### **Informações da Face do Telhado**

Quando uma face do telhado é selecionada, os seguintes dados são exibidos:

* **Inclinação** representa a inclinação da face do telhado.
* **Azimute** representa a orientação da face do telhado em relação à bússola
* **Área** representa a superfície utilizável da face do telhado.

Isso permite controle preciso sobre estruturas de telhado complexas ou de múltiplos níveis.

{% hint style="info" %}
**🧷 Melhores Práticas para Edição do Edifício**

* Sempre valide a inclinação e o azimute da face do telhado antes do posicionamento dos módulos
* Use Nivelar Faces para corrigir erros iniciais em vez de redesenhar
* Inspecione cada face do telhado individualmente em telhados complexos

A edição precisa do edifício garante resultados confiáveis em todos os módulos subsequentes.
{% endhint %}

## Provedor de Mapas e Controles de Imagem <a href="#map-provider-and-imagery-controls" id="map-provider-and-imagery-controls"></a>

A seleção de mapas e imagens é um passo inicial crítico para o desenho preciso do telhado.

Esses controles estão localizados no canto inferior esquerdo da tela.

### Visibilidade de Satélite <a href="#satellite-visibility" id="satellite-visibility"></a>

Você pode ativar ou desativar a imagem de satélite para:

* Reduzir a poluição visual
* Focar na geometria e medições
* Melhorar a precisão do desenho

### Visibilidade das Dimensões <a href="#dimension-visibility" id="dimension-visibility"></a>

Você pode mostrar ou ocultar as dimensões para:

* Validar comprimentos das arestas
* Reduzir ruído visual durante a edição

{% hint style="info" %}
Os rótulos de dimensão permanecem legíveis ao dar zoom in e out.
{% endhint %}

### Seleção do Provedor de Mapas <a href="#map-provider-selection" id="map-provider-selection"></a>

Você pode escolher entre diferentes provedores de mapas, dependendo da disponibilidade e resolução:

* Google Maps
* Google Maps HD (Google Solar API)
* Azure Maps

{% hint style="info" %}
Alternar provedores pode melhorar a clareza da imagem, visibilidade das arestas ou precisão do alinhamento para locais específicos.
{% endhint %}

{% hint style="info" %}
A disponibilidade de dados solares e de telhado para o Google Maps HD depende da cobertura da Google Maps Solar API. Por favor, verifique o mapa de cobertura no site abaixo para confirmar se há dados disponíveis para sua localização.

[Verifique o site](https://developers.google.com/maps/documentation/solar/coverage)
{% endhint %}

{% hint style="info" %}
Às vezes, as configurações padrão do navegador podem não suportar “**WebGL**”. Por favor, verifique se seu navegador suporta WebGL [usando o link](https://get.webgl.org/).

Se você visualizar o erro **“WebGL is not supported”**, o mecanismo gráfico utilizado para o desenho do telhado pode não funcionar corretamente. Para evitar esse problema, certifique-se de que o WebGL está ativado nas configurações do seu navegador.

Você pode seguir os passos no [link](https://www.youtube.com/watch?v=uhcrK0nl_SM) para atualizar suas configurações.
{% endhint %}

### Imagens Personalizadas <a href="#custom-images" id="custom-images"></a>

Além dos provedores de mapas, você pode fazer upload de imagens personalizadas.

Casos de uso comuns incluem:

* Plantas arquitetônicas do telhado
* Imagens de drones
* Fotos do local em alta resolução

As imagens enviadas podem ser alinhadas ao sistema de coordenadas e usadas como referência para o desenho.

Isso é especialmente útil quando a imagem de satélite está desatualizada ou pouco clara.

#### **Alinhamento de Imagem (Ajuste Inicial)** <a href="#image-alignment-initial-adjustment" id="image-alignment-initial-adjustment"></a>

Ao fazer upload de uma imagem personalizada, será solicitado que você a alinhe com o mapa base.

<figure><img src="/files/YR6GsbDwkO8tTBUNdWON" alt=""><figcaption></figcaption></figure>

Para garantir um alinhamento preciso:

* Identifique os mesmos pontos de referência em ambas as imagens
* Coloque dois pontos correspondentes em ambas as imagens
* Use elementos claros e fixos, como cantos ou arestas do telhado
* Clique no botão ‘Ajustar’ para encaixar a imagem sobre a imagem de satélite

{% hint style="info" %}
A imagem à esquerda mostra a imagem de satélite (por exemplo, Google Maps) e a imagem à direita mostra a imagem personalizada enviada, como imagens de drone.
{% endhint %}

## Câmera e Navegação <a href="#camera-and-navigation" id="camera-and-navigation"></a>

<figure><img src="/files/rbnBVVB843uDnXjMiloX" alt=""><figcaption></figcaption></figure>

As ferramentas de câmera localizadas no canto inferior direito afetam apenas a visualização do modelo.

> Elas não alteram a geometria.

#### Bússola de Navegação

A bússola permite:

* Saltar para visualizações predefinidas, como superior ou lateral
* Validar a orientação do telhado
* Rotacionar a visualização ao redor do edifício

{% hint style="info" %}
Ela pode ser rotacionada para visualizar ao redor do edifício clicando com o botão direito e arrastando o mouse
{% endhint %}

#### Ferramentas de Câmera

Você pode:

* Mover a visualização
* Dar zoom in
* Dar zoom out

Essas ferramentas ajudam a inspecionar detalhes sem modificar o modelo.

{% hint style="info" %}
O mapa pode ser movido pressionando e arrastando a roda do mouse.
{% endhint %}

***

## Páginas Relacionadas <a href="#related-articles" id="related-articles"></a>

* [Página de Posicionamento de Módulos e Seleção de Inverter](/documentation/pt/project-design/create-a-project/panel-placement-and-inverter-selection.md)
* [Página de Consumo de Energia](/documentation/pt/project-design/create-a-project/consumption/energy-consumption.md)

Se você encontrar algum problema, [sinta-se à vontade para nos contatar.](https://www.solarvis.co/en/company/contact)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solarvis.co/documentation/pt/project-design/create-a-project/roof-drawing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.