Skip to main content

New Mask

The New Mask tool creates an empty mask object associated with the current volume data. This provides a blank canvas for manual segmentation or as a target for other segmentation operations.

Accessing the Tool​

  1. Navigate to the Segmentation tab in the ribbon.
  2. Click New Mask in the Create Mask section.

Parameters​

Mask Settings​

ParameterDescription
NameThe name for the new mask object. Must be unique within the project.
Auto ColorWhen enabled, automatically assigns a color to the mask.
ColorThe display color for the mask (available when Auto Color is disabled).

Workflow​

  1. Open the New Mask tool from the Segmentation tab.
  2. Enter a descriptive Name for the mask.
  3. Either enable Auto Color or click the Color button to select a specific color.
  4. Click Create to generate the mask.

The new mask appears in the Object Browser with the same dimensions, spacing, and origin as the active volume. All voxels are initialized to zero (empty).

Use Cases​

  • Manual Segmentation: Create a blank mask, then use the Edit Mask tool to draw regions manually.
  • Template for Operations: Create masks that will receive segmentation results from other tools.
  • Multi-Mask Workflows: Create multiple blank masks to segment different structures in the same dataset.

Scripting​

This operation is available via the Python scripting API:

import ScriptingApi as api

app = api.Application()
mask_operations = app.get_mask_operations()

# Create a new blank mask
mask_name = mask_operations.create_mask("MyMask")

See the MaskOperations API Reference for details.

See Also​