maskUse

Uso de máscara de imagen. Especifica cómo se utiliza la máscara o el canal alfa de la imagen para operaciones en la imagen (por ejemplo, colorize=). Cuando se especifica en una capa de efecto, permite aplicar el efecto al área de fondo de la capa principal o a todo el rectángulo de la capa principal.

maskUse=norm|invert|off

La siguiente tabla ilustra el efecto de maskUse= en función de la disponibilidad y el tipo de máscara (canal alfa) asociada a la imagen de capa.

Valor	Sin máscara	Alfa no asociado (o imagen de máscara independiente)	Alfa asociado (premultiplicado)
apagado	Rectángulo de imagen opaco	Rectángulo de imagen opaco	Área frontal de la imagen sobre un rectángulo lleno de negro sólido
norm	Rectángulo de imagen opaco	Área frontal de la imagen	Área frontal de la imagen o capa
invert	Capa oculta	Área de fondo de la imagen	Área de fondo de la imagen o capa llena de negro sólido

Propiedades

Imagen o atributo de capa. Se aplica a la capa 0 si layer=comp. Si se especifica en una capa de efecto, el comando modifica la máscara heredada de la capa principal.

El comportamiento de maskUse= no está definido ni es compatible cuando se especifica con capas de texto o de color sólido cuando no se aplica ninguna máscara de imagen (especificada con mask= o catalog::Mask).

Predeterminado

maskUse=norm

Ejemplo

Colorice el área de fondo de una imagen; el primer plano de la imagen se define mediante una imagen de máscara independiente. Esto se logra superponiendo el fondo de la imagen coloreada sobre la imagen sin modificar:

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