Rappresentazioni grafiche di variabili

ISaGRAF contiene un editor grafico che consente la creazione di rappresentazioni grafiche animate in debug. Gli elementi grafici devono essere collegati alle variabili del progetto ISaGRAF. Gli elementi grafici sono definiti ed animati "on line".

Disegnare le rappresentazioni grafiche

La lista degli elementi grafici

Definire lo stile degli elementi

Commandi del menù "File"

Note per gli utenti ISaGRAF V3.2

Per forzare il valore di una variabile, fare doppio click sul corrispondente elemento grafico o sul corrispondente elemento nella lista (gli elementi grafici possono essere visualizzati in formato di lista), oppure premere INVIO quando l'elemento è selezionato.

E' anche possibile bloccare il documento (negare ogni modifica da parte di ISaGRAF) utilizzando il comando "File / Blocca". Quando un documento viene bloccato, si può ancora forzare una variabile facendo doppio click sul simbolo corrispondente.


Disegnare le rappresentazioni grafiche

Una rappresentazione grafica è costituita da una figura di sfondo e da un insieme di oggetti grafici che verranno animati durante il debug. Per definire una rappresentazione grafica è necessario eseguire le seguenti operazioni: Selezionare una figura di sfondo, inserire gli oggetti grafici, collegare gli oggetti alle variabili del progetto.

Figure di sfondo

Possono essere inseriti nel grafico i seguenti oggetti grafici:

Testo singolo

 	Barre grafiche unipolari e bipolari

Curve

Icone booleane

Campi di bit

Quando la disposizione grafica è finita, si può modificarla oppure completarla:

Selezionare, spostare o ridimensionare gli elementi

 	Raggruppare gli elementi / dissociare i gruppi

Definire lo stile degli elementi


Figure di sfondo

Le figure di sfondo sono file "bitmap" (.BMP) o "metafile" (.WMF). Il numero di figure incluse nel grafico non è limitato. Le figure possono essere spostate o ridimensionate. Le figure non compaiono nella lista degli elementi grafici animati. Le figure devono essere generate con altri strumenti grafici non inclusi in ISaGRAF. Il comando  "Opzioni / Colore sfondo" della finestra Rappresentazioni grafiche è utilizzato per selezionare un colore uniforme per gli spazi vuoti tra gli elementi grafici.

Note:	I file Bitmap consumano molta memoria. E' raccomandabile dimensionare correttamente la figura, e limitare lo spazio inutilizzato nel rettangolo della figura bitmap.


Testo singolo

L'elemento grafico "Testo singolo" è un campo testo inscritto in un rettangolo. Il testo mostrato è il valore della variabile associata. In tal modo questo elemento può essere collegato a variabili di tipo messaggio.

Il rettangolo dove il testo è visualizzato può essere riempito con un colore oppure può essere lasciato trasparente. Quando tale oggetto grafico viene ridimensionato, la dimensione del front di caratteri utilizzato viene aggiustata in modo da riempire l'altezza del rettangolo.


 	Barre grafiche unipolari e bipolari

L'elemento grafico "Barra" è un rettangolo con una porzione colorata che rappresenta il valore numerico della variabile associata. La parte restante del rettangolo può essere riempita con un colore. Una barra grafica può essere sia verticale che orizzontale.

Le barre grafiche unipolari possono crescere in ogni direzione: verso l'alto, verso il basso, verso sinistra o verso destra.

Le barre grafiche bipolari possono crescere sia in direzione positiva, che negativa, in accordo con il valore della variabile associata. Nel caso di una barra bipolare, il massimo valore permesso è lo stesso sia per la scala positiva che per quella negativa.


Curve

L'elemento grafico "Curva" mostra l'andamento nel tempo della variabile associata. Sebbene non sia uno strumento di misura preciso, può fornire utili informazioni, durante la fase di debug, in merito al sincronismo tra variabili.

Una curva memorizza gli ultimi 200 valori di una variabile. Il numero dei campioni non viene modificato quando si cambiano le dimensioni di tale oggetto grafico.


Icone booleane

L'elemento grafico "Icona booleana" viene utilizzata per visualizzare uno stato binario. Per lo stato logico "FALSE" (falso) è definito un file icona (.ICO), come pure per lo stato logico "TRUE" (vero). L'ambiente ISaGRAF non include nessun editor di icone, i file icona devono essere generati con altri strumenti grafici.


