# editor.capture

> Talos next · Since next

A PNG of the viewport (the game while playing), to a file, shown unless image is false.

view, mode, overlays (view.viewport.show's names), camera: draw the authoring view so once; the person's view is kept.

| | |
|---|---|
| Title | Capture the viewport |
| Mode | `editor` |
| Token cost | about 173 tokens (listed only when its toolset is enabled) |
| Toolset | `editor` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `camera` | `object` | no |  |  |  |
| `image` | `boolean` | no |  |  | `false` leaves the picture out of the answer. |
| `mode` | `enum` | no |  | `lit`, `unlit`, `wireframe`, `normals`, `roughness`, `metallic`, `occlusion`, `depth`, `emissive`, `motion` |  |
| `out` | `string` | no |  |  | PNG path; a temporary file when absent |
| `overlays` | `any[]` | no |  |  |  |
| `view` | `enum` | no |  | `persp`, `top`, `front`, `side` |  |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "editor.capture",
  "arguments": {}
}
```
