ClearMask Command

The ClearMask command in a Logic Template is used to reset all the attribute values within an attribute selection mask to 0. An attribute selection mask is an attribute array used by various filter by attribute commands to select attributes to be tested.

An attribute list consists of anywhere from 1 to 1024 attributes. Each attribute has only two possible values, 0 or 1. If the specified attribute has a value of 1, the attribute is set. If the attribute has a value of 0, the attribute is not set.

Up to 16 individual attribute selection masks can be created during a single search request. Each attribute selection mask is identified by it own ID ( 1 thru 16 ). Each attribute selection mask can have up to 1024 attributes.

To execute a Clear Selection Mask request, use the ClearMask command with one argument:

ClearMask( n1 );

ClearMask Arguments

Argument

Description

n1

The ID ( 1 - 16 ) of the attribute selection mask being cleared.

Access the ClearMask Dialog Box by selecting Attributes->Clear Mask menu item under the Filtering category of the Logic Template editor command menu.

Examples

Command

Description

ClearMask( 7 );

Clear all the attribute requests within the attribute selection mask with ID 7.