Campi di bit

L'elemento grafico "Campo bit" mostra 32 bit di un valore intero organizzati in un pannello grafico. Il bit meno significativo viene sempre visualizzato sulla destra. Non è raccomandabile utilizzare il Campo bit per altri tipi di dati come ad esempio i reali analogici, poiché l'informazione visualizzata può portare a confusione.


Selezionare, spostare o ridimensionare gli elementi

Un elemento grafico viene aggiunto alla rappresentazione utilizzando le voci del menù "Inserisci", viene avviata la finestra Stile dell'elemento che permette di impostarne le caratteristiche.

La maggior parte dei comandi di editing richiede che gli oggetti grafici siano evidenziati. E' possibile selezionare uno o più oggetti grafici.

Per selezionare un elemento, l'utente deve semplicemente fare click sul simbolo grafico corrispondente. Per selezionare una lista di oggetti, bisogna trascinare il mouse nell'area grafica selezionando una porzione rettangolare. Tutti gli oggetti grafici che intersecano il rettangolo di selezione sono marcati come "selezionati". Un oggetto "selezionato" viene rappresentato con dei piccoli quadratini neri attorno al suo simbolo grafico.

Facendo una nuova selezione, ogni oggetto precedentemente selezionato viene deselezionato. Per rimuovere la selezione esistente, basta semplicemente fare click con il mouse in un area vuota, fuori dal rettangolo di selezione.

Per spostare oggetti grafici, bisogna prima selezionarli. Quindi si posiziona il cursore del mouse sul bordo dell'oggetto selezionato e lo si trascina in un'altra posizione.

Per ridimensionare un oggetto, bisogna prima selezionarlo. Quindi si posiziona il cursore del mouse su uno dei piccoli rettangoli mostrati nel bordo di selezione, e lo si trascina nella direzione desiderata. Anche le figure possono essere ridimensionate. In questo caso, il corrispondente file bitmap o metafile viene deformato in modo da riempire il nuovo rettangolo specificato dall'utente.


 	Raggruppare gli elementi / dissociare i gruppi

Si possono raggruppare assieme gli oggetti grafici, di modo che siano manipolabili come un singolo oggetto. Per costruire un gruppo, bisogna selezionare gli oggetti grafici e quindi eseguire il comando "Modifica / Raggruppa". Il comando "Modifica / Separa" è utilizzato per separare un gruppo di oggetti in singoli oggetti.

Un gruppo può contenere una figura. Un gruppo può contenere un altro gruppo.

Quando gli oggetti vengono raggruppati, il loro stile non può essere più cambiato. Gli oggetti di un gruppo sono singolarmente visibili, ma non permettono di modificare le variabili associate (con un doppio click).

Nella visualizzazione degli oggetti grafici in formato lista, un gruppo occupa una sola linea.


Definire lo stile degli elementi

Lo stile grafico e le impostazioni di un oggetto grafico esistente possono essere modificate, facendo un doppio click sul simbolo corrispondente nell'area grafica, oppure mediante il comando "Modifica / Imposta elemento" quando l'elemento è selezionato. La finestra di dialogo Stile dell'elemento viene aperta anche quando un nuovo oggetto viene aggiunto al documento. L'utente può impostare le seguenti caratteristiche:

Stile grafico e impostazioni:

La tipologia grafica (testo singolo, barra grafica, curva…) di un elemento può essere cambiata dinamicamente. Se in un oggetto vengono utilizzati i colori di primo piano e di sfondo, questi possono essere personalizzati utilizzando le corrispondenti caselle. Quando viene selezionata la tipologia Icona booleana, deve essere specificato il percorso dei file .ICO corrispondenti agli stati logici "TRUE" e "FALSE". Si utilizzano i pulsanti "…" a destra delle caselle Se vero, Se falso per scegliere i file icona presenti su disco.

Fondoscala:

Questo è il massimo valore che può essere visualizzato nelle barre grafiche e nelle curve. Per le barre grafiche bipolari e per le curve bipolari, viene utilizzato lo stesso valore assoluto sia per l'asse positivo che per quello negativo.

Nome della variabile:

Quando il campo "Nome" è attivo, premendo il pulsante "…" a fianco della casella l'utente può selezionare il nome della variabile tra quelle precedentemente selezionate nel dizionario.

Legenda:

