webwindowconfigurator/README.md

# WebWindowConfigurator

Componente per configurare un serramento partendo da un JWD.

Durante la configurazione ad ogni cambiamento viene aggiornata l'immagine del serramento.

## Requisiti

I requisiti per utilizzare il componente sono:
  - JWD da modificare;
  - Lista delle famiglie hardware;
  - Lista hardware;
  - Lista dei materiali;
  - Lista dei colori dei materiali;
  - Lista dei vetri ammessi;
  - Lista dei profili gestiti;
  - Lista delle soglie associate al profilo selezionato.

## Funzionalità componente

Il componente permette i seguenti comportamenti principali:

  - Aggiungere un gruppo di ante al telaio;
  - Aggiungere uno split al telaio o a un anta;
  - Copiare il contenuto di un'anta in un'altra anta;
  - Eliminare un gruppo di ante;
  - Eliminare uno split;
  - Cambiare le caratteristiche dei gruppi di ante, delle singole ante, degli split e del frame.

## JWD

Il JWD descrive la struttura e le caratteristiche di un serramento.

Un serramento è composto da un determinato tipo di elementi:
  - Telaio (obbligatorio)
  - Divisione (facoltativa)
  - Gruppo ante (facoltativo)
  - Riempimento (obbligatorio almeno un riempimento)

Al serramento sono associate le seguenti caratteristiche:
  - Profilo;
  - Materiale;
  - Vetro;
  - Colore serramento.

### Telaio (Frame)

Al frame sono associate le seguenti caratteristiche:
  - Forma;
  - Dimensioni;
  - Soglia;
  - Giunti;
  - Quantità bottom Rail.

#### Forme Telaio

Le forme ammesse per il telaio sono le seguenti:
  - Rectangle;
  - Right Chamfer;
  - Left Chamfer;
  - Double Chamfer;
  - Arc;
  - Full Arc;
  - Fillet;
  - Double Arc;
  - Three Center Arc;
  - Triangle;
  - Custom.

### Divisione (Split)

Uno split genera sempre almeno due sottoaree contenenti ognuna un riempimento (Fill) di tipo vetro.
Se ci sono solo due sottoaree generate da uno split, si possono scambiare tra di loro.

Uno split può essere:
  - Orizzontale, viene definito il numero di split orizzontali e l'altezza delle nuove aree orizzontali formate;
  - Verticale, viene definito il numero di split verticali e la larghezza delle nuove aree verticali formate;
  - A griglia, viene definito il numero di split orizzontali e verticali e l'altezza delle aree orizzontali e la larghezza delle aree verticali; in questo caso si può scegliere se hanno la precedenza gli split orizzontali o verticali (cambia il modo in cui si esegue l'incrocio tra gli split).

### Gruppo di ante (Sash group)

Al gruppo di ante sono associate le seguenti caratteristiche:
  - Numero di ante;
  - Orientamento;
  - Quantità bottom rail;
  - Codice hardware.

#### Singola anta

La singola anta ha associate le seguenti caratteristiche:
 - Tipologia di apertura;
 - Dimensione;
 - Tipo di misura della dimensione (assoluta, percentuale o proporzionale);
 - Presenza maniglia;
 - Giunti.

#### Hardware

Per calcolare la lista di hardware ammessi data una famiglia di hardware servono i seguenti dati:
  - Forma del gruppo di ante (tramite richiesta al programma di calcolo);
  - Tipo di apertura dell'anta con la maniglia;
  - Numero di ante;
  - Posizione anta battente (nel caso di tre o più ante, bisogna sapere se l'anta con la maniglia è incernierata al telaio o a un'altra anta).

La richiesta della forma del gruppo di ante viene trasmessa se si cambiano i seguenti parametri:
  - Forma del telaio;
  - Dimensioni del telaio;
  - Aggiunta di uno split nel frame se già presente un gruppo di ante;
  - Se si effettua lo scambio delle aree di uno split e una delle aree contiene una sash;
  - Eliminazione di uno split.

La lista degli hardware viene aggiornata se si cambiano i seguenti parametri:
  - Forma del gruppo di ante;
  - Numero ante nello stesso gruppo di ante;
  - Se si sposta la maniglia e cambia il tipo di apertura e/o la posizione dell'anta battente.

#### Opzioni Hardware
Le opzioni hardware vengono ricevute in formato xml.

Vengono richieste nei seguenti casi:
  - Click sul pulsante per visualizzarle;
  - Cambiamento nel numero di ante;
  - Cambiamento nella selezione dell'hardware;
  - Cambiamento nella selezione della famiglia hardware;
  - Cambiamento di un valore delle opzioni hardware.

### Riempimento (Fill)

Descrive il tipo di riempimento: vetro o pannello.

## Richieste di informazioni a EgwMultiEnginManager

Nel componente sono presenti quattro tipi di richieste al programma EgwMultiEngineManager:
  1. SVG: serve per avere SVG dato il JWD per poter rappresentare il disegno. La domanda è costituita dal JWD e la risposta contiene il SVG;
  2. Forma del telaio: la forma serve per poter determinare la lista degli hardware coerenti con le caratteristiche scelte. La domanda è costituita dal JWD e dalla lista di groupId interessati. La risposta contiene un dizionario di valori interi-stringa che rappresentano groupId-forma;
  3. Hardware option: serve per avere le opzioni relative all'hardware selezionato. La domanda è costituita dal JWD e la lista di groupId interessati. La risposta contiene un dizionario interi-stringa che rappresentano groupId-opzioni hardware. Le opzioni hardware sono restituite in formato xml;
  4. Profili degli elementi: serve per avere i profili degli elementi del groupId richiesto (nel caso di gruppi di ante gli elemeneti sono specificati per ogni anta). La domanda è costituita dal JWD e dalla lista di groupId interessati. La risposta contiene una lisra di oggetti AreaProfiles.