Add Unity Pipeline package support

2026-07-31 17:34:04 +08:00
parent d1a526094e
commit 786b7ffff9
590 changed files with 51995 additions and 2 deletions
@@ -0,0 +1,58 @@
+# Capture commands
+
+Commands that render a camera, the Scene View, or a UI Toolkit element to a PNG and return it base64-encoded so an agent can "see" the editor (or a running player) without a display.
+
+### `capture_game_view`
+Render a camera to a PNG. Returns it inline as base64, unless `save_path` is set — then the result is **path-only** (no base64) so agent tool results stay small; pass `include_inline_image=true` to get both.
+
+Parameter interactions: `include_inline_image` is only meaningful together with `save_path` (without one, the inline image is always returned). `max_resolution` only applies when an inline image is actually returned — i.e. no `save_path`, or `save_path` + `include_inline_image=true`; it has **no effect** when `save_path` is set without `include_inline_image=true`.
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `width` | no | `1280` | Output width in px (default 1280; capped 4096). |
+| `height` | no | `720` | Output height in px (default 720; capped 4096). |
+| `camera` | no | `–` | Optional camera name; defaults to Camera.main, else the first enabled camera. |
+| `save_path` | no | `–` | Optional project-relative path to write the PNG (e.g. Screenshots/foo.png). When set, the result omits the inline base64 image unless `include_inline_image=true`. |
+| `include_inline_image` | no | `false` | Also return the image inline as base64 when `save_path` is set. |
+| `max_resolution` | no | `0` | Cap on the inline image's longest edge (e.g. 512), preserving aspect ratio. No effect when `save_path` is set without `include_inline_image=true`. The `save_path` file keeps the requested resolution; a downscaled inline copy is reported via `inlineWidth`/`inlineHeight`. |
+
+**Returns:** `CaptureResult`
+
+### `capture_scene_view`
+Render the active Scene View to a PNG. Same result contract and parameter interactions as `capture_game_view`: inline base64, or path-only when `save_path` is set (opt back in with `include_inline_image=true`; `max_resolution` has no effect when `save_path` is set without it).
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `width` | no | `1280` | Output width in px (default 1280; capped 4096). |
+| `height` | no | `720` | Output height in px (default 720; capped 4096). |
+| `save_path` | no | `–` | Optional project-relative path to write the PNG (e.g. Screenshots/foo.png). When set, the result omits the inline base64 image unless `include_inline_image=true`. |
+| `include_inline_image` | no | `false` | Also return the image inline as base64 when `save_path` is set. |
+| `max_resolution` | no | `0` | Cap on the inline image's longest edge (e.g. 512), preserving aspect ratio. No effect when `save_path` is set without `include_inline_image=true`. The `save_path` file keeps the requested resolution; a downscaled inline copy is reported via `inlineWidth`/`inlineHeight`. |
+
+**Returns:** `CaptureResult`
+
+### `capture_editor_element`
+Capture a UI Toolkit VisualElement (by selector) from an EditorWindow to a PNG; returns path + base64.
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `window` | yes | `–` | EditorWindow type name (e.g. InspectorWindow) or window title to capture from. |
+| `selector` | yes | `–` | Element selector: '#name', '.class', a type name (e.g. Button), descendant (space) / child ('>') chains, optional pseudo-states (:checked,:hover,:focus,:active,:enabled,:disabled,:not(...)). |
+| `output` | no | `–` | Output PNG path (absolute, or relative to the project root). Defaults to a timestamped file under <project>/Temp/pipeline-screenshots/. |
+
+**Returns:** `CaptureElementResponse`
+**Notes:** `MainThreadRequired = true`. Unity 6000.7+ only.
+
+### `capture_runtime_element`
+Capture a UI Toolkit VisualElement (by selector) from a live runtime panel (UIDocument or PanelRenderer) to a PNG; returns path + base64.
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `panel` | no | `–` | Name of the target panel: matches the PanelSettings asset name or the host GameObject name (UIDocument or PanelRenderer). Optional when exactly one panel exists. |
+| `selector` | yes | `–` | Element selector: '#name', '.class', a type name (e.g. Button), descendant (space) / child ('>') chains, optional pseudo-states (:checked,:hover,:focus,:active,:enabled,:disabled,:not(...)). |
+| `output` | no | `–` | Output PNG path (absolute, or relative to Application.persistentDataPath). Defaults to a timestamped file under Application.persistentDataPath. |
+
+**Returns:** `CaptureElementResponse`
+**Notes:** `MainThreadRequired = true`, `RuntimeOnly`. Unity 6000.7+ only.
+
+See [Creating commands](../creating-commands.md) and [Connectivity](../connectivity.md).