> For the complete documentation index, see [llms.txt](https://animoia.gitbook.io/animoia-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://animoia.gitbook.io/animoia-docs/guide/composition-viewer.md).

# Composition viewer

## Zoom, pan, and preview quality

Choose Fit or a percentage from the viewer footer. Choosing any zoom recenters the composition. Pan with Hand, middle drag, or Space-drag. `Ctrl` + wheel zooms instead of scrolling the panel.

Preview quality offers Full, Half, Third, and Quarter. It affects interactive preview, not full-resolution snapshots or final rendering. Adaptive resolution may temporarily drop lower during slow drags/scrubs and returns when interaction stops.

## Rulers, guides, and overlays

Toggle rulers from the footer or View shortcut. Drag from the top ruler for a horizontal guide or left ruler for a vertical guide. Drag the ruler origin to move it; double-click to reset. Lock guides to prevent edits. The eraser clears all guides and resets the composition overlay to None.

The overlay menu offers None, Grid, Action Safe, Title Safe, Rule of Thirds, Golden Ratio, Golden Spiral, Diagonal Method, and Crosshair. These helpers never render or export.

## Motion paths and box controls

**Show Motion Paths** displays selected position animation and editable spatial tangents. **Show Box Controls** shows layer bounds, resize handles, and anchor. Viewer overlays disappear during playback; gradient editing keeps only its own control visible.

## Save Frame

Choose **Save Frame As PNG** from the viewer menu or camera button. Animoia renders the current frame at full composition resolution and saves PNG. It uses the preferred snapshot directory when available, otherwise it asks you where to save the file.

Files are named `<composition>_<frame>.png` — frame 42 of "Comp 1" becomes `Comp 1_42.png`. The frame number is not zero-padded, and frame 0 is kept as `0`.

Saving never overwrites an existing snapshot. If the name is taken, Animoia appends a counter and keeps incrementing it, so clicking Save Frame four times on the same frame yields `Comp 1_42.png`, `Comp 1_42 (2).png`, `Comp 1_42 (3).png`, and `Comp 1_42 (4).png`. Gaps are filled rather than skipped: with `Comp 1_42.png` and `Comp 1_42 (3).png` already present, the next save takes `Comp 1_42 (2).png`.


---

# 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://animoia.gitbook.io/animoia-docs/guide/composition-viewer.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.
