User Guide

Document functions 279

Example

The following command sets the matte color to blue:

fw.getDocumentDOM().setMatteColor(true, "#0033ff");

dom.setPixelMask()

Availability

Fireworks 3, deprecated in 4 in favor of dom.setSelectionMask().

Usage

dom.setPixelMask(mask, howToCombineMasks)

Arguments

mask A mask variable that specifies the mask to be applied (see “Mask data type”

on page 11). If

mask is null, any existing pixel-selection mask is removed.

howToCombineMasks If there was previously a mask and the new mask is also not null, then

howToCombineMasks specifies how the two masks should be combined. Acceptable values for

howToCombineMasks are "replace", "add", "subtract", and "intersect".

Returns

Nothing.

Description

If Fireworks is in bitmap mode, this function sets the pixel-selection mask of the current

image to the specified mask.