Uso de máscara de imagen. Especifica cómo se utiliza la máscara o el canal alfa de la imagen para las operaciones en la imagen (por ejemplo, colorear=). 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 tabla siguiente ilustra el efecto de maskUse=
en función de la disponibilidad y el tipo de la 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 rectángulo rellena de negro sólido |
norma |
Rectángulo de imagen opaco |
Área frontal de la imagen |
Área frontal de la imagen o capa |
invertir |
Capa oculta |
Área de fondo de la imagen |
Área de fondo de la imagen o capa rellena con negro sólido |
Atributo de imagen o 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á definida y no es compatible cuando se especifica con capas de color sólido o de texto cuando no se aplica ninguna máscara de imagen (se especifica con mask=
o catalog::Mask
).
maskUse=norm
Colorear 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 imagen coloreado en la parte superior si la imagen no modificada:
http://server/myRootId/myImageId?layer=1&src=myImageId&mask=myImgMask&maskUse=invert&colorize=0x306090