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
  • Overview
  • Building a clip
  • Adding nodes to your clip
  • Adjusting settings for a node
  • Enabling and disabling a node
  • Connecting nodes together
  • Node properties and sockets
  • Oscillator nodes
  • Clip editor panel

Was this helpful?

Edit on GitHub
  1. The Clip Editor

Introduction to the Clip Editor

PreviousThe Clip EditorNextFundamentals

Last updated 21 days ago

Was this helpful?

The clip editor is a versatile way to create laser content and it's at the heart of Liberation. It's easy to make simple things and yet flexible enough to make some incredibly sophisticated and complex effects.

The node based editor was the first part of Liberation that was made! It was born from a conversation with Rob Stanley at a UK laser meet up in 2018 about what an "object-oriented" laser content designer would look like.

Although it seems simple, it's quite a complex system to build, but by the start of 2019 I had a working demo that proved the concept - and it started this whole journey!

It's a node based visual editor (or ) that will be familiar if you have used products like TouchDesigner, MaxMSP or VVVV. Although the clip editor is a little different and somewhat simpler as it's been designed specifically for vector graphics.

You can open the Clip Editor by right clicking on the clip button and selecting EDIT CLIP. Or right click on an empty clip button and select CREATE AND EDIT CLIP.

Overview

What you'll see in the clip editor :

  • The Creator and Operator node buttons along the top

  • The Oscillator node buttons along the left

  • A preview of the content in a panel on the right, and if you click on a node, you'll see a second preview that shows you the content at the node itself.

  • All of the nodes and connections for the clip that you are editing (if it's a new clip this wil be empty)

  • The Clip Editor panel with various options

While you're editing, you will also see what the clip looks like in the 3D visualiser in the background.

If you don't see any output in the 3D visualiser, you may need to use the zone buttons to turn on the zones you want. You'll also need to make sure that Preview to lasers is enabled, see Clip editor panel below.

Building a clip

You typically start with one or more , and connect from left to right that process the content. As you move creators and/or operators together you'll notice that they automatically connect to each other. And you can drag them apart to disconnect them again.

Adding nodes to your clip

Click and drag from one of the node buttons along the top or left into an empty space within the clip editor.

Adjusting settings for a node

Click on the cog icon button (top right of the node) to open the properties panel for that node.

Enabling and disabling a node

Click on the power icon button (top left of the node) to enable and disable the node. The node will dim to show that it is not currently active. Note that content still passes through an operator even if it is disabled, but the node doesn't affect the content.

Connecting nodes together

Content is made with a creator node, and is passed along nodes from left to right; each operator affects the content in some way and passes it along to the next operator. Whatever is left at the end of the path is the clip's content. Creators and Operators are automatically connected to each other when you move them close together. To separate them, drag them apart again.

You can connect more than one node into the next node's input. This is helpful to combine multiple pieces of content

Node properties and sockets

Each node has an array of sockets along the bottom and each one represents a property within the node, such as brightness, position, scale, rotation etc.

Oscillator nodes

Oscillator nodes are used to change properties over time. They typically represent waveforms such as a sawtooth or sine wave but some oscillator nodes use external inputs (such as the microphone input level) as their source.

If you've ever used an analog synth, you'll be familiar with the concept of oscillators which are commonly used to create waveforms or adjust the sound over time. Oscillators in Liberation do a similar job.

Fun fact: the name Liberation was inspired by the Moog Liberation, a synthesizer "keytar" released in 1980 and made famous by Herbie Hancock, Jean-Michel Jarre and even James Brown!

Oscillators always have range settings that control the minimum and maximum value of the property to be adjusted. And Wave Oscillators always have a duration setting that determines how fast the oscillator changes the value. See Wave oscillators for more information.

Clip editor panel

  • Timer - at the top of the panel you'll see the current time for the clip as it progresses

  • RETRIGGER - restarts the clip from the beginning; extra useful if your clip doesn't loop

  • Preview to lasers - when this is checked, you'll see the 3D visualiser update as you edit this clip. If you turn it off, you'll see whatever clips are running outside of the editor. This is a global setting, not per clip.

  • UNDO/REDO - for the clip editor itself. Also mapped to CTL/CMD Z and CTL/CMD SHIFT Z.

  • SAVE CLIP - saves your edits but warns you about overwriting

  • SAVE AS A COPY - saves your clip in the next available slot in the clip deck. This becomes the new position for your clip and all subsequent saves will be in this new place.

  • EXIT EDITOR - closes the clip editor. If you have unsaved changes you will get a confirmation panel.

can be connected to these sockets from below and used to animate these settings. Oscillator nodes have an output at the top, click and drag to pull out the connection and drop it into one of the other nodes' property sockets.

🟧
🟦
node graph architecture
creator nodes
operators
Oscillator nodes