> 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/it/project-design/create-a-project/roof-drawing.md).

# Disegno del Tetto

## Scopo di Questa Pagina <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

La pagina **Disegno del Tetto** è la base dell’intero flusso di lavoro di progettazione e fattibilità in solarVis.

Gli utenti iniziano disegnando un **contorno del tetto in 2D**, eventualmente suddividendolo tramite bordi interni, e poi assegnando le **pendenze** per convertire il disegno in un **modello 3D del tetto**.

{% hint style="info" %}
Questo modello 3D viene successivamente utilizzato per:

* Posizionamento dei pannelli
* Analisi delle ombre
* Calcoli energetici e di fattibilità
  {% endhint %}

## Cosa Puoi Fare Qui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

In questa pagina puoi:

* Passare tra **Modalità Visualizzazione** e **Modalità Disegno**
* Disegnare e modificare il contorno del tetto in 2D
* Utilizzare snap e guide angolari per la precisione
* Usare il Rilevatore di Bordi Interni per creare divisioni interne
* Aggiungere e gestire ostacoli sul tetto
* Modificare l’altezza dell’edificio e le falde del tetto
* Assegnare pendenze per convertire la geometria 2D in falde del tetto 3D
* Regolare l’altezza dell’edificio e le proprietà delle falde del tetto
* Cambiare il provider della mappa o caricare immagini personalizzate
* Navigare e ruotare la scena 3D

{% hint style="info" %}
In questa pagina, le modifiche vengono salvate automaticamente dopo essere state apportate.
{% endhint %}

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

## Modalità <a href="#modes" id="modes"></a>

Spiega le modalità di interazione disponibili per visualizzare, disegnare e modificare la geometria del tetto.

### Modalità Visualizzazione <a href="#view-mode" id="view-mode"></a>

La Modalità Visualizzazione viene utilizzata per **ispezionare** il modello del tetto senza modificarne la geometria.

In Modalità Visualizzazione puoi:

* Ruotare, spostare e zoomare la scena
* Accedere e rivedere l’altezza dell’edificio
* Selezionare le falde del tetto per ispezionare proprietà tecniche come pendenza, azimut e informazioni sull’area
* Selezionare l’edificio per modificarlo o spostare il tetto e appiattire le falde
* Tornare alla Modalità Disegno quando sono necessarie modifiche alla geometria

Questa modalità è consigliata per controlli di qualità e validazione.

### Modalità Disegno <a href="#draw-mode" id="draw-mode"></a>

La Modalità Disegno viene utilizzata per **creare e modificare il contorno del tetto in 2D**.

#### Disegnare il Contorno

* Clicca per posizionare i vertici
* Continua a cliccare per definire i bordi
* Chiudi il poligono per completare il contorno
* Le guide arancioni mostrano l’allineamento perpendicolare e parallelo
* I vertici si agganciano automaticamente per creare un contorno pulito del tetto
* Le lunghezze dei bordi vengono visualizzate automaticamente
* I pulsanti Annulla e Ripeti sono sempre disponibili

{% hint style="info" %}
Il contorno è ancora in 2D in questa fase. È necessaria l’assegnazione di una pendenza per convertirlo in 3D.
{% endhint %}

Quando si suddivide o si separa il tetto, utilizzare il **tasto Escape (Esc)** per completare il disegno della linea corrente.

### Conversione da 2D a 3D <a href="#converting-from-2d-to-3d" id="converting-from-2d-to-3d"></a>

Una volta completato il contorno del tetto, le pendenze vengono assegnate alle falde del tetto.

#### Assegnazione della Pendenza

* Seleziona una falda o un bordo
* Regola il valore della pendenza dal pannello a destra
* Oppure trascina direttamente la freccia della pendenza sul modello
* Ogni pendenza trasforma quella falda in un piano 3D

> L’altezza dell’edificio può essere regolata anche numericamente o visivamente.

> Ogni pendenza trasforma una falda piatta in un piano 3D con un orientamento definito. Inoltre, falde diverse possono avere pendenze differenti.

## Rilevatore di Bordi Interni <a href="#inner-edge-detector" id="inner-edge-detector"></a>

Il **Rilevatore di Bordi Interni** aiuta gli utenti a suddividere rapidamente forme di tetto complesse in falde più piccole.

