Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
OpenUtilities
  • Product Communities
OpenUtilities
OpenUtilities Wiki Masking Elements
    • Sign In
    • +OpenUtilities
    • Access Service Request Manager
    • +Bentley sisHYD Multi Utility
    • Design Features - promis.e Functionality - Promis.e Standard
    • +OpenUtilities sisNET - English
    • +OpenUtilities Substation
    • Promis.e Paths
    • -Promis.e Wiki
      • +CONNECT Edition - Promis.e
      • About Promis.e
      • +Administration Features - Promis.e
      • +APIs_VBA - Promis.e
      • +Automation Features - Promis.e
      • +Component Features - Promis.e
      • +Component Management - Promis.e
      • +CONNECT Services - Promis.e
      • +Data Manager - Promis.e
      • +Database Platform Support - Promis.e
      • +Display - Promis.e
      • +Drawing Management - Promis.e
      • +Engineering Design Considerations - Promis.e
      • Error - Object reference...General
      • +Find_Replace - Promis.e
      • Finding the Tutorial
      • +Installation_Configuration - Promis.e
      • +Interoperability - Promis.e
      • +Licensing - Promis.e
      • +Maintenance Features - Promis.e
      • +Migration - Promis.e
      • +OS Support - Promis.e
      • +Panel Layout - Promis.e
      • +Performance - Promis.e
      • -PowerPlatform Support - Promis.e
        • Area inside the sheet border is filled white
        • Assign actions to function keys
        • Attaching References (Auxiliary Views)
        • Blank, gray project pages
        • Customizing the Interface - CONNECT Edition
        • Customizing the Interface - V8i
        • Elements missing from published or plotted output
        • Empty box is stuck on the screen
        • Error - Format version not supported, not recognized file format
        • Error - Unable load/create dialog item of type 'HTML', id=41510001
        • Inserting Drawings
        • Inserting Elements By Coordinates
        • Inserting Raster Images
        • Inserting Tables
        • Make custom styles available for all pages, symbols
        • +Manipulate Tools - PowerPlatform Support - Promis.e
        • Masking Elements
        • MicroStation Help file
        • Off-grid wires and symbols
        • Pasted elements rotated or scaled
        • Platform Fundamentals for Promis.e Standalone Users
        • promis.e is read-only
        • Restore Platform Defaults - Promis.e
        • Run key-ins when a page is opened
        • Set DGN files to update fields automatically
        • Symbols jump when moved or placed
        • Tools Are Missing From Tasks Menu
        • Turn the Task Bar Menu Back On
        • Unreadable or disappearing elements upon selection
        • View is rotated
      • +Print_Publish Features - Promis.e
      • +ProjectWise Integration - Promis.e
      • Promis.e Help file
      • +Reports_Output Features - Promis.e
      • +Template Management - Promis.e
      • +Text Tools - Promis.e
      • Training FAQs
      • +Wire Numbering - Promis.e
      • +Wiring Features - Promis.e
      • +Project Management - Promis.e
      • Promis.e Title
      • Working from home with Promise.e
    • Replace Family - Find_Replace - Promis.e
    • SQL Server Login

     
     Questions about this article, topic, or product? Click here. 

    Masking Elements

      Product(s): Promis.e, Bentley Substation
      Version(s): through 08.11.13.96
      Environment: N/A
      Area: PowerPlatform Support
      Subarea: N/A

    Background

    It is sometimes desired to mask or hide certain elements, frequently so that other elements such as text are more readable.  This can be done in Promis.e Standalone and Bentley Substation by using a filled shape that is the color of the background.  The "BG" color is a special setting that will always match the color of the background while designing, and will not appear on printouts even if the designing background is black.

    The example used by this article to demonstrate this technique will be a schematic cable symbol.  This symbol is to be used on vertical wire segments, with the tag mnemonic appearing to break, or blank out, the wire without actually breaking or and inserting unwanted connections in the connection list.  The technique can be used for other situations as well.

    It is also possible to define a Text Style that specifies the Background color for masking purposes.  This might work for this example, but it adds complexity.

    The example in this article works in 2D design files only. For 3D design files, element elevations must be adjusted so the elements are truly in front of or behind each other.

    This document assumes the user is familiar with symbol creation in general. 

    Steps to Accomplish

    Create the bulk of the symbol

    Select Create Symbol to create a new Cable type symbol and insert the tag mnemonic, the connection point, connection point text, and insertion point.  Note that for cable symbols, there is a single connection point that should not fall on the wire so that the wire does not break.  So the connection point is typically not in the same position as the insertion point.  In this example the tag mnemonic ("CAB") has "Right Center" alignment and the connection point text ("?") has "Left Center" alignment so they can be placed near each other but never interfere.

    Insert the masking shape

    1. Select the Place Block tool available via Manage > Component Management > Place SmartLine > Polygons > Place Block and other menus.

    2. On the Place Block box that appears, set Area to "Solid", set Fill Type to "Opaque", and set Fill Color to "BG" (for background) by selecting the square in the lower right of the color grid, marked with "B".

    3. Draw the block where the schematic wire should be masked when the symbol is placed.   The block has masked the insertion point and connection point but not the text in the screen shot below.

    4. Close the Place Block dialog or select the Element Selection tool.

    5. Go to the last step on the Create Symbol wizard and save the symbol.


    Be sure to create or modify at least one cable family and specify the new cable symbol in the family's roles since a family must be specified when placing a schematic cable symbol.

    Set the priority of the mask

    Priority is an attribute that elements in a 2D design file have.  Elements with higher Priority appear "in front of" elements with lower Priority.  Since the Priority of the device ID and other symbol text always gets set to 0 when the symbol is saved, it is not possible using Create Symbol to set the text to a higher Priority than the masking shape and still have the priority of the masking shape higher than the default of 0 for everything else such as wires.  This must be done outside of Create Symbol. 

    1. Select File > Open and open the .DGN file for the cable symbol created in the previous section.
    2. Select the masking block in the drawing area.
    3. Select Element > Information (CTRL+I)
    4. Set the value of Priority to 1.
    5. Select the "CAB" device tag in the drawing area.
    6. In Element Information, set the Priority to 2.
    7. Select File > Save.
    8. Use Project Manager to open a project page or close the software.

    Note: This process will have to be repeated if the symbol is subsequently modified using Create Symbol.

    Alternatively, leaving the Priority of the text and masking shape at 0 will work fine when the cable symbol is placed on a wire.  If, however, a wire is drawn across an inserted cable symbol, the wire will not be masked.  To avoid this, always place the cable symbol after the wire is drawn or draw the wire with the Active Element Priority set to a negative value.

    Note for 3D design files: Elements in a 3D design file can be assigned different elevations, or Z origins, so that they are truly in front of or behind other elements.  Even though schematics are 2D by nature, schematic pages and symbols can still be 3D design files.

    Appearance on the schematic

      Original Author: Matt_P

    Keywords: wipeout box, wipe out, mask, hide, hidden

    • PowerPlatform Support
    • Mask
    • Symbol
    • promis.e
    • how to
    • Bentley Substation
    • en
    • SELECTsupport
    • Share
    • History
    • More
    • Cancel
    • Matt_P Created by Communities MVP Matt_P
    • When: Thu, May 30 2013 5:41 PM
    • Satish Saptasagar Last revision by Bentley Colleague Satish Saptasagar
    • When: Mon, Apr 13 2020 9:36 AM
    • Revisions: 11
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2023 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies