Run structured diagnostics on a 3D canvas scene
validate_sceneAnalyze a 3D scene HTML file for rendering errors and scene graph issues including floating objects, missing lights, and camera clipping. Returns a structured report with severity and fix suggestions.
Instructions
Loads the scene HTML and returns a JSON report: page/console errors, blank-canvas and detail analysis of the rendered pixels, and — when window.__scene is registered (Three.js) — deep scene-graph checks: floating objects, missing lights, out-of-frustum meshes, NaN transforms, missing UVs/normals, camera clipping, texture problems. Each issue has a severity and a concrete fix suggestion. Fix errors first, then warnings. Call this after render_scene whenever something looks wrong, and at least once before declaring the scene done.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Absolute path to a self-contained .html file that renders a 3D scene into a <canvas> | |
| include_screenshot | No | Also return the current-frame screenshot | |
| width | No | Viewport width in px | |
| height | No | Viewport height in px | |
| settle_frames | No | requestAnimationFrame frames to wait after load before capturing | |
| extra_wait_ms | No | Extra fixed wait after settling, for slow async scenes | |
| timeout_ms | No | Hard cap for the whole operation |