> For the complete documentation index, see [llms.txt](https://docs.openbrush.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openbrush.app/user-guide/exporting-videos/camera-tool-gifs-snapshots-video.md).

# Camera tool (GIFs, snapshots, video)

Auto-GIF, 5-second GIF, conventional, 360° and depth snapshots, and handheld video capture.

Open Brush has a handheld camera tool for quick captures. You use it for GIFs, conventional or 360° snapshots, depth captures, and (on PC VR) video.

### Where captures are saved

Snapshots and depth captures are saved to:

* `Documents/Open Brush/Snapshots`

Videos and GIFs are saved to:

* `Documents/Open Brush/Videos`

### Beginner mode

In Beginner mode, the camera icon is a single-function tool. It opens camera controls on your brush controller.

The options are:

1. Auto-Gif
2. 5 Second Gif
3. Snapshot
4. 360 Snapshot
5. Depth
6. Video (not present on every platform)

You control the camera like a handheld device.

* Swipe left/right on the thumbpad to switch modes.
* Pull the trigger to capture.

#### 5 Second Gif

Hold the trigger for five seconds. You can release and pull again to stop/start on the same 5-second timeline.

#### Video

Pull the trigger to start. Pull again to stop.

This is true handheld capture. You control camera direction, speed, and orientation.

#### 360 Snapshot

Pull the trigger to create a stereoscopic 360° ODS image from the camera's position. The output is a square PNG with `_360` in its filename and uses the configured `SnapshotWidth`. Capturing takes longer than a conventional snapshot; keep the camera and scene still until it completes.

#### Depth

Pull the trigger to save a colour image and several depth sidecar files with the same base filename:

| Suffix         | Contents                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------- |
| `_depth.png`   | Viewable normalized depth; nearer pixels are lighter.                                          |
| `_depth16.png` | 16-bit linear depth suitable for image-processing tools.                                       |
| `_depth.exr`   | 32-bit floating-point linear depth in metres.                                                  |
| `_depth.json`  | Dimensions, clipping planes, FOV and encoding information needed to interpret the depth files. |

Pixels where no geometry was rendered use the invalid value documented in the JSON metadata. Post-processing and the watermark are disabled for the depth data.

Depth captures are limited to 8,192 pixels on their largest side. If the configured snapshot dimensions are larger, Open Brush scales them down while preserving the aspect ratio.

### Automated colour, depth and normal capture

The HTTP API's `app.snapshot` command captures a colour image, depth sidecars and a `_normals.png` image from an explicit camera pose. See the [API Commands List](https://docs.openbrush.app/user-guide/exporting-videos/pages/-MikxGjASGo8wBuF5M2j#app.snapshot) for its parameters and an example.

### Advanced mode (Camera Options)

In Advanced mode, the camera icon has a sub-menu. You’ll see a small triangle in the corner.

Click and hold to open the sub-menu. Then choose **Camera Options**.

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-66d7f3d59f442895696f8a6115ca2579993b021a%2FCameras%20Icon%20in%20advanced%20mode%20with%20triangle.png?alt=media" alt=""><figcaption><p>The Cameras icon in Advanced mode has a sub-menu.</p></figcaption></figure>

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-5c7f52af8270007fc711d7b12fefcc41b42608e3%2FCamera%20Options.png?alt=media" alt=""><figcaption><p>Camera Options is inside the Cameras sub-menu.</p></figcaption></figure>

In **Camera Options**, you can:

* Toggle the Open Brush watermark.
* Adjust field of view (FOV) and smoothing.
* Toggle post effects.

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-93b3c6a56767d891b9aade4605c62ce88fc8cc9a%2FCamera%20Options%20tools.png?alt=media" alt=""><figcaption></figcaption></figure>

#### FOV examples

These examples show FOV set to 140, 70, and 10. The first image has the watermark enabled.

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-fe61e78e946fb595a45b1f7c4bd3dd83ea4af4d6%2FFOV%20140%20Watermark%20On.jpg?alt=media" alt=""><figcaption><p>FOV 140 (wide angle), watermark on</p></figcaption></figure>

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-4db1014f05260cd5a672d5d0d12315c85af98020%2FFOV%20140%20Watermark%20Off.jpg?alt=media" alt=""><figcaption><p>FOV 140, watermark off</p></figcaption></figure>

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-76e5d3fab42bf9386bd8bd3c89916e634f4c256d%2FFOV%2070.jpg?alt=media" alt=""><figcaption><p>FOV 70</p></figcaption></figure>

<figure><img src="https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-79e5a91132731b691ba8eb4cd12550ab7f356b3a%2FFOV%2010.jpg?alt=media" alt=""><figcaption><p>FOV 10</p></figcaption></figure>

### Demo video

This demo was recorded via the Spectator Camera.

{% embed url="<https://youtu.be/C1mUcv5fl9k?si=0mbO3RxIDmGgfzD8>" %}


---

# 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.openbrush.app/user-guide/exporting-videos/camera-tool-gifs-snapshots-video.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.
