Skip to content

Apply Substrate Map Mask#

🔒 SubstrateMap.ApplyMask

🔒 SubstrateMapMask.Apply

Overview#

This operation is used to apply a Substrate Map Mask. When applying a Substrate Map, all the affected units in the designated region are changed to the Set Value as defined in the mask.

Setup#

No specific setup is required other than to meet the preconditions of the transaction.

Preconditions#

  • The Substrate Map Mask exists and is Active.
  • All the Substrate Maps to which the Substrate Map Mask will be applied exist, are Active, and non-template.

Sequence of Steps#

Apply Substrate Map Mask From a Substrate Map#

Raw (no Bin Converter is set)#

  1. In the Substrate Map, go to the Content View, and select the Bin Code Map Overlay.
  2. Select Apply Mask on the top ribbon:

    Screenshot showing the top ribbon with an "Apply Mask" button.

  3. In the new window, select which Mask to apply:

    Screenshot showing a UI with "Apply Mask" selected and a dropdown list labeled "* Mask:" with "apply submap mask 02" as an option.

    Note

    The selected Mask must have the same Layout Specifier, Substrate Type, Dimension X, Dimension Y, Orientation, Origin Location, and Axis Direction of the currently selected Overlay.

  4. Select Apply to preview the Mask:

    Screenshot showing a UI with a filename hint "apply submap mask 03" and an instruction to select "Apply".

  5. In the preview of the Mask, you can Add Units or Remove Units.

    Info

    If you make changes to the Mask in the preview, the changes will apply to the Map and the Mask.

  6. In the Save Substrate Map Wizard, you can choose to Synchronize Material, Create New Version or a Create New Overlay, and Copy Information.

    Apply submap mask 04

  7. Once you have made your selections, choose Cancel to discard changes or Save to apply them.

Converted (a Bin Converter is set)#

  1. In the Substrate Map, go to the Content View, and select the Bin Code Map Overlay:

    Screenshot showing a bin converter set in the Content View of the Substrate Map, with the Bin Code Map Overlay selected.

  2. If you select Apply Bin Converter on the right, a new window will open for you to select the Bin Converter:

    Screenshot showing the "Apply Bin Converter" button in the UI.

  3. Select the Bin Converter followed by Apply to access the converted Substrate Map:

    Screenshot showing a Bin Converter selected in the interface, with a Substrate Map displayed.

  4. Select Apply Mask on the top ribbon, and select which Mask to apply:

    Screenshot showing a bin converter with an "Apply Mask" option selected from the top ribbon.

  5. Select Apply to preview the Mask with the selected Bin Converter:

    Screenshot showing a bin converter applied in the conversion process.

  6. In the preview of the Mask, you can Add Units or Remove Units.

    Info

    If you make changes to the Mask in the preview, the changes will apply to the Map and the Mask.

  7. In the Save Substrate Map Wizard, you can choose to Synchronize Material, Create New Version or a Create New Overlay, and Copy Information.

    Apply submap mask 04

  8. Once you have made your selections, choose Cancel to discard changes or Save to apply them.

Apply Substrate Map Mask From a Substrate Map Mask (Bulk)#

In the chosen Substrate Map Mask, select Apply Mask on the top ribbon:

Screenshot showing a UI with an applied mask, displaying a substrate map.

Step 1: General Data#

  1. Configure the optional settings:

    • Synchronize Materials - enables Material synchronization.
    • Create New Version / Create New Overlay - select whether to create a new version of the existing Substrate Map Overlay or to create a new overlay.
    • Process Valid Only - if enabled, only valid Substrate Map Masks will be processed.
    • Copy Information - if enabled, the Substrate Map Overlay Information from the original Substrate Map is copied into the newly created Overlay.
  2. Enable the Select Mode option:

    Note

    The Advanced Options for the Select Modes vary. If you select Materials, you can also choose to apply the Substrate Map Mask to Sub-Materials.

  3. In the Apply To Values, you can select Raw or Converted (default).

  4. You can also use the Map Name Filter to specify where the Substrate Map Mask should be applied.
  5. Select Next to continue.

Apply mask

Step 2: Substrate Maps#

  1. Use to add as many Substrate Maps as needed:

    Screenshot showing a user interface with multiple Substrate Maps added, including "Substrate Map (2)" and "Sumurote Mian Geta".

  2. Select Apply to complete the operation.

Step 2: Materials#

  1. Use to add as many Materials as needed:

    Screenshot showing a list of materials with "Munk @ Havas" and "$F atenal Geta" listed.

  2. You can chose to filter the Materials:

    Screenshot showing a list of materials with filtering options.

  3. Select Apply to complete the operation.