> For the complete documentation index, see [llms.txt](https://docs.verge.aero/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.aero/drone-show-software/verge-design-studio/show-effects/converting-scene-objects-into-show-effects.md).

# Converting Scene Objects into Show Effects

### How To

It is incredibly easy to take immediate advantage of the show effect system added in 2024.1. Any existing effect can be converted to a show effect with a couple of clicks.

1. Select the top level object that you wish to convert into an show effect
2. In the button panel above the object hierarchy, click on the icon showing the show effect symbol with an arrow pointing downward.
3. The entire hierarchy under the target object will now be condensed into a single show effect. This effect can be published, shared, and transported as normal

<figure><img src="/files/w4l3c4L1GboEoZAdR7W7" alt=""><figcaption><p>Select the top level object that you wish to convert into an show effect and click the convert button</p></figcaption></figure>

<figure><img src="/files/l3neXfSrC7uW9fvuICZ3" alt=""><figcaption><p>The entire hierarchy under the target object will now be condensed into a single show effect. This effect can be published, shared, and transported as normal</p></figcaption></figure>

### Additional Notes

By default, the resulting show effect will have a single sequence, and a single slotting source

* The resulting effect will automatically choose the top-level object as the slotting source. When converting a complex object, it is most convenient to make your top-level object a formation group or formation sequence.
* All animations and events contained in the show effect hierarchy will be collapsed into “Sequence 0”. The sequence will automatically be scaled to the exact time length of the contained events. The collapsed events will also automatically be shifted so that the sequence starts at 0 seconds.

<figure><img src="/files/YlxBIssGk9gi1U7Af2zK" alt=""><figcaption><p>A screenshot of the timeline after converting a scene object into a show effect</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.aero/drone-show-software/verge-design-studio/show-effects/converting-scene-objects-into-show-effects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.