Skip to content

Interactions

The 3D scene provides several ways to interact with buildings and get information.

Hover Tooltip

When you hover your mouse over a building, a tooltip appears showing:

  • Building name
  • Status dot (colored indicator)
  • Status text (Online/Warning/Critical/Offline)

The tooltip: - Appears immediately on hover - Disappears when cursor leaves the building - Positioned slightly above the building

Click Interaction

Clicking on a building opens a detailed tooltip and focuses the camera.

Detail Tooltip

The detail tooltip shows comprehensive information:

Field Description
Name Building name
Type Building type (Windmill, Data Center, etc.)
Description Your description text
Tags List of assigned tags
Notes Extended notes
Status Current status with colored dot

Closing Tooltips

  • Click the X button in the top-right corner
  • Click elsewhere in the scene
  • Press Escape

Multiple Tooltips

You can have up to 4 detail tooltips open simultaneously:

  • Click on different buildings to open multiple tooltips
  • When you open a 5th, the oldest one closes automatically
  • Useful for comparing building information

Camera Focus

When you click a building:

  1. Camera smoothly animates to face the building
  2. Animation takes 1.2 seconds (ease-out cubic)
  3. Camera positions in front of building based on its orientation:
  4. Building faces North → Camera moves to South
  5. Building faces East → Camera moves to West
  6. etc.
  7. Distance adjusts based on building size

Floating Labels

Building name labels can float above each structure.

Enabling Labels

Toggle labels from: - Control Center → Buildings tab → "Show names" toggle - CLI: wt popup command --layout <id> --labels-visible

Label Behavior

  • Labels always face the camera (billboard style)
  • Render above other objects (no occlusion)
  • Include building name and status dot
  • Update in real-time with state changes

Label Persistence

The label visibility setting is saved per layout and persists across sessions.

Remote Popup Control

From the Control Center or CLI, you can remotely show/hide tooltips:

Show Detail Popup

wt popup command --layout <id> --show-detail --building <building-id>

Opens the detail tooltip for a specific building on all connected scenes.

Close All Popups

wt popup command --layout <id> --close-all

Closes all open tooltips on connected scenes.

Interaction Summary

Action Result
Hover Shows quick tooltip (name + status)
Click Opens detail tooltip + focuses camera
Click X Closes that tooltip
Escape Closes all tooltips
Show names toggle Shows/hides floating labels

Tips

Quick building identification

Hover over buildings to quickly identify them without opening full details.

Comparing buildings

Click multiple buildings to open several tooltips for comparison.

Presentation mode

Enable floating labels during presentations so viewers can identify buildings without interaction.

Remote control

Use the CLI or Control Center to highlight specific buildings on wall displays.