Render frame
ae_render_frameRender a single After Effects frame to PNG to visually verify edits, with deterministic headless capture and viewer-accurate color handling.
Instructions
Render a single frame to PNG. Use to visually verify edits. The agent's 'eyes' — pair with mutations for a visual feedback loop. Headless and deterministic. In color-managed projects (workingSpace != None) the capture applies AE's own display transform via a transient OCIO Display Transform adjustment layer, and the PNG comes back viewer-accurate and sRGB-tagged. Where that layer cannot be used — read-only mode, an AE without the OCIO effect, or a failed capture calibration — the result falls back to a pure-math ACES conversion or to raw values with an explicit colorWarning; check colorPipeline / colorWarning on the response.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"compNameOrId": "<compNameOrId>",
"time": "<time>",
"outPath": "<outPath>"
},
"name": "ae_render_frame"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | Yes | Time in seconds to render. | |
| outPath | Yes | Absolute path to write the PNG. Parent directory is created if missing. | |
| colorManaged | No | 'auto' (default): detect the working space and return a viewer-accurate, 8-bit sRGB-tagged PNG. 'off': raw legacy output (16-bit, untagged, working-space values — dark/wrong-looking in color-managed projects). | |
| compNameOrId | Yes | Composition name or numeric item id. | |
| useDisplayStartTime | No | If true, `time` is interpreted relative to comp.displayStartTime. Default false. |