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
  •  Point Creator
  • Line Creator
  • Circle Creator
  • Polygon Creator
  • Shape Creator
  • Anim Creator
  • Text Creator

Was this helpful?

Edit on GitHub
  1. The Clip Editor

Creator nodes

PreviousFills, masks and depth sortingNextOperator nodes

Last updated 3 months ago

Was this helpful?

 Point Creator

Makes a single dot / beam.

  • Render profile - see Render profile

  • Colour - the colour of the dot. See Colour settings and HSB

  • x and y position - see Co-ordinate system

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Line Creator

Makes a line / sheet.

  • Render profile - see Render profile

  • Size - the length of the line

  • Colour - the colour of the line. See Colour settings and HSB

  • x and y position - see Co-ordinate system

  • rotation - the angle of the line, in degrees

  • resolution - see Resolution

  • alignment - LEFT / CENTRE / RIGHT - determines the start point and centre of rotation of the line

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Makes a circle /cone.

  • Render profile - see Render profile

  • radius - the radius of the circle

  • Colour - the colour of the circle. See Colour settings and HSB

  • x and y position - see Co-ordinate system

  • resolution - see Resolution

  • Fill state - see Fills, masks and depth sorting

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Makes an equilateral polygon, triangle, square, pentagon etc.

  • Render profile - see Render profile

  • size - the distance from the centre to each of the corners

  • Colour - the colour of the polygon. See Colour settings and HSB

  • x and y position - see Co-ordinate system

  • rotation - the rotated angle of the shape, in degrees

  • resolution - see Resolution

  • Fill state - see Fills, masks and depth sorting

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Loads an SVG file for custom shapes.

Liberation is compatible with the SVGTiny format. InkScape is recommended but most vector graphics apps can export in this format. Make sure to convert any text to shapes before exporting. Liberation will render strokes, and optionally use fills as masks. Make sure your lines are not black or they won't show up without a colour modifier!

  • Import SVG - load an SVG file from disk.

Once an SVG is loaded, the content is converted and saved within the clip, so you don't need to maintain a reference to the file, unless you later want to change the mask settings.

  • Use fills as masks - will process any filled shape as a mask, ie filled in with black. This will be set automatically if your SVG has any filled shapes. If it has no filled shapes, it will be disabled. See Fills, masks and depth sorting

  • Add outlines to filled shapes - if the shapes in your SVG don't have an outline, then we can't draw them! This option adds an outline (or stroke) to any filled shape. If your SVG doesn't have any stroked shapes, It is set automatically. If it doesn't have any filled shapes, it's disabled.

  • Invert black lines - if all of the lines in your SVG are black then you can't see them! This option turns them white. It's set automatically if your SVG only has black shapes, but it's disabled if you don't have any.

  • Render profile - see Render profile

  • scale - adjusts the size of the SVG. This is automatically calculated when the SVG is loaded (to make sure that the image is visible) but can be subsequently edited manually.

  • x and y position - see Co-ordinate system

  • rotation - the rotated angle of the image, in degrees

  • resolution - see Resolution

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Creates an animation from a sequence of SVG files.

  • Import SVG Sequence - choose which folder that has all the SVG files in. Note that they are loaded in alpha-numeric order.

Once the SVG sequence is loaded, the content is converted and saved within the clip, so you don't need to maintain a reference to the files, unless you later want to change the mask settings.

  • Use fills as masks - will process any filled shape as a mask, ie filled in with black. This will be set automatically if any of your SVGs have filled shapes. If none have any filled shapes, it will be disabled. See Fills, masks and depth sorting

  • Add outlines to filled shapes - if the shapes in your SVGs don't have any outlines, then we can't draw them! This option adds an outline (or stroke) to any filled shape. If your SVGs don't have any stroked shapes, It is set automatically. If none have any filled shapes, it's disabled.

  • Invert black lines - if all of the lines in your SVGs are black then you can't see them! This option turns them white. It's set automatically if your SVGs only have black shapes, but it's disabled if you don't have any.

  • Render profile - see Render profile

  • scale - adjusts the size of the image.

  • x and y position - see Co-ordinate system

  • rotation - the rotated angle of the image, in degrees

  • resolution - see Resolution

  • speed - the duration of the entire animation, in bars.

  • time per frame - if this is set then the duration is per frame rather than for the full length of the animation. So if the speed is set to ¼ then every frame will be 1 beat.

  • animation direction -

    • FORWARDS - animation runs forwards and then loops back to the beginning

    • BACKWARDS - animation runs backwards and then loops back to the end

    • PINGPONG - animation runs forwards and then backwards in a loop

    • MANUAL - the current frame is set with the position manual setting

  • position manual - set the current frame, 0% is the first frame, 100% is the last frame. This can be set manually or with an external oscillator.

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Creates text using a TrueType or OpenType font.

  • Text - type the text that you want here

  • Font - choose the font that you want

To add more fonts to Liberation copy the .ttf or .otf files into the data/resources/fonts folder.

  • Render profile - see Render profile

  • horizontal alignment - choose LEFT, CENTRE, or RIGHT to select the text alignment.

  • Fill state - see Fills, masks and depth sorting

  • size - the text size

  • colour - see Colour settings and HSB

  • x and y position - see Co-ordinate system

  • rotation - the rotated angle of the image, in degrees

  • resolution - see Resolution

  • reveal - use this to gradually reveal the text, one character at a time. When this is between 0 and 50% the text will gradually appear from left to right. When between 50% and 100% the text will disappear from left to right. You can connect an oscillator to this socket to make animations.

  • reveal by word - when set, the reveal will work on a word by word basis rather than by character.

  • countdown - a (hurriedly implemented!) countdown system. Will change every 2 beats so if you want seconds make sure you're at 120bpm.

  • countdown start - the number that you want the countdown to start from

  • MOVE TO FRONT / MOVE TO BACK - see Fills, masks and depth sorting

Circle Creator

Polygon Creator

Shape Creator

Anim Creator

Text Creator

🟧
🟦