simap / lxstudio-te

TE's LXStudio app

Titanic's End LXStudio

Titanic's End is a mutant vehicle designed for Burning Man 2022. (and beyond!)

This repo covers the code for the design and instrumentation of the many LEDS wrapped around this mutant vehicle.

We use LX Studio to control the light show, and this README will get you up and running with LX Studio so you, too, can help us create some great patterns.

What if I want to know more?

This doc sets out the project vision and has so much more information: Lighting Design Doc

Getting started

These are geared toward running LX Studio on a Macbook with git already installed. If you need help with anything, ask in the Slack #lighting-software channel!

First, you'll need an IDE (editor). IntelliJ's Community Edition is the best free one available. You can download it here: https://www.jetbrains.com/idea/

Steps for setup:

1. Clone the git repo you're looking at:

   git clone https://github.com/titanicsend/LXStudio-TE.git
   

2. Open the project director you cloned to when you're presented with "New Project" and "Open" options. That's the initial screen.

3. File → Project Structure (or ⌘-;)

   1. Platform Settings → SDKs

      1. Either add the installed Temurin 17 JDK

      2. Or, if that JDK is not installed, you can click the '+' and then select "Download JDK..."

         1. Select 17 as the Version
         2. Select "Eclipse Temarin" as the Vendor
         • Do NOT select the "aarch64" version otherwise you'll experience pain. Pick the other one

         

   2. Project Settings → Project

      1. Select the Temurin 17 JDK

4. Select "Titanic's End" in the top bar (in the dropdown to the right of the hammer) if you want to use the vehicle model, or "Testahedron" if you want the testahedron model.

5. Hit the green arrow "play" button. (If you just want to build, you can hit the hammer.)

6. Assuming things work okay, a UI for LX Studio will pop up: Great! Now, you can play with the buttons.

Potential issues

• Maven resources compiler: Failed to copy [...]/target/generated-test-sources/test-annotations/Icon ' to '[...]/target/test-classes/Icon
  • Go to the top of your TE repo and run find . -name Icon\? -delete

Digging in

So you've got the app up and running. You see some patterns in the code. How do you make sense of them?

Coordinate System

To understand the point, edge, and panel naming scheme, see the Visual Map tab of the Modules, Edges and Panels sheet.

Learning LX and Developing Patterns

TE is using the full IDE-ready distribution instead of the P4 Processing Applet version. Don't struggle - ask questions in #lighting-software on Slack.

The tutorials in the LX Studio Wiki are an effective introduction.

These have been compiled by our team:

• Operation Modes and Art Direction Standards
• Using Tempo and Sound
• The APC40 and LX Studio

As you really get rolling, you’ll appreciate the API docs and public portion of the source.

Celebrating the installation

Once it's running, go tell Slack so we can celebrate with you and maybe give you a tour. Or, if you prefer self-guided tours:

• Read the LX Studio Wiki
• Play with the UI until you have a modulator controlling the parameter for a pattern, and an effect applied on top.
  • See this guide from another memorable Burning Man art piece
• Define a new fixture in the UI
• [Optional] Save your playground as a new project with your name: Playground <YourName>.lxp. You can mess this project up and experiment broadly.

Tips and tricks

Things that can help improve your experience with LX Studio.

Recognize LX Studio JSON file extensions

It can be handy to edit LX Studio's JSON config files in the IDE. Add the .lxf and .lxp extensions to be recognized as JSON.

1. Open IntelliJ preferences (⌘-, on Mac) and go to Editor → File Types → JSON.
2. Next, add "*.lxp" to the list, and so on.

Optional Plugins

Jeff's enjoying the following (he comes from Sublime and vim):

• CodeGlance
• Rainbow Brackets
• IdeaVim
• CSV
• KeyPromoter X
• Python Community Edition

Coming from VS Code?

Many of you may use VS Code in your day-to-day life. If you do, and you'd like IntelliJ to behave more like VS Code, I'd recommend:

1. In IntelliJ, open the "IntelliJ IDEA" menu and select "Preferences"
2. Click "Plugins"
3. Search for "VSCode Keymap"; install
4. Go back to "Preferences"
5. Go to "Keymap", select one of the VS Code keymap options, (either macOS or not) hit apply, and enjoy increased happiness in your IDE

Running TE without the IDE

If you just need to execute LX to run a show without editing anything, you can do that:

0. Install Temurin JDK

Either go to https://adoptium.net/installation/ or, on a Mac with Homebrew, brew install temurin17

(If you'll be using an IDE, it'll do this for you; skip to the Editing section.)

1. Build into a runnable JAR:

   mvn clean package  # Packaging creates the JAR and cleaning is optional

2. Execute the JAR (Note that the version number may be different — The version as of this document revision is 0.2.0-SNAPSHOT — substitute the correct version as necessary):

   java -jar target/LXStudio-TE-0.2.0-SNAPSHOT-jar-with-dependencies.jar vehicle Vehicle.lxp

3. If the Temurin JDK isn't your default Java, then you can use the full path, for example:

   /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java -jar target/LXStudio-TE-0.2.0-SNAPSHOT-jar-with-dependencies.jar vehicle Vehicle.lxp

4. Use Maven to execute the program instead of the java command:

   mvn clean compile  # Cleaning and compiling is optional, depending on your needs
   mvn exec:java@Main -Dexec.args="vehicle Vehicle.lxp"

   Fun fact: The "Main" target isn't defined in the POM to have arguments, but it could, in which case you wouldn't need the vehicle Vehicle.lxp args.

Potential issues

If your ~/.m2 Maven cache has any conflicting things, you may need to delete the conflicts, otherwise the execution may complain about things like missing libraries or invalid versions, and the like. Finding the conflicts is a more advanced approach. A simple one is to just delete that whole directory:

rm -r ~/.m2

Eclipse

If Eclipse is like a warm snuggie to you, we'd appreciate you adding any SDK and environment configuration tips here.

---

License Note

Please see LICENSE.md - significant parts of this repository are not open source and we support those authors' wishes.