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 |
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
).
maskUse=norm
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