掩碼

影像遮色片。 指定單獨的遮色片影像，用作未關聯的遮色片。

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

object 可以是目錄條目或影像/SVG檔案。可以為影像圖層和純色圖層指定。

如果​object​解析為影像目錄項，則使用catalog::MaskPath，或者，如果未定義catalog::MaskPath，則使用catalog::Path。 如果​object​未解析為目錄條目，則將其解釋為檔案路徑。

在所有情況下，如果來源影像具有Alpha色版，則會使用它。 否則，在將影像用作圖層蒙版之前（如果需要），將影像轉換為灰度。

如果遮色片附著在純色圖層上，則可使用影像圖層中影像所用的相同規則來裁切和縮放遮色片。 size=、 scale=或 res= 可用於縮放遮色片。

圖層遮色片也可以以​nestedRequest​的形式指定。 巢狀或內嵌的請求會以大括弧括住。 將內嵌的影像伺服請求前置詞為is，將內嵌的影像演算請求前置詞為ir。 如果未指定前置詞，則假定對外部伺服器的請求。 如需詳細資訊，請參閱請求巢狀內嵌和內嵌。

屬性

影像或圖層屬性。 如果layer=comp，則套用至層0。 被效果圖層忽略。

object 不能解析為目錄記錄，該目錄記錄包含 src= 或 mask= 命令 catalog::Modifier。

is和ir字首不區分大小寫。

預設

如果未明確指定mask=，並且圖層影像與目錄條目相關聯，則使用catalog::MaskPath。 否則，如果存在，則使用圖層影像的Alpha通道。 如果沒有Alpha通道，則圖層沒有遮色片，並且圖層矩形會呈現為完全不透明。

範例

使用數個不同的遮色片，為影像的不同區域上色。 已上色的遮色片區域會在原始未修改影像上分層：

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

另請參閱

maskUse= , catalog::MaskPath，物件 ，請求巢狀 和內嵌