maskUse

Utilizzo della maschera immagine. Specifica come la maschera o il canale alfa dell'immagine viene utilizzato per le operazioni sull'immagine (ad esempio, colorize=). Se specificato in un livello di effetto, consente di applicare l'effetto all'area di sfondo del livello padre o all'intero rettangolo del livello padre.

maskUse=norm|invert|off

La tabella seguente illustra l’effetto di maskUse= a seconda della disponibilità e del tipo di maschera (canale alfa) associata all’immagine del livello.

Valore	Nessuna maschera	Alfa non associata (o immagine maschera separata)	Alfa associata (pre-moltiplicata)
off	Rettangolo immagine opaco	Rettangolo immagine opaco	Area in primo piano dell'immagine su rettangolo piena di nero solido
norma	Rettangolo immagine opaco	Area in primo piano dell'immagine	Area in primo piano dell'immagine o del livello
invertire	Livello nascosto	Area di sfondo dell'immagine	Area di sfondo dell'immagine o del livello riempito con nero solido

Proprietà

Attributo immagine o livello. Si applica al livello 0 se layer=comp. Se specificato in un livello di effetto, il comando modifica la maschera ereditata dal livello principale.

Il comportamento di maskUse= non è definito e non è supportato se specificato con livelli di testo o di colore solido quando non è applicabile alcuna maschera immagine (specificato con mask= o catalog::Mask).

Predefinito

maskUse=norm

Esempio

Colorare l'area di sfondo di un'immagine; il primo piano dell'immagine è definito da un'immagine maschera separata. Questo si ottiene sovrapponendo lo sfondo colorato dell'immagine se l'immagine non modificata:

http://server/myRootId/myImageId?layer=1&src=myImageId&mask=myImgMask&maskUse=invert&colorize=0x306090