### Come Funziona <a href="#how-it-works" id="how-it-works"></a>

* Analizza gli angoli del contorno del tetto
* Genera una linea interna lungo il bisettore
* Suggerisce queste linee come possibili divisioni interne

### Cosa Possono Fare gli Utenti <a href="#what-users-can-do" id="what-users-can-do"></a>

* Accettare i bordi interni suggeriti
* Regolarli o riposizionarli
* Rimuovere i bordi non necessari
* Aggiungere manualmente i bordi interni mancanti

> I bordi interni definiscono solo la geometria; non assegnano automaticamente le pendenze.

## Ostacoli <a href="#obstacles" id="obstacles"></a>

Gli ostacoli rappresentano oggetti fisici sul tetto dove non è possibile posizionare i pannelli solari.

{% hint style="info" %}
Gli ostacoli influenzano i calcoli delle ombre.
{% endhint %}

### Aggiunta di Ostacoli <a href="#adding-obstacles" id="adding-obstacles"></a>

Puoi aggiungere ostacoli come:

* Rettangoli
* Cerchi
* Poligoni

Ogni ostacolo può essere ridimensionato, spostato e posizionato con precisione.

{% hint style="info" %}
Puoi anche duplicare gli ostacoli per modellare rapidamente elementi ripetitivi sul tetto, oppure la loro altezza sopra la superficie del tetto può essere regolata manualmente.
{% endhint %}

### Caratteristiche degli Ostacoli <a href="#obstacle-features" id="obstacle-features"></a>

* Disegnare ostacoli rettangolari
* Ridimensionare trascinando gli angoli
* Spostare liberamente gli ostacoli sul tetto
* Impostare l’altezza dell’ostacolo per i calcoli delle ombre

{% hint style="info" %}
Gli ostacoli possono essere allineati direttamente alla superficie del tetto utilizzando l’opzione **Flush**.
{% endhint %}

#### Esempi Comuni di Ostacoli

* Camini
* Lucernari
* Antenne paraboliche

## Abbaini <a href="#roof-dormers" id="roof-dormers"></a>

Gli abbaini sono elementi strutturali del tetto che si estendono verticalmente dalla superficie principale del tetto e creano ulteriori falde.

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

In solarVis, gli abbaini sono modellati come parte della geometria del tetto, non come semplici ostacoli. Questo consente alle falde degli abbaini di partecipare alla logica di assegnazione delle pendenze e di posizionamento dei pannelli.

Gli abbaini sono comunemente utilizzati in edifici residenziali e di tipo alberghiero e devono essere definiti accuratamente per evitare layout errati dei pannelli e risultati di ombreggiamento non corretti.

### Aggiunta di un Abbaino <a href="#adding-a-dormer" id="adding-a-dormer"></a>

Gli abbaini possono essere aggiunti mentre si lavora in Modalità Disegno.

Per aggiungere un abbaino:

* Passa alla Modalità Disegno
* Seleziona lo strumento Abbaino dalla barra degli strumenti in alto
* Scegli un tipo di abbaino
* Clicca sulla falda del tetto di destinazione per posizionare l’abbaino

Una volta posizionato, l’abbaino diventa parte della struttura del tetto.

### Tipi di Abbaino <a href="#dormer-types" id="dormer-types"></a>

SolarVis supporta diverse geometrie di abbaino per riflettere le strutture reali dei tetti.

I tipi di abbaino disponibili includono:

* **Abbaino a Solaio**

  Un abbaino a singola falda con un solo piano di tetto.
* **Abbaino a Capanna**

  Un abbaino con due falde inclinate che formano una cresta.
* **Abbaino a Padiglione**

  Un abbaino con più falde inclinate che convergono in alto.

Ogni tipo di abbaino genera automaticamente le proprie falde.

### Proprietà delle Falde degli Abbaini <a href="#dormer-roof-faces-properties" id="dormer-roof-faces-properties"></a>

Quando un abbaino è selezionato, le sue proprietà vengono mostrate nel pannello laterale destro.

Puoi regolare i seguenti parametri:

* **Larghezza**

  Definisce la dimensione orizzontale dell’abbaino.
