compare_silhouette_alignment
Compares a rendered 3D model silhouette against a reference image or cropped reference-sheet region at a chosen view, reporting pixel-level alignment metrics like IoU, Dice, and divergence.
Instructions
Compare a rendered 3D model silhouette against a reference image (or cropped reference-sheet region) from a specified orthographic or camera view (FRONT, SIDE, TOP, PERSPECTIVE). Produces measurable pixel-level alignment evidence: dimensions, foreground masks, intersection, union, IoU (Intersection-over-Union), Sørensen-Dice coefficient, and divergence score.
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": {
"reference_image_path": "<reference_image_path>"
},
"name": "compare_silhouette_alignment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Capture pipeline: 'CAMERA' (default, rendered frames) or 'VIEWPORT' (interactive window). Headless requires CAMERA. | CAMERA |
| view | No | Camera/orthographic viewpoint to capture and evaluate. | FRONT |
| width | No | Evaluation image width in pixels. | |
| height | No | Evaluation image height in pixels. | |
| crop_box | No | Optional normalized crop bounds [u_min, v_min, u_max, v_max] in [0.0, 1.0] for reference sheet regions. | |
| camera_name | No | Optional name of scene camera to use. If not specified, uses active scene camera. | |
| mask_threshold | No | Sensitivity threshold for foreground silhouette detection (0.0 to 1.0). | |
| diff_output_path | No | Optional file path to save a color-coded visual difference mask (green=overlap, red=excess, blue=missed). | |
| coordinate_system | No | Coordinate convention for crop_box: 'UV' (default, [0,0] bottom-left) or 'IMAGE_SPACE' ([0,0] top-left). | UV |
| rendered_image_path | No | Optional filesystem path to a pre-rendered model image. When provided, skips in-engine render capture. | |
| reference_image_path | Yes | Filesystem path to the reference image file. | |
| reference_background_color | No | Optional background color [R, G, B, (A)] of the reference image. If omitted, sampled from image corner. |