VI10LoadImage

V = Vector

I = Image

Funzione utilizzata per la gestione della funzionalità Vector Image (oggetto presente su alcune versioni di Qpaint).

La funzione VI10LoadImage aggiunge il comando LoadImage in coda alle istruzioni da processare nel Buffer per eseguire il disegno.
Il comando LoadImage permette di caricare, sul layer attivo, l'immagine bitmap associata ad un oggetto Image che si trova sotto l'area occupata dall'oggetto VectorImage.

IMPLEMENTAZIONE

VI10LoadImage (awBuffer, ImageNumber, TanspColor)

Parametri:

IN/OUT	TIPO VARIABILE	NOME DI ESEMPIO	DIM
IN	ARRSYS / ARRGBL	awBuffer	W	Array che funge da buffer per istruzioni/dati
IN	CONST/ GLOBAL	ImageNumber	W	Variabile contenente il numero dell'oggetto Image da cui caricare l'immagine associata Min. 1
IN	CONST/ GLOBAL	TanspColor	W	Variabile contenente il codice colore da considerare come trasparenza. Se impostato a -1 viene considerato il valore di background impostato dal comando VI10SetBackground

Esempio

TASK_00

MAIN:
 
VI10InitBuffer (awBuffer)			;Inizializza il Buffer
 
....
 
ImageNumber = 1					;Imposta il numero dell'immagine da caricare
VI10LoadImage (awBuffer, ImageNumber, -1)	;Aggiunge il comando
 
....
 
VI10DrawBuffer(awBuffer)
 
WAIT 1
JUMP MAIN
 
END

Note

Gli oggetti Image da visualizzare devono essere posti sotto l'area occupata dall'oggetto Vectorimage.
L'immagine viene caricata con l'angolo alto-sinistro coincidente alla coordinata attuale del VectorImage impostata dal comando VI10AddSet.
Il valore del parametro ImageNumber dev'essere superiore a 0 (ZERO). Per trovare il corretto valore di ImageNumber, considerando di avere più oggetti Image posti sotto l'area occupata dal Vectorimage, sfruttare l'impostazione in QPaint della proprietà Z-Order dell'oggetto. La proprietà Z-Order indica il livello di ogni oggetto, statico o dinamico, rispetto agli altri ed è visibile nella barra di stato di QPaint quando si seleziona un oggetto. Essa può essere incrementata o diminuita spostando l'oggetto verso il fronte o verso il fondo. Un buon metodo è di mettere in ordine le immagini e quindi impostare lo Z-Order a partire da 1 e così via. In questo modo si otterrà una corrispondenza diretta tra il valore dell'immagine da visualizzare ed il valore da assegnare al parametro ImageNumber.
Per i codici colore del parametro TanspColor, vedi la Tabella codici colore di QPaint.