* **Lunghezza**

  Definisce quanto l’abbaino si estende lungo la superficie del tetto.
* **Pendenza**

  Definisce l’angolo di inclinazione delle falde dell’abbaino.

Tutti i valori vengono inseriti numericamente e aggiornano il modello in tempo reale. Le falde degli abbaini sono trattate come le falde principali del tetto per il posizionamento dei pannelli e i calcoli delle ombre.

### Modifica di un Abbaino <a href="#editing-dormer" id="editing-dormer"></a>

Gli abbaini possono essere modificati dopo il posizionamento.

Puoi:

* Ridimensionare l’abbaino modificando larghezza e lunghezza
* Regolare la pendenza per adattarla ai disegni architettonici
* Spostare l’abbaino sulla falda del tetto
* Riposizionarlo per evitare conflitti con pannelli o ostacoli

Le modifiche vengono applicate istantaneamente a tutte le falde dell’abbaino.

### Duplicazione di un Abbaino <a href="#duplicating-a-dormer" id="duplicating-a-dormer"></a>

Gli abbaini possono essere duplicati per ricreare rapidamente strutture ripetitive del tetto.

**Come Funziona la Duplicazione**

* Seleziona un abbaino esistente
* Clicca sull’azione **Duplica** dalla barra degli strumenti o dal menu contestuale
* Viene creata una copia dell’abbaino con le stesse:
  * Tipo di abbaino
  * Dimensioni
  * Valori di pendenza

L’abbaino duplicato può quindi essere spostato e regolato in modo indipendente.

{% hint style="info" %}
**Abbaini vs Ostacoli**

Gli abbaini non sono ostacoli.

Differenze principali:

* Gli abbaini creano nuova geometria del tetto
* Gli ostacoli bloccano solo il posizionamento dei pannelli

Usa gli abbaini quando la struttura fa parte del tetto.

Usa gli ostacoli per oggetti sul tetto, come camini o sfiati, sulla superficie del tetto.
{% endhint %}

## Pulsanti Annulla & Ripeti & Elimina <a href="#undo-and-redo-and-delete-buttons" id="undo-and-redo-and-delete-buttons"></a>

#### **Annulla**

Annulla l’ultima modifica o disegno effettuato sulla disposizione del tetto.

#### **Ripeti**

Ripristina l’ultima modifica o disegno che era stato annullato.

#### **Elimina**

Rimuove tutto ciò che hai creato, come ostacoli o disegni dal tetto.

## Scorciatoie da Tastiera <a href="#keyboard-shortcuts" id="keyboard-shortcuts"></a>

Le scorciatoie da tastiera ti permettono di lavorare più velocemente e con maggiore precisione durante il disegno e la modifica dei tetti in solarVis.

#### Stati di Visualizzazione

* **1:** Vista dall’alto
* **2:** Vista frontale
* **3:** Vista laterale
* **4:** Vista prospettica
* **5:** Vista isometrica
* **N**: Reimposta Nord

Le scorciatoie di visualizzazione cambiano la vista della telecamera senza modificare la geometria.

#### Strumenti di Progettazione

* **E:** Modalità Modifica
* **C**: Modalità Disegno
* **V:** Modalità Visualizzazione
* **M:** Modalità Spostamento
* **I:** Strumento Bordo Interno

Queste scorciatoie permettono di passare tra strumenti di disegno e modifica.

#### Controlli di Visibilità

* **L:** Mostra o nascondi le dimensioni
* **G:** Mostra o nascondi il suolo satellitare

Le scorciatoie di visibilità riducono il disordine visivo durante la modifica.

#### Azioni

* **Ctrl + Z:** Annulla
* **Ctrl + Shift + Z:** Ripeti
* **Delete o Backspace:** Elimina
* **Ctrl + C:** Duplica

Le scorciatoie di azione gestiscono la cronologia delle modifiche e degli oggetti.

#### Aggiunta Rapida di Ostacoli

* **Alt + C:** Aggiungi ostacolo circolare
* **Alt + R:** Aggiungi ostacolo rettangolare
* **Alt + P:** Aggiungi ostacolo poligonale

Le scorciatoie di aggiunta rapida creano istantaneamente ostacoli per zone d’ombra e aree interdette.

