> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RenderCanvas

> See a read-only PNG photo of a Macro canvas using the actual Canvas shape/text renderer.

# RenderCanvas

See a read-only PNG photo of a Macro canvas using the actual Canvas shape/text renderer. Returns a native image plus an immutable revision, source clock, world crop bounds and object IDs. Use for visual/layout understanding and to review edits. Optional item\_ids fit a selection; crop requests precise world bounds. No UI, cursors or ghosts are included. Referenced media not accessible to this scoped renderer is explicitly marked unavailable; this tool never fetches arbitrary URLs or expands reference permissions. Image pixels map linearly across crop bounds; use ReadCanvas for exact geometry.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `document_id` | string | Yes | Canvas document ID from the attachment or search. |
| `item_ids` | string\[] | No | Optional stable item selection used to fit the crop, at most 100. |
| `crop` | CanvasBounds | No | Optional world-space rectangle; overrides selection-derived bounds. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.