# Changelog

## v3.19.1 -> v3.19.2

***

### 🔧 Fixes

* convert the takeoff angle from radians to degrees
* update waiting time messages and thresholds in RTL cancellation, automatic RTL cancellation when waiting time is too long
* remove the bug that was suppressing anchors in mesh text
* handle connection errors when connecting to GCS

## v3.19.0 -> v3.19.1

***

### 🔧 Fixes

* fix an issue for the GCS export when using all-in-one platforms and line config

## v3.18.4 -> v3.19.0

***

### 🚀 New Features

**Help Mode**

* Added a dedicated help mode to assist users during show creation.

**Proximity Warning Lines**

* Visual warning lines to alert when drones are too close.

**3D Mesh & Animated Mesh Converter**

* Ability to convert 3D and animated meshes into drone formations.

**Direct Take Off Option**

* New option to launch drones directly without grid initialization, going directly to the first formation.

**Compass**

* Introduced a compass tool for better orientation while building shows.

**New color effects**

* Added a library of color effects.
* Updated UI for easier selection and customization.

**UI update**

* Enhanced main tabs with emojis and icons for improved visibility and navigation.

**Live color update**

* Optimized color update efficiency.
* Introduced a follow drone color option for synchronized visuals.
* Added drone connection controls.

**Speed Check Option**

* Added speed verification to ensure drones do not exceed safe speeds during takeoff and flight.

**Enable Glow Button**

* Added an Enable Glow button to simulate real-life drone brightness, providing a more accurate preview of how the show will appear in the night sky.

### 🔧 Fixes

* Updated LightShow Creator to work seamlessly with **Blender 4.4.**
* Ensured `scene.frame_end` updates correctly during manual takeoff.
* Resolved issue with missing imports causing errors.
* UI now properly reflects changes to selected color effects.
* Suppressed erroneous color tag messages when using magic color.
* Improved display of warnings for minimum distance violations in All-in-One Platform.
* Corrected issues with color keyframes not applying correctly during show import.
* RTL cancellation now properly stops calculations; added warnings when waiting time becomes excessive.
* Introduced a reset button to clear live color issues when opening new files.

### 🔄 Changes & Improvements

**RTL distance limitation**

* Reduced minimum distance 1.5m -> 1m for RTL

**Update frame end after a 'go to target'**

* Adjusted frame end logic in `transition.py` for smoother animations.

**Anchors creation warning**

* Displayed warnings when trying to add too many anchors at once.

**Take off checks improvement**

* Refined takeoff verification process.

**Family grid defaults**

* Set family grids with 2m spacing between layers and updated default takeoff altitude for better usability.

**Auto take off adjustments**

* Aligned auto takeoff grid behavior with angled takeoff options.
* Ensured `frame_end` updates correctly when using auto takeoff.

## v3.16.2 -> v3.18.4

***

### 🚀 New Features

#### **New Takeoff Mode: "All in One Platform"**

* Introduced a new takeoff mode for **IOStar3**.

#### **Mesh Image & Mesh Text Enhancements**

* Easily create **2D drone formations** using:
  * **Images** → Convert any image into a drone shape.
  * **Fonts & Text** → Generate formations based on text.

#### **Auto Takeoff Button**

* Automatically generates a **grid** and launches all drones.
* Ensures proper **speed & security distance** in a single click.

#### **Safe Delete Protection**

* Prevents accidental drone deletions when pressing `X` or `DEL`.
* Drones can still be removed via **right-click** or the **collection tab**.

### 🔄 Changes & Improvements

#### **Return to Launch (RTL) Algorithm Update**

* Improved drone behavior for smoother landings.

#### **Initialization Parameter Lock**

* Parameters can no longer be modified **after show initialization**.

#### **RTL Behavior Enhancements**

* Further refinements for drone movements and positioning.

#### **Blender Compatibility**

* LightShow Creator  is now working with the latest Blender version. (4.3.2 LTS)

#### **Update Brightness Factor**

* Replace factor multiplication with a percentage for better understanding.

## v3.15.0 -> v3.16.2

### New

* Apply brightness Factor
  * The 'Apply brightness factor' can modify the brightness of selected drones using a multiplying factor.
  * Current drone individual brightness will be multiplied by the given factor (increasing brightness if factor > 1, reduce it if factor < 1)

{% embed url="<https://youtu.be/M6w0JNWeabI>" %}

### Changes

* Fix bug where drones were moving after landing
* Reset RTL start frame when landing to avoid increasing frame
* Fix duplicated points in family grids
* Remove RTL correction when checking takeoff
* Switch off the LEDs during the land and not during the RTL sorting
* Fix export bug occuring after Drone Grid removal