## Modifica dell’Edificio <a href="#building-editing" id="building-editing"></a>

Consente di gestire la struttura complessiva del modello del tetto dopo che il contorno 2D è stato convertito in 3D.

Le modifiche a livello di edificio influenzano tutte le falde collegate e sono fondamentali per calcoli accurati di ombreggiamento, produzione e fattibilità.

{% hint style="info" %}
Il tetto disegnato può essere facilmente duplicato invece di ricrearlo da zero.
{% endhint %}

### Accesso alla Modifica dell’Edificio <a href="#accessing-building-editing" id="accessing-building-editing"></a>

Per accedere agli strumenti di modifica dell’edificio:

* Passa dalla Modalità Disegno alla Modalità Visualizzazione
* Clicca sul corpo dell’edificio
* Si apre il pannello Edificio sul lato destro

Questo pannello contiene azioni che si applicano all’intero edificio o alle falde selezionate.

### Azioni del Pannello Edificio <a href="#building-panel-actions" id="building-panel-actions"></a>

Da questo pannello puoi:

* Modificare numericamente la geometria del tetto e le pendenze

{% hint style="info" %}
Puoi ridimensionare l’edificio orizzontalmente trascinando un bordo orizzontale verso l’esterno o l’interno. Questo estenderà il bordo disegnato e regolerà di conseguenza la dimensione dell’edificio.
{% endhint %}

{% hint style="info" %}
Trascinando i bordi verso l’alto, puoi impostare la pendenza desiderata del tetto
{% endhint %}

* Spostare l’intero tetto che hai disegnato

{% hint style="info" %}
Lo spostamento non modifica la geometria, le pendenze o le dimensioni.
{% endhint %}

* Appiattire le falde del tetto selezionate

{% hint style="info" %}
L’appiattimento è utile per ripristinare assegnazioni di pendenza errate o bordi interni.
{% endhint %}

* Regolare l’altezza dell’edificio numericamente o visivamente nella scena

{% hint style="info" %}
L’altezza dell’edificio influisce sui calcoli delle ombre e sul comportamento dei tetti multilivello.
{% endhint %}

### Selezione delle Falde del Tetto <a href="#roof-face-selection" id="roof-face-selection"></a>

Le singole falde del tetto possono essere selezionate per ispezione o modifica dettagliata.

Per selezionare una falda:

* Fai doppio clic sulla falda
* Si apre il pannello Informazioni sulla Falde del Tetto

Questo consente il controllo a livello di falda senza influenzare l’intero edificio.

#### **Informazioni sulla Falde del Tetto**

Quando una falda è selezionata, vengono visualizzati i seguenti dati:

* **Pendenza** rappresenta l’inclinazione della falda.
* **Azimut** rappresenta l’orientamento bussola della falda
* **Area** rappresenta la superficie utilizzabile della falda.

Questo consente un controllo preciso su strutture di tetto multilivello o complesse.

{% hint style="info" %}
**🧷 Best Practice per la Modifica dell’Edificio**

* Valida sempre la pendenza e l’azimut della falda prima del posizionamento dei pannelli
* Usa Appiattisci Falde per correggere errori iniziali invece di ridisegnare
* Ispeziona ogni falda individualmente su tetti complessi

Una modifica accurata dell’edificio garantisce risultati affidabili in tutti i moduli successivi.
{% endhint %}

## Provider della Mappa e Controlli delle Immagini <a href="#map-provider-and-imagery-controls" id="map-provider-and-imagery-controls"></a>

La selezione della mappa e delle immagini è un primo passo fondamentale per un disegno accurato del tetto.

Questi controlli si trovano in basso a sinistra dello schermo.

### Visibilità Satellitare <a href="#satellite-visibility" id="satellite-visibility"></a>

Puoi attivare o disattivare le immagini satellitari per:

* Ridurre il disordine visivo
* Concentrarti su geometria e misurazioni
* Migliorare la precisione del disegno

### Visibilità delle Dimensioni <a href="#dimension-visibility" id="dimension-visibility"></a>

Puoi mostrare o nascondere le dimensioni per:

* Validare le lunghezze dei bordi
* Ridurre il rumore visivo durante la modifica

{% hint style="info" %}
Le etichette delle dimensioni rimangono leggibili durante lo zoom avanti e indietro.
{% endhint %}

