Liberation User Manual
  • ✅Important! Read this first
  • ✅Installation / licensing
    • ✅Install for Mac
    • ✅Install for Windows
    • ✅Install for Windows (older versions without an installer)
    • ✅How licensing works
    • ✅Authorising and de-authorising
    • ✅Upgrade / downgrade your license
    • ✅Cancel your subscription
  • ✅FAQ
  • ✅Quick start guide
  • ✅Hardware
    • ✅Compatible lasers and controllers (DACs)
    • ✅Emergency stop / interlocks
    • ✅LaserCube
  • ✅Setting up
    • ✅Laser set up process overview
    • ✅Setting up your project
    • ✅Adding / removing lasers
    • ✅Controller assignment
    • ✅3D Visualiser
    • ✅Laser output settings panel
    • ✅Copy settings between lasers
    • ✅Latency setting
  • 🟦Output view / Zones
    • ✅Overview
    • 🟦Zones
    • 🟦Copy zones between lasers
    • 🟦Re-ordering beam zones
    • 🟦Masks
    • 🟦Test patterns
    • 🟦Alt zone system
  • 🟦Clips & Clip deck
    • 🟦Overview
    • ✅Starting / stopping clips
    • ✅Assigning clips to laser zones
    • ✅What are the small icons on the clip buttons?
    • ✅Clip settings
    • 🟦Zone delay / chase
    • 🟦Clip groups
    • ◼️Global transformations
    • 🟦Organising your clip deck
  • 🟦Effects
  • 🟧The Clip Editor
    • 🟦Introduction to the Clip Editor
    • 🟦Fundamentals
      • 🟦Co-ordinate system
      • 🟦Colour settings and HSB
      • 🟦Render profile
      • 🟦Resolution
      • 🟦Fills, masks and depth sorting
    • 🟦Creator nodes
    • 🟧Operator nodes
      • 🟦Transformations
      • 🟦Duplicators
      • 🟦Colour change
      • 🟧Changers by position
      • ◼️Distorters
      • ◼️MIDI notes
    • 🟧Oscillator nodes
      • ✅Wave oscillators
      • ✅Sound input oscillator
      • ✅Parameter Control
  • 🟧Tempo / synchronisation
  • ◼️Timeline
    • ◼️Overview
    • ◼️Adding an audio file
    • ◼️Recording a show
    • ◼️Adding clips manually
    • ◼️Fine tuning clips
  • ✅Timecode
  • ◼️DMX control
    • ◼️DMX zones
    • ◼️Connecting to an Artnet node
    • ◼️Creating DMX zones
      • ◼️Examples
  • 🟦Graphics and the Canvas system
    • 🟦Introduction
    • 🟦Canvas overview
    • 🟦Canvas view
    • 🟦Canvas settings
    • 🟦Canvas zones
    • 🟦Canvas target areas
  • 🟦MIDI control
    • 🟦MIDI control overview
    • 🟦Live control with the APC40
    • 🟦MIDI Send/Receive
  • 🟦Loading and saving
  • ◼️Tips for loading SVG files
  • ◼️Advanced
    • ◼️How Liberation generates laser content
    • ◼️Scanner presets & render profiles
    • ◼️Advanced laser settings
    • ◼️Render profiles
    • ◼️Colour calibration
  • ◼️Network advice
  • 🟧Troubleshooting
    • 🟦Intermittent / flashing output
    • ✅Live control
    • ✅Missing resources error on startup
  • ✅Reference
    • ✅Keyboard shortcuts
    • ✅APC40 reference
    • ✅MIDI send/receive default mapping
    • ◼️Glossary / jargon
    • ✅The Preset system
  • ✅Credits
Powered by GitBook
On this page
  • Introduction
  • Navigating around the 3D space
  • Settings
  • Camera settings
  • Content settings

Was this helpful?

Edit on GitHub
  1. Setting up

3D Visualiser

PreviousController assignmentNextLaser output settings panel

Last updated 1 month ago

Was this helpful?

Introduction

Liberation's 3D visualiser is an incredibly useful feature - you can design and refine your shows without needing any lasers at all! It's proved an invaluable tool for me, especially when there are particularly complex setups with large numbers of lasers.

Navigating around the 3D space

  • Click and drag to rotate the view around the orbit point

  • Mouse wheel to move backwards and forwards towards the orbit point

  • Click and drag while keeping the shift key pressed to move the camera around laterally (strafe) left, right, up and down along the XY plane

  • Double click anywhere on the visualiser to reset the camera position

Settings

Open the 3D Visualiser Settings panel via the Window menu.

  • Visualiser size - changes the size of the visualiser relative to the rest of the app

  • Brightness Adjustment - changes how bright the lasers appear

  • Show laser numbers - renders the relevant number above each laser

  • Show zone names - renders the relevant zone names below each laser

Camera settings

These settings mostly relate to the virtual camera in 3D space. You can see a drop down with presets for these settings that you can save and reload.

  • Camera distance - The camera is always pointed at its Orbit point. The camera distance is how far away it is from this point. You can also adjust this setting using the mouse scroll wheel.

  • FOV - Field of view - determines how wide angle / zoomed in the camera is.

  • Orbit position - describes the current rotation around the orbit point. The first value is the rotation around the X axis (pitch) and the second value is the rotation around the Y axis (yaw).

  • Orbit centre point - the position of the orbit point in 3D space, x, y, z.

  • Grid height - the height of the grid from the "ground" (ie where y = 0).

Content settings

These settings determine where the lasers (and canvas) are placed within the 3D environment. You can see a drop down with presets for these settings that you can save and reload.

Lasers

Each laser has its own group of settings that you can expand using the small white triangle.

  • 3D Position - the laser's x, y and z position.

  • 3D Orientation - the laser's rotation around each of the x, y and z axes.

  • Flip X / Flip Y - flips the virtual output of the laser - NOTE that this shouldn't be necessary - it's better to use the laser flip / orientation settings to correct any inconsistencies with your hardware.

  • Output Range horizontal / vertical - relates to the max / min angle of your laser's scanners. 60º is standard but you can adjust this if your lasers are different.

Canvas

If you are using the canvas system, you can also choose to include the canvas image within the 3D view. Activate the checkbox to render the canvas within and use the position, orientation and scale settings to determine how it looks within your 3D view.

Seeing "ghost" lasers? The 3D Visualiser is somewhat independent of the laser setup and it's possible to have more lasers within the visualiser than you do in Liberation. When you add a laser to your project, a new laser object inside the visualiser will also be added. But if you delete a laser, there will still remain a "ghost" laser object in the visualiser.

To get rid of all the ghost lasers, click the Remove extra 3D laser objects button (at the bottom of the 3D Visualiser settings panel).

✅
✅
The 3D Visualiser view
The 3D Visualiser Settings panel
3D visualiser laser settings
3D visualiser canvas settings