screenshot-scene
Render a Foundry VTT scene as a PNG for visual QA of imports and map layouts. Optionally overlay numbered markers on map-note pins to verify legend placement.
Instructions
Render a scene in the headless bridge and capture a PNG to a local file — visual QA for imports/maps. Views the scene, waits for the WebGL canvas to draw, fits the whole map into the viewport (or keeps the saved camera with fit:false), and optionally draws numbered markers over each map-note pin (mark:true) to check legend-pin placement (a view-only overlay, no document changes). Returns the file path + scene metadata; open/read that file to view the image. GM-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | Fit the whole scene into the viewport (default). false keeps the saved camera view. | |
| mark | No | Draw a transient numbered marker over each map-note pin (QA for legend-pin placement). No document changes — the overlay is view-only. | |
| outputPath | No | Absolute local path to write the PNG to. Default: a temp file (path returned). | |
| sceneIdentifier | Yes | Scene id or exact name to screenshot. |