> For the complete documentation index, see [llms.txt](https://docs.eclipsaapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eclipsaapp.com/eclipsa-audio-element-plugin-simple-3d-audio-panning.md).

# Eclipsa Audio Element Plugin: Simple 3D Audio Panning

Learn how to use Simple 3D Audio Panning in the Eclipsa Audio Element Plugin to position mono audio tracks in 3D space with intuitive X, Y, Z controls.

## Simple 3D Audio Panning

The Eclipsa Audio Element Plugin provides a 3D Audio Panning feature which allows for simplistic audio panning. This feature is meant to help those who are looking for a simplified panning experience or are unfamiliar with the panning tools offered by the DAW.

***

<mark style="color:yellow;">**Note:**</mark> Simple 3D Audio Panning pans a single mono track to the selected audio element's speaker layout. If a track has more than one channel, only the first channel is panned, typically the Left speaker.

***

### **How to Use the 3D Audio Panning**

**1. Add the Eclipsa Audio Element Plugin to the track you wish to pan**

* Open your session and select the audio track to be panned.
* Insert and configure the Eclipsa Audio Element plugin as detailed in [Eclipsa Audio Element Plugin Features](https://docs.eclipsaapp.com/eclipsa-audio-element-plugin-features-routing-and-monitoring-eclipsa-audio.md#setting-up-the-eclipsa-audio-element-plugin)

**2. Enable the panning controls and configure panned audio**

* Enable the panning controls by clicking the "Panning Controls" toggle in the top right corner
  * Once the panning controls are active, a control panel will be displayed with options to adjust the X (left-right), Y (front-back), and Z (up-down) coordinates of your sound element in 3D space.
* Ensure the correct audio is being panned:
  * The Simple 3D Audio Panning only takes audio from the first channel on a track. On non-mono tracks, this is typically the Left speaker.
  * If this is not the audio you wish to pan, use an external down-mixer, external panner, or routing controls to ensure the correct audio is on the first channel of the track

<figure><img src="https://2064516701-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FISImAXhuTi4GI5slDrH1%2Fuploads%2Fz16HiURK6x5swDoW7Sph%2FEnablePanning_Gif.gif?alt=media&amp;token=11a30d03-1c39-4e4c-b138-e5e53ee788bb" alt=""><figcaption></figcaption></figure>

**2. Adjust the X, Y, and Z Coordinates:**

* The Audio Element Plugin interface provides a top down 3D view showing where your audio source is located. By default, audio is placed at (0,0,0)
* A blue dot indicates where in 3D space your track has been placed
* Height markers indicate the height of the audio source relative to the rooms walls
* Knobs indicate and allow you to specify the position of the audio source:
  * X Coordinate: Controls the left-right position of your sound object within the 3D space.
  * Y Coordinate: Adjusts the depth or front-back placement, bringing sounds closer or moving them farther away.
  * Z Coordinate: Alters the height of the sound object, allowing you to place it above or below the listener’s perspective.

<figure><img src="https://2064516701-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FISImAXhuTi4GI5slDrH1%2Fuploads%2FGI3DDWSbwRYE3cncbO6B%2FManualPanning_Gif.gif?alt=media&amp;token=f199a285-cf41-4106-a425-0e224179e00f" alt=""><figcaption><p>Eclipsa Audio Element Plugin with Panning Controls Enabled</p></figcaption></figure>

* Audio position can be adjusted by:
  * Dragging the audio source to the desired location
  * Clicking a specific speaker in the room to move the audio source to that speaker
  * Adjusting the position using the position knobs
  * Entering the desired coordinate in the position box
  * Nudging the audio source position using the arrow keys and, where supported, the scroll wheel

<figure><img src="https://2064516701-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FISImAXhuTi4GI5slDrH1%2Fuploads%2FzvCccR5nsQLcXMSCduQ9%2FPanningIllustration_Gif.gif?alt=media&amp;token=75aee70c-3093-45f2-a87b-6b97ee3aefce" alt=""><figcaption><p>There are many ways to adjust the audio source position</p></figcaption></figure>

* As you make adjustments, the audio sources position and track audio will update in real-time.

### Using the Roof Feature

The roof feature provides a way to automatically move sound objects vertically by attaching them to a roof, enhancing spatial realism for overhead sounds or rising/falling effects.

#### Enabling and Using the Roof Feature

* In the Audio Element Plugin interface, select a roof from the set located below the room view. Note that a variety of different roof shapes are provided (e.g., Tent, Dome, Curved, Flat).
* Once activated, the selected roof structure will appear in the 3D visualizer as shown below and the Z-coordinate dial will become disabled.
* Adjusting the X coordinate (left-right movement) and Y coordinate (front-back movement) will now also influence the Z coordinate in order to ensure the audio object follows the selected roof.
* As you move the object closer to the listener (increase Y) or farther away (decrease Y), the object will slide along the roof. The Z-value will automatically be computed to keep the panned object moving along the roof.
* The visualizer will display the height changes in real time, helping you better understand how the audio element moves both horizontally and vertically within the space.

<figure><img src="https://2064516701-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FISImAXhuTi4GI5slDrH1%2Fuploads%2FELwBeXrSjds98KdBNV0c%2FRoofPanning_Gif.gif?alt=media&amp;token=3a12015c-5d0f-47c0-9854-1fa2a936f799" alt=""><figcaption><p>Panning with the Dome Roof Enabled</p></figcaption></figure>

#### When to Use the Roof Feature

* Use this feature to precisely place sound elements or for sound elements that need dynamic vertical movement, such as overhead sounds or sound effects that rise or fall within the 3D environment.
* See [Automated Panning](https://docs.eclipsaapp.com/eclipsa-audio-renderer-plugin-features-configuring-monitoring-and-exporting-eclipsa-audio.md) to better understand how to move sound elements over time using the Eclipsa Audio Element plugin.

#### Disabling the Roof Feature

* If you do not need height adjustments, you can turn off the roof feature by toggling the feature off. The Z value will remain fixed unless manually adjusted.

### **Monitoring Playback and Loudness**

* The Eclipsa Audio Element Plugin provides speaker monitoring information showing the individual loudness of each speaker as well as loudness when played back to binaural headphones.
* Individual speakers can be soloed/muted as needed to better understand track playback.
* Loudness Standard information is also provided in the top right corner for determining the exact loudness of the panned track.
* Use this visual feedback to ensure that your sounds are the correct volume on the track.
* To more accurately understand how multiple tracks are placed in 3D, the Eclipsa Audio Renderer Plugin Room View can display the locations of all panned tracks by enabling the "Tracks" view

<figure><img src="https://2064516701-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FISImAXhuTi4GI5slDrH1%2Fuploads%2FzoR4gF5lAHa85ypVxaDs%2FScreenshot_RoomPlayback.png?alt=media&amp;token=50013574-f542-47d1-b479-eb7016abf028" alt=""><figcaption><p>Panned tracks are visible in the room view to help understand there relation to other panned tracks</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eclipsaapp.com/eclipsa-audio-element-plugin-simple-3d-audio-panning.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
