Alchemy apps

Houdini add-on

Laserworks Laser Export for Houdini turns lines, curves and outlines into laser cues.

Laserworks Laser Export for Houdini exports an animation as laser frames. In Live Alchemy the export becomes a cue that plays the animation once. It needs Houdini 19.5 or later.

Install

The Live Alchemy installer registers the add-on with every Houdini 19.5 or later it finds, for your account. That includes versions you have installed but not opened yet.

  • Windows and Linux: the installer adds it when it finds Houdini.
  • macOS: in the full installer, press Customize and tick Houdini add-on (laser export). It is ticked when Houdini is in Applications.

Restart Houdini afterwards. Installed Houdini after Live Alchemy? Run the Live Alchemy installer again.

Install by hand

  1. Quit Houdini.
  2. Unzip laserworks_laser_houdini.zip into the packages folder of your Houdini version. Create packages if it isn't there.
  3. Start Houdini.
System Houdini packages folder
Windows Documents\houdiniX.Y\packages
macOS ~/Library/Preferences/houdini/X.Y/packages
Linux ~/houdiniX.Y/packages

X.Y is your Houdini version, such as 20.5.

The installer leaves the zip here:

System Folder
Windows C:\Program Files\Laserworks\Loop Alchemy\Houdini add-on
macOS /Library/Application Support/Laserworks/Houdini add-on
Linux ~/Applications/Laserworks/LoopAlchemy/Houdini add-on

Export a cue

  1. Set up a camera and the frame range.

  2. Select the SOP to export, usually your OUT null. An object node works too.

  3. In the network editor, press Tab and choose Laserworks Laser → Laser Export.

    A Laser Export node named laser_export appears in /out, with your SOP and the viewport camera filled in. The first time, this takes a moment longer.

  4. Go to /out and select the node.

  5. Check Output File, then press Export.

    Houdini writes two files: name.ild and name.xvec. By default they go in a laser folder next to your scene file.

  6. In Live Alchemy, open the Cues page and press Import.

  7. Pick the .xvec file.

    A new frame stack and a cue with the file's name appear.

  8. Drag the cue onto a pad.

The cue plays the animation once, at its length in Houdini. It is Time-Based, with the Restart trigger mode and Bypass Group on. Pressing the pad again restarts it.

The .ild file is a plain ILDA file for any laser software. Opened in Live Alchemy, it adds a frame stack but no cue.

What gets exported

Geometry Exported as
Open polygons (polylines) Lines
NURBS and Bézier curves Lines, sampled along the curve
Closed polygons (text, shapes, meshes) Their edges: by default the outline, borders, sharp creases and silhouette
One-point polygons Beam dots
Points with no primitive (off by default) Beam dots, for particles

Colours come from Cd on vertices, points, primitives or the detail. Alpha dims them. Everything is seen through a camera. Whatever leaves the camera frame is cut at its edge.

Export options

Control What it does
Write .ild and .xvec, or only one of them. Live Alchemy imports the .xvec
ILDA Format Format 5 suits most laser software; Format 4 keeps depth
Source One SOP, or every displayed object matching a name pattern such as * ^cam*
Polygon Faces Outline draws borders, creases above Crease Angle and silhouettes; All Edges draws a wireframe; Border Edges only open borders
Hide Back Edges Drops edges on faces turned away from the camera. Exact for convex shapes only
Colour Is Linear Converts Houdini's linear colours to what you see. Turn it off if your Cd is already display colour
Projection World XY exports world X and Y instead of a camera view, for shapes drawn flat
Fit Keep Aspect fits the camera frame inside the square laser field; Stretch fills it
Laser FPS Resamples the animation to this frame rate (0 keeps the scene rate)
Max Points / Frame The point budget per frame; spacing widens to fit
Anchors tab Extra points where lines start, end and turn sharply, so corners stay sharp

Batch export

Export from a terminal, without opening Houdini's window:

hython -m laserworks_laser.cli scene.hip --rop /out/laser_export

--rop takes the path of your Laser Export node. --output changes the file, --range 1 120 the frames, and --set name=value any option, for example --set faces=all.