maskUse maskuse
Image mask usage. Specifies how the mask or alpha channel of the image is used for operations on the image (for example, colorize=). When specified in an effect layer, it allows applying the effect to the background area of parent layer or to the entire parent layer rectangle.
maskUse=norm|invert|off
The following table illustrates the effect of maskUse= depending on availability and type of the mask (alpha channel) associated with the layer image.
Properties section-f36ad1af348e45aeb3eb336544df30b0
Image or layer attribute. Applies to layer 0 if layer=comp. If specified in an effect layer, the command modifies the mask inherited from the parent layer.
The behavior of maskUse= is undefined and unsupported when specified with text or solid color layers when no image mask is applicable (specified with mask= or catalog::Mask).
Default section-982dd8174641437786dcb3729ace6428
maskUse=norm
Example section-daa371e9be5547368ff6772342acba0a
Colorize the background area of an image; the image foreground is defined by a separate mask image. This is achieved by layering the colorized image background on top if the unmodified image:
http://server/myRootId/myImageId?layer=1&src=myImageId&mask=myImgMask&maskUse=invert&colorize=0x306090