máscara

Máscara de imagem. Especifica uma imagem de máscara separada a ser usada como uma máscara não associada.

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

objeto	Objeto de imagem a ser usado como imagem ou máscara de camada.
anestedRequest	Serviço de imagem aninhado, Renderização de imagem ou solicitação externa.

object pode ser uma entrada de catálogo ou um arquivo image/SVG. Pode ser especificado para camadas de imagem e camadas de cor sólida.

Se object for resolvido para uma entrada de catálogo de imagem, catalog::MaskPath será usado ou, se catalog::MaskPath não for definido, catalog::Path será usado. Se object não for resolvido para uma entrada de catálogo, então ele será interpretado como um caminho de arquivo.

Em todos os casos, se a imagem de origem tiver um canal alfa, ela será usada. Caso contrário, a imagem será convertida em tons de cinza, se necessário, antes de usá-la como uma máscara de camada.

Se uma máscara for anexada a uma camada de cor sólida, ela poderá ser cortada e dimensionada usando as mesmas regras usadas para imagens em camadas de imagem. size=, scale= ou res= pode ser usada para dimensionar a máscara.

Máscaras de camada também podem ser especificadas na forma de um nestedRequest. As solicitações aninhadas ou incorporadas são fechadas por chaves. Coloque o prefixo is em uma solicitação incorporada de Exibição de imagem com ir. Uma solicitação para um servidor externo é assumida se nenhum prefixo for especificado. Consulte Solicitar aninhamento e incorporação para obter detalhes.

Propriedades

Imagem ou atributo de camada. Aplica-se à camada 0 se layer=comp. Ignorado por camadas de efeito.

object não deve ser resolvido para um registro de catálogo que inclua um src= comando mask= ou no catalog::Modifier.

Os prefixos is e ir não diferenciam maiúsculas de minúsculas.

Padrão

Se mask= não for especificado explicitamente e se a imagem da camada estiver associada a uma entrada de catálogo, então catalog::MaskPath será usado. Caso contrário, o canal alfa da imagem da camada será usado, se presente. Se não houver um canal alfa, a camada não terá máscara e o retângulo da camada será renderizado completamente opaco.

Exemplo

Use várias máscaras separadas para colorir diferentes áreas de uma imagem. As regiões coloridas e mascaradas são colocadas em camadas sobre a imagem original e não modificada:

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