mask

Masque de l'image. Spécifie une image de masque distincte à utiliser comme masque non associé.

mask= * *|{[is|ir]'{' *objectnestedRequest*'}'}

objet	Objet image à utiliser comme image ou masque de calque.
nestedRequest	Serveur d’images imbriqué, rendu d’images ou requête externe.

object Il peut s’agir d’une entrée de catalogue ou d’un fichier image/SVG. Peut être spécifié pour les calques d’image et les calques de couleur unis.

Si object correspond à une entrée de catalogue d’images, catalog::MaskPath est utilisé ou, si catalog::MaskPath n’est pas défini, catalog::Path est utilisé. Si object ne se résout pas en entrée de catalogue, il est interprété comme un chemin d’accès au fichier.

Dans tous les cas, si l’image source possède un canal alpha, il est utilisé. Dans le cas contraire, l’image est convertie en niveaux de gris, si nécessaire, avant de l’utiliser comme masque de calque.

Si un masque est attaché à un calque de couleur uni, il peut être recadré et redimensionné selon les mêmes règles que celles utilisées pour les images des calques d’image. size=, scale= ou res= peut être utilisé pour mettre le masque à l’échelle.

Les masques de calque peuvent également être spécifiés sous la forme d’un nestedRequest. Les requêtes imbriquées ou incorporées sont entourées d’accolades. Préfixez une requête de diffusion d’images incorporée avec is et une requête de rendu d’images incorporée avec ir. Une requête à un serveur étranger est supposée si aucun préfixe n’est spécifié. Pour plus d’informations, voir Imbrication de requêtes et incorporation .

Propriétés

Image ou attribut de calque. S’applique au calque 0 si layer=comp. Ignoré par les calques d’effet.

object ne doit pas se résoudre à un enregistrement de catalogue qui inclut une src= ou une mask= commande dans catalog::Modifier.

Les préfixes is et ir ne sont pas sensibles à la casse.

Par défaut

Si mask= n’est pas spécifié explicitement et si l’image de calque est associée à une entrée de catalogue, catalog::MaskPath est utilisé. Sinon, le canal alpha de l’image de calque est utilisé, s’il est présent. S’il n’existe aucun canal alpha, le calque n’a aucun masque et le rectangle du calque est rendu entièrement opaque.

Exemple

Utilisez plusieurs masques distincts pour colorer différentes zones d’une image. Les zones colorées et masquées sont superposées sur l’image originale non modifiée :

http://server/myRootId/myImageId?wid=500& layer=1&src=myImageId&mask=myMask1&op_colorize=200,0,0& layer=2&src=myImageId&mask=myMask2&op_colorize=0,200,0& layer=3&src=myImageId&mask=myMask3&op_colorize=0,0,200