## v3.11.0 -> v3.15.0

{% hint style="success" %}
The Lightshow Creator is now compatible with Blender 4.x versions
{% endhint %}

{% hint style="warning" %}
The Lightshow Creator minimal supported version is now Blender 3.6
{% endhint %}

### New

* Automatic RTL
  * The automatic RTL replaces all drones on their original takeoff positions
  * The RTL time can vary depending on the parameters used and the number of crossing trajectories.

{% embed url="<https://youtu.be/Vy-2xIyX-Ic>" %}
Automatic RTL
{% endembed %}

* Add Family Grids
  * You can now create the family grids automatically.
  * It can be use to easily land the drones by using a normal **Go to target**.

{% embed url="<https://youtu.be/iolPlTwQGPk>" %}
Family Grids
{% endembed %}

* Color effect
  * You can now control colors with Geometry Nodes
  * This is similar to Magic color but much more flexible

{% embed url="<https://youtu.be/uQKEZrzpNLE>" %}

* Live color (Beta)
  * With the GCS Beta version 2.7.0, you can control drone color from Blender (currently limited to 3 color channels).

<figure><img src="https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/14LaIX9AiIuZDREhx1dl/image.png" alt=""><figcaption><p>Live color</p></figcaption></figure>

### Changes

* Fix VVIZ support for FWsim
* Fix magic color LED registering to match the preview.

## v3.5.3 -> v3.11.0

### New

