> For the complete documentation index, see [llms.txt](https://help.atlas-control.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.atlas-control.app/main-overview/atlas-button/cue-matrix.md).

# Cue Matrix

<figure><img src="/files/uLw7KSptkavUYg4M37Jj" alt=""><figcaption><p>Atlas Key - Cue-matrix showing pop up editor for object. </p></figcaption></figure>

{% hint style="danger" %}
The Cue-Matrix view requires Mac OS 13.0 or above.&#x20;
{% endhint %}

***

### Functions Associated with the Cue-Matrix

#### Add Object(s)

Clicking on the + button in the objects column will allow for object actions to be assigned within a given cue.&#x20;

#### Editing an Object

Clicking on a given object will bring up the cue-matrix editor for the selected object. Most functions found within the respective modules [Object Properties Inspector](/main-overview/programmer/object-properties-inspector.md) can be edited from here.&#x20;

{% hint style="warning" %}
Changes made within the cue-matrix are made in realtime to the cuelist and may affect playback. Edits can be made during the performance to modify upcoming cues and their behaviour as well as updates made in previously executed cues.&#x20;
{% endhint %}

#### Add External Device Trigger(s)

Clicking on the + button in the external triggers column will allow for external triggers to be assigned.&#x20;

{% hint style="info" %}
Using the ESC key will close the window without any action being applied.&#x20;
{% endhint %}

***

<figure><img src="/files/3cAnNZQPToMOBl76xOdL" alt=""><figcaption><p>Atlas Key - Cue-Matrix showing incremental addition of external trigger cues</p></figcaption></figure>

{% hint style="success" %}
By selecting multiple cues the in the cue-matrix it is possible to assign external triggers across a range of cues attributing a custom start number and custom incrementation.&#x20;
{% endhint %}

***

#### Headers Visible within the Cue-Matrix

#### No.&#x20;

Displays the cue number.&#x20;

#### Timecode

Displays the timecode trigger time.&#x20;

#### Cue Name

Displays the name of the cue.&#x20;

#### Objects

Shows the objects and actions assigned within the selected cue.&#x20;

#### External Triggers

Shows the external triggers associated with the selected cue.&#x20;


---

# 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://help.atlas-control.app/main-overview/atlas-button/cue-matrix.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.