mask

Dernière mise à jour : 22 juillet 2024
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

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

mask= *object*|{[is|ir]'{' *nestedRequest*'}'}

objetObjet image à utiliser comme image ou masque de calque.
nestedRequestServeur d’images imbriqué, rendu d’images ou requête externe.

object peut être une entrée de catalogue ou 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 à une 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é. Sinon, 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= peuvent être utilisés 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, reportez-vous à la section Demande d’imbrication et d’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 sur un enregistrement de catalogue qui inclut une commande src= ou mask= 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

Voir aussi

maskUse= , catalog::MaskPath, object , Imbrication de requête et incorporation

Experience Manager