How to hide/unhide geometries in the viewer

A how-to guide for hiding/unhiding geometries in the viewer

Introduction

Would you like to hide/unhide certain geometry in the viewer? Then assign layers to the geometries to change their visibility by following these steps.

Prerequisites

  • You configured the frames and routes for your solution.
  • You configured the relevant contents such as the model(s), control panel(s), viewer(s) and datastore.

1. Assign layers to your geometry

  • Under the viewer subscription to the model, use the assignLayers entity to differentiate the layers which can be hidden/unhidden in the viewer.

The configuration should look similar to the example below:

viewer:
  kind: Viewer
  subscribe:
    - kind: Model
      frame: main
      source: model
      assignMaterials:
        my-geometry-1: white
        my-geometry-2: blue
        my-geometry-3: red
      assignLayers:
        my-geometry-1: 1
        my-geometry-2: 2

2. Add buttons to control the geometries’ visibility

  • Under the viewer, define the viewerControls by adding a ButtonBar to the topLeft.
  • Define the orientation of the ButtonBar. It can be horizontal or vertical.
  • Configure the buttons using the ToggleLayer entity.
viewer:
  kind: viewer
  viewerControls:
    topLeft:
      kind: ButtonBar
      orientation: vertical
      buttons:
        - kind: ToggleLayer
          layer: 1 #matches the layer under assignLayer
          icon:
            kind: Icon
            icon: fas-arrows-alt-h
        - kind: ToggleLayer
          layer: 2 #matches the layer under assignLayer
          icon:
            kind: Icon
            icon: fas-envelope-open

See the image below as an example.

Configuration

See the viewerModelSubscribe configuration docs and layerToggle configuration docs for more information.