### Selezione del Provider della Mappa <a href="#map-provider-selection" id="map-provider-selection"></a>

Puoi scegliere tra diversi provider di mappe a seconda della disponibilità e della risoluzione:

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

{% hint style="info" %}
Cambiare provider può migliorare la chiarezza delle immagini, la visibilità dei bordi o la precisione dell’allineamento per località specifiche.
{% endhint %}

{% hint style="info" %}
La disponibilità dei dati solari e dei tetti per Google Maps HD dipende dalla copertura della Google Maps Solar API. Si prega di controllare la mappa di copertura sul sito web sottostante per confermare se i dati sono disponibili per la tua posizione.

[Controlla il sito web](https://developers.google.com/maps/documentation/solar/coverage)
{% endhint %}

{% hint style="info" %}
A volte, le impostazioni predefinite del browser potrebbero non supportare “**WebGL**”. Si prega di verificare se il browser supporta WebGL [utilizzando il link](https://get.webgl.org/).

Se visualizzi l’errore **“WebGL is not supported”**, il motore grafico utilizzato per il disegno del tetto potrebbe non funzionare correttamente. Per evitare questo problema, assicurati che WebGL sia abilitato nelle impostazioni del browser.

Puoi seguire i passaggi nel [link](https://www.youtube.com/watch?v=uhcrK0nl_SM) per aggiornare le tue impostazioni.
{% endhint %}

### Immagini Personalizzate <a href="#custom-images" id="custom-images"></a>

Oltre ai provider di mappe, puoi caricare immagini personalizzate.

Casi d’uso comuni includono:

* Planimetrie architettoniche del tetto
* Immagini da drone
* Foto del sito ad alta risoluzione

Le immagini caricate possono essere allineate al sistema di coordinate e utilizzate come riferimento per il disegno.

Questo è particolarmente utile quando le immagini satellitari sono obsolete o poco chiare.

#### **Allineamento dell’Immagine (Regolazione Iniziale)** <a href="#image-alignment-initial-adjustment" id="image-alignment-initial-adjustment"></a>

Quando carichi un’immagine personalizzata, ti verrà chiesto di allinearla con la mappa di base.

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

Per garantire un allineamento accurato:

* Identifica gli stessi punti di riferimento in entrambe le immagini
* Posiziona due punti di riferimento corrispondenti su entrambe le immagini
* Usa elementi chiari e fissi come angoli o bordi del tetto
* Clicca sul pulsante ‘Regola’ per adattare l’immagine a quella satellitare

{% hint style="info" %}
L’immagine a sinistra mostra l’immagine satellitare (ad es. Google Maps), mentre quella a destra mostra l’immagine personalizzata caricata, come immagini da drone.
{% endhint %}

## Telecamera e Navigazione <a href="#camera-and-navigation" id="camera-and-navigation"></a>

<figure><img src="/files/1uU6S9jvPWiZLlq9qg43" alt=""><figcaption></figcaption></figure>

Gli strumenti della telecamera situati in basso a destra influenzano solo la visualizzazione del modello.

> Non modificano la geometria.

#### Bussola di Navigazione

La bussola consente di:

* Passare a viste preimpostate, come dall’alto o laterale
* Validare l’orientamento del tetto
* Ruotare la vista attorno all’edificio

{% hint style="info" %}
Può essere ruotata per visualizzare attorno all’edificio facendo clic destro e trascinando il mouse
{% endhint %}

#### Strumenti della Telecamera

Puoi:

* Spostare la vista
* Ingrandire
* Ridurre

Questi strumenti aiutano a ispezionare i dettagli senza modificare il modello.

{% hint style="info" %}
La mappa può essere spostata premendo e trascinando la rotella del mouse.
{% endhint %}

***

## Pagine Correlate <a href="#related-articles" id="related-articles"></a>

* [Pagina di Posizionamento dei Pannelli e Selezione dell’Inverter](/documentation/it/project-design/create-a-project/panel-placement-and-inverter-selection.md)
* [Pagina Consumi Energetici](/documentation/it/project-design/create-a-project/consumption/energy-consumption.md)

Se riscontri problemi, [non esitare a contattarci.](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/it/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.