Un testo Legenda può essere mostrato vicino all'elemento grafico. Si può personalizzare la posizione di tale legenda (sopra, sotto, sinistra, destra) ed il suo contenuto. Come legenda si può scegliere: il nome di una variabile, il valore di una variabile, entrambi nome e valore. La personalizzazione non ha effetto nella visualizzazione degli oggetti grafici in formato lista.

Variabile di comando:

Se viene selezionata l'opzione "Variabile di comando", l'utente può modificare il valore della variabile associata all'elemento grafico durante il debug, facendo doppio click sul simbolo dell'oggetto grafico.


Commandi del menù "File"
Comandi del menù "File"

I comandi del menu "File" permettono la gestione del file della rappresentazione grafica.

Il comando "Nuovo" del menu "File" serve per iniziare una nuova rappresentazione grafica. ISaGRAF non limita in alcun modo il numero di rappresentazioni grafiche definibili per un progetto. Una eventuale rappresentazione grafica aperta precedentemente viene chiusa prima della modifica di una nuova. La finestra di editing della rappresentazione grafica ISaGRAF non permette la modifica contemporanea di più grafici. Tuttavia, è possibile aprire più finestre di editing ISaGRAF simultaneamente, ciascuna con una rappresentazione grafica diversa.

Il comando "Apri" del menu "File" chiude la rappresentazione grafica corrente ed avvia la modifica di un altra del progetto corrente. La nuova rappresentazione grafica selezionata sostituisce la corrente nella finestra di modifica. Nella finestra di selezione della nuova rappresentazione grafica, è possibile usare il pulsante "Elimina" per cancellarne una esistente, al fine di tenere in ordine la cartella del progetto. Quando viene cancellato una rappresentazione grafica, i file icona e bitmap ad essa riferiti, non vengono cancellati.

Il comando "Salva" del menu "File" memorizza la rappresentazione grafica corrente su disco. Se si tratta di un documento nuovo, è necessario assegnargli un nome prima di salvarlo. Le regole per attribuire il nome ad una rappresentazione grafica sono le seguenti:

-	La lunghezza del file non deve eccedere gli 8 caratteri

-	Il primo carattere deve essere una lettera

-	I seguenti devono essere lettere, numeri o underscore

-	Il nome è "case insensitive"

Il comando "Salva come" del menu "File" permette di salvare con un nome diverso la rappresentazione grafica corrente.


La lista degli elementi grafici

In ogni momento, l'utente può decidere di visualizzare gli elementi come una "Disposizione grafica" o come una "Lista di oggetti grafici", è possibile commutare tra questi due modi di visualizzazione premendo il pulsante della barra strumenti a fianco riportato. Oppure si può utilizzare il comando "Opzioni / Lista / Disposizione" dalla finestra Rappresentazioni grafiche.

Nel modo di visualizzazione come lista, gli oggetti grafici vengono mostrati come una classica lista di finestre. L'altezza riservata a ciascun elemento è calcolata in accordo con il suo stile grafico. Le figure (bitmap e metafile) non sono visibili dalla visualizzazione in formato lista. In tale modalità non è permessa la selezione multipla di oggetti, viene invece permessa la selezione di un singolo oggetto, da utilizzare per impostare lo stile dell'elemento e per cambiare il valore di una variabile.

 	Si possono riordinare gli elementi della lista utilizzando i comandi "Modifica / Sposta in su nella lista" e "Modifica / Sposta in giù nella lista". L'oggetto da spostare deve essere selezionato nella lista.


Note per gli utenti ISaGRAF V3.2

Dalla finestra Rappresentazioni grafiche si possono leggere grafici e liste di diagrammi temporali costruite con gli strumenti ISaGRAF V3.0 o V3.2. Tali file appaiono nella finestra di dialogo del comando "Apri", con la descrizione della loro origine. Tali file possono essere letti e liberamente modificati.

Quando si apre un grafico ISaGRAF V3.2, il documento viene automaticamente marcato come "Bloccato". Se si desidera modificarlo è necessario rimuovere l'opzione "Blocca" dal menù "File".

Quando si apre un grafico o una lista di diagrammi temporali ISaGRAF 3.2, la finestra Rappresentazioni grafiche propone sempre di salvarli in formato nativo. Quando si chiudono documenti di questo tipo viene automaticamente aperta la finestra "Salva come".