overlay_reference
Compare a 3D model with a reference photo by drawing both through a scene camera. Use blend, edges, difference, or split modes to check alignment and silhouette match.
Instructions
Draw the model and a reference picture on top of each other, seen through a scene camera: it shows how far
the camera and the model are from the photo. The model is rendered from camera (the scene camera when empty;
without one call set_camera or match_camera first) at the proportions of the reference; the long side is size
pixels. names is the model (everything visible when empty).
Modes: blend (the reference at alpha); edges (red reference outline, yellow reference inner edges, green model
outline over the dimmed model: best for small shifts); difference (black is a match); split (reference left of
a line at the split fraction of the width, model right: lines must continue across it).
The answer has the path, the silhouette IoU and the picture. The reference outline comes from alpha or the
corner colour; threshold is the colour distance. Give the original photo, not a crop.
grid_height_m (the real height of the reference silhouette) draws a metric grid with millimetre labels; zero
is the bottom centre of the silhouette box. It is true for a flat-on (orthographic) reference only. Before a
model exists, read coordinates with measure_profile grid=true.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out | No | ||
| mode | No | blend | |
| size | No | ||
| alpha | No | ||
| names | No | ||
| split | No | ||
| camera | No | ||
| reference | Yes | ||
| threshold | No | ||
| grid_height_m | No |