* VVIZ export to add pyrotechnic effects to your show with [FWsim](https://www.fwsim.com/) or [Finale 3D](https://finale3d.com/documentation/importing-drone-shows/)
* **Experimental** - Add option to RTL at the end of shows
* Add option to scale the show to increase the maximum range  up to 4x
* **Experimental** - Add follow path

### Changes

* Drop retro-compatibility with .blend files created with version 3.5.2 and lower
  * You can use version 3.5.3 to convert your old files
* Improve `Go to target` workflow
  * New transition algorithm proved collision-free if minimum distance between anchors is respected
  * Add the number of selected drones and targets below `Go to target`\
    ![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/ErONuSUqnealj3VJgOKM/go_to_target_nb_drones_targets_same.png)![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/SRMB9ZibSEbSup8JNFbY/go_to_target_nb_drones_targets_different.png)![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/xom2Qcr2YyysEBMzmlT7/go_to_target_nb_drones_targets_0.png)
* Improve `Add anchors` workflow
  * Do not resize automatically the mesh or Bézier curves after adding anchors
  * The minimal distance between anchors does not limit scaling the object
  * Warn if the minimal distance between anchors will or could cause a collision during transitions
  * Automatically merge double vertices on mesh when adding anchors

{% embed url="<https://youtu.be/GRm99tHRNgU>" %}

* Initialize by default the timeline in seconds instead of frames
* Rename `Set interpolation` by `Change interpolation`
* Set alpha to 0 by default for added emission material
* Minimal supported Python version is now 3.10 (previously 3.8).
* Improve check error messages to include total of infractions and the number of drones concerned

## v3.5.2 -> v3.5.3

### Fix

* Use the selected keyframe type for `Go to target`s
* Fix [#set-the-minimum-distance-between-anchors](https://drotek.gitbook.io/lsc2/show-creation/formation/mesh#set-the-minimum-distance-between-anchors "mention") errors in the console

### Performance

* Rework `RGBW Emission` material to avoid FPS performance regression in some case.\
  Remove White visualization in `Material Preview`.

## v3.5.1 -> v3.5.2

### New

* The automatic creation of markers can be enabled or disabled for each type of action.\
  **Before**\
  ![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/AstGUATsBIOj7HUXGRZo/marker_settings_before.png)\
  **After**\
  ![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/8LH72E6ARnAAQx2s5GK3/marker_settings_after.png)

### Fix

* `Register LED` is improved for linear and bezier interpolation.\
  **Before** (Linear / Bezier)\
  ![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/zLkjuFz9GN8YCwQKcq2A/register_led_fix_frame_rate_before.png)![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/cM4uWH9Ek8PLAvIJAimx/register_led_fix_frame_rate_bezier_before.png)\
  **After** (Linear / Bezier)\
  ![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/yDb8s69WbipOXtbDr2Xk/register_led_fix_frame_rate_after.png)![](https://content.gitbook.com/content/7kFPTfd9Bef94qNlcfqD/blobs/bYYVNPmsokAI2M1k2vDD/register_led_fix_frame_rate_bezier_after.png)

### Performance

* [#set-the-minimum-distance-between-anchors](https://drotek.gitbook.io/lsc2/show-creation/formation/mesh#set-the-minimum-distance-between-anchors "mention") is 384x faster. Blender was slowing down with objects with many anchors.

## v3.2.2 -> v3.5.1

{% hint style="info" %}
It is highly recommended to read again the documentation to not miss new information.
{% endhint %}

### New

#### General

* All **buttons** and **properties** are documented in Blender inside tooltips.
* Add **units** to **properties**.
* The panels are reorganized and have the same arborescence as this documentation.
* Hide/Show options automatically depending on the context.
* Blender 3.6 should be preferred
* Markers are added automatically for batched actions like (Takeoff, Land, Go to target, …)

#### Performance

* Progress bars have been added in the system console to follow the progression of long tasks
* The collision check is much faster
* The export is also faster
* Increase FPS when playing the show

#### JSON show file

* Change the binary format
  * The binary format is now more compact
  * The exported color events can now either be a constant or a linear interpolation.
* Change name convention
  * `.json` is automatically added to the filename during export, no need to add it manually
  * The date and time are added automatically to the exported file
* Add metadata to the generated files
  * The Blender version
  * The Lightshow Creator and Loader version
  * The physical parameters (minimal distance, and maximum speed profile)
* The JSON show range file generated with `Import & Export range` are different from JSON show file and can only be used in Blender with `Import range`.

#### Conversion

* Old shows generated with previous versions can be converted to this new version.
* The converted show should be checked (show parameters, import back after exporting the converted show, …)

#### [initialize-the-show](https://drotek.gitbook.io/lsc2/show-creation/initialize-the-show "mention")

* Drone repartition
  * Improve the mechanism to choose the placement of drones
  * Add an interactive visualization of the placement of the drones
  * Drone are now placed next to each other in the same family
* `Purge scene` has been removed
* `Prepare the scene` has been added to set up the show on a new file
* Add keyframe type selection for the different keyframes (Takeoff, Land, Go to target, Set color, Magic color, Fire)

#### [takeoff-and-land](https://drotek.gitbook.io/lsc2/show-creation/takeoff-and-land "mention")

* Integrate `Angle takeoff` in `Initialize show`

#### [formation](https://drotek.gitbook.io/lsc2/show-creation/formation "mention")

* [mesh](https://drotek.gitbook.io/lsc2/show-creation/formation/mesh "mention")
  * Remove `Scale mesh` by making `Min distance` interactive
* [transition](https://drotek.gitbook.io/lsc2/show-creation/formation/transition "mention")
  * Add **staggered transitions**
  * Add **swap tools** to fix collisions
  * Replace the checkboxes with named switches
  * Cannot use `Go to target` before taking off

#### [color](https://drotek.gitbook.io/lsc2/show-creation/color "mention")

* Materials
  * Use only one material instead of two (increase FPS)
  * Change drones and effectors materials to visualize the white channel
* [set-color](https://drotek.gitbook.io/lsc2/show-creation/color/set-color "mention")
  * Add `Bezier` interpolation
  * Add `Set interpolation`
  * Add `Pick color`
  * Add `Swap color`
  * Add `Remove white`
* [magic-color](https://drotek.gitbook.io/lsc2/show-creation/color/magic-color "mention")
  * Apply effectors only on visible drones (hidden drones will be ignored)
  * Add `Interpolation` between registered keyframes
  * `Update effector` is applied immediately (no need to change the frame)
* [color-settings](https://drotek.gitbook.io/lsc2/show-creation/color/color-settings "mention")
  * Add `Emission strength`
  * Add `RGB / White ratio`
  * Add support for `Solid` shader viewing mode

#### [check](https://drotek.gitbook.io/lsc2/show-creation/check "mention")

* Use recommended show parameters by default (minimal distance and speed profile settings)
* Add `Min distance` for the collision check
* Add `Check takeoff`
* Add `Check autopilot format`
* Failed checks will select the faulty drones and move to the first infraction frame if applicable

#### [import-and-export](https://drotek.gitbook.io/lsc2/show-creation/import-and-export "mention")

* Export
  * Make `Export angle` interactive
  * If all checks pass the export should be successful
  * Fix increasing infraction errors during the export
* Import
  * Can only use `Import` from a new file
  * If the export is successful the import should not produce errors

#### [import-and-export-range](https://drotek.gitbook.io/lsc2/show-creation/import-and-export/import-and-export-range "mention")

* Can export part of a show to reuse in other show
