Lsim - Lighting Simulation software

Created by bodgedbutworks

Feel free to contribute - Thanks for contributing!

Overview

---

Technological Purpose

Simulation of lighting equipment (conventional and LED fixtures, moving lights, pixel matrices) controlled by ArtNet input

Educational Purpose

Submission for lecture "Effizient Programmieren I+II", attempts were made to pursue a clean code style

Software Design Guidelines (Things you should stick to while coding)

• Code style in compliance with Processing 3.5.4 Autoformat
• Naming convention:
  • Classes: First letter Caps ("Vehicles")
  • Acronyms: First letter Caps ("Madrid")
  • Functions and variables: camelCase ("showProperties")
  • Function parameters:
    • In: "iXxxx"
    • Out: "oXxxx"
• Documentation via descriptive variable names, comments in code and Doxygen-specific comments
• Version control via Git (duh)

Mid-Term goals

---

• (ToDo) Add ArtNet output for real-world fixture control via Lsim
• (ToDo) Add camera inputs and 2D->3D coordinate mapping
• (ToDo) Add Kinect input

Usage

---

Option A: Download executable for you system here

Note for mac users:
If you download the prebuilt releases, they are considered suspicious and receive a quarantine flag. This results in errors such as The application is corrupted and should be removed and the application not starting. This can be prevented by either installing Processing 3 yourself and running the program from source OR by removing the quarantine flag from the app. To remove the flag open a terminal window and execute the following command

 sudo xattr -d -r com.apple.quarantine <path_to_your_Blaize_V3.app>

Option B: Build from source code yourself using Processing 3

• Download Processing 3 from https://processing.org/download/
• Open Processing IDE, go to Tools->Add Tool->Libraries Tab and install UDP library by Stephane Cousot
• Download the latest Lsim release (Source Code) from here
• Open Lsim.pde from src/Lsim/ and click Run button in the IDE
• If you experience problems, check if your Java Runtime Environment version is 8. Newer versions might work, but haven't yet been tested.
• Starting Lsim before opening your lighting control software is usually a good idea.
• If it still doesn't work as expected, please report the issue here or via E-Mail to lsim@aerotrax.de

Key bindings

• DELETE: Clear spin box
• BACKSPACE: Delete rightmost spin box digit
• '-', '0'-'9', '.': Change spin box value
• ENTER: Apply value

Mouse control

• Mousewheel (menu): Increment/Decrement box values
• CONTROL + Mousewheel: Incrementation speed x10
• SHIFT + Mousewheel: Incrementation speed x100
• Mousewheel (3D space): Zoom in/out
• Hold right mouse button: Orbit around point of interest
• Hold middle mouse button: Move point of interest

General

• Scale is 1cm/px
• Backups are automatically created in save/autobackups/ upon program start, so if you (or a bug) messed something up, check for older versions there

Environment models generation

• CAD (e.g. CATIA): Model should roughly be centered around the vertical axis
• Tesselate CAD model with 0.5 Millimeters allowed deviation
• Converter (e.g. Cinema4D): Import .stl with scale 1 Millimeter
• Export as .obj with scale 10 Millimeters and inverted Y-axis
• Place file in data/ subdirectory of sketch, name starting with "env_"

Code Documentation

---

Available here (Download Documentation.zip, open Documentation/doc/html/index.html with your browser)