Skip to content

Commit

Permalink
doc: added basic description about yaw control
Browse files Browse the repository at this point in the history
  • Loading branch information
vasarhelyi committed Nov 12, 2023
1 parent f83f6b4 commit 5ff5f79
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 0 deletions.
9 changes: 9 additions & 0 deletions doc/modules/ROOT/pages/concepts.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,15 @@ NOTE: While using the regular return to home, it is not guaranteed that each dro
*Skybrush Studio for Blender* also supports flawless light design for your drone light shows. In Blender we support a single RGB color to be mapped to each drone at each frame in the timeline by simple baked colors or by complex parametric light effects overlayed to the base color. The RGB color output from Blender will be transformed to the RGB or RGBW color of your led driver on your drones by the Skybrush backend and firmware. There are several smart tools dedicated in *Skybrush Studio for Blender* for light design, to see these options please checkout the description of the xref:panels/leds.adoc[LEDs tab].


== Yaw control

*Skybrush* also supports yaw control as part of a drone show for certain drone types. The yaw angle for yaw control in *Skyrush Studio for Blender* is simply inferred from the Z component of the global rotation of objects assuming "XYZ Euler" notation. So far there are no specific tools to aid yaw control, it is the responsibility of the designer to create a yaw curve that harmonizes with the concept and spatio-temporal trajectory of the show.

TIP: if you wish to use yaw control, change your default drone object template to something that is not as isotropic as the default icosphere, so that you can also visualize your rotations in Blender.

To export yaw control for your show, check the "Use yaw control" checkbox in the .skyc export panel.


== Useful Blender settings

We suggest you to check the following Blender settings before you start designing your drone show:
Expand Down
2 changes: 2 additions & 0 deletions doc/modules/ROOT/pages/panels/safety_and_export/export.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ Trajectory FPS:: Set output frame rate for drone trajectories (make sure it is a

Light FPS:: Set the output frame rate for light programs (make sure it is a submultiple of your render FPS)

Use yaw control:: Enable this checkbox to output yaw rotations of your drone objects into the .skyc file

== Export to .csv

The trajectories and LED light colors of the drones can also be sampled at regular intervals and exported to CSV files for further post-processing in external tools. This option appears only if you have installed and enabled the CSV export addon that is distributed separately. The CSV export will produce a single ZIP file that contains multiple CSV files, one for each drone, with the following columns: time (milliseconds), X, Y and Z coordinates (meters) and the red, green and blue components of the color of the LED light, in the usual 0-255 range.
Expand Down

0 comments on commit 5ff5f79

Please sign in to comment.