Gallery

The gallery is intentionally recipe-shaped. Each entry names the dataset, the small set of APIs involved, and the core idea behind the composition.

Entries marked Pro require a license key to run as written.

Preview	Entry
	01. Mount Rainier
	02. Mount Fuji labels
	03. Swiss land-cover
	04. Luxembourg rail network
	05. 3D buildings Pro
	06. Point cloud
	07. Camera flyover
	08. Vector export Pro
	09. Shadow comparison
	10. Map plate Pro

Recipe Golden Fixtures

These small deterministic fixtures back the CI recipe-golden runner. Regenerate intentionally with FORGE3D_UPDATE_RECIPE_GOLDENS=1 pytest tests/test_recipe_goldens.py, review the image diffs, then commit the matching tests/golden/recipes/*.png updates with the code change. Failure artifacts are written under FORGE3D_RECIPE_GOLDEN_ARTIFACT_DIR when that environment variable is set; CI uploads them from tests/artifacts/.

CI runs recipe goldens in the Visual Goldens job. The primary path installs pyproj, probes the terrain backend with python scripts/terrain_ci_probe.py --mode terrain, then runs terrain and recipe image comparisons with FORGE3D_RUN_TERRAIN_GOLDENS=1. If the probe cannot prove a supported hardware-backed adapter, the job fails before image comparison instead of silently skipping shader-sensitive checks. FORGE3D_ALLOW_SOFTWARE_GOLDENS=1 is an explicit opt-in escape hatch for environments that cannot provide the GPU lane; it is scoped to recipe meta-validation and must not be treated as the primary render-quality gate.

To red-gate a shader-sensitive recipe change, make the smallest local shader perturbation that should affect a listed fixture, run FORGE3D_RUN_TERRAIN_GOLDENS=1 pytest tests/test_recipe_goldens.py -k <fixture>, and keep the generated FORGE3D_RECIPE_GOLDEN_ARTIFACT_DIR diff/actual/expected artifacts with the review notes. Revert the perturbation before landing. Only update a golden after the diff explains an intentional renderer change.

Fixture	Family	Golden	Command
`mapscene_terrain_raster`	terrain_raster	`tests/golden/recipes/mapscene_terrain_raster.png`	`pytest tests/test_recipe_goldens.py -k mapscene_terrain_raster`
`mapscene_vector_labels`	labels_vectors	`tests/golden/recipes/mapscene_vector_labels.png`	`pytest tests/test_recipe_goldens.py -k mapscene_vector_labels`
`mapscene_label_halo_depth`	labels_depth_occlusion	`tests/golden/recipes/mapscene_label_halo_depth.png`	`pytest tests/test_recipe_goldens.py -k mapscene_label_halo_depth`
`mapscene_label_occlusion_ridge`	labels_depth_occlusion	`tests/golden/recipes/mapscene_label_occlusion_ridge.png`	`pytest tests/test_recipe_goldens.py -k mapscene_label_occlusion_ridge`
`mapscene_vector_stroke_quality`	vector_stroke_quality	`tests/golden/recipes/mapscene_vector_stroke_quality.png`	`pytest tests/test_recipe_goldens.py -k mapscene_vector_stroke_quality`
`mapscene_vector_stroke_quality_4x`	vector_stroke_quality	`tests/golden/recipes/mapscene_vector_stroke_quality_4x.png`	`pytest tests/test_recipe_goldens.py -k mapscene_vector_stroke_quality_4x`
`mapscene_offline_aovs`	offline_accumulation	`tests/golden/recipes/mapscene_offline_aovs.png`	`pytest tests/test_recipe_goldens.py -k mapscene_offline_aovs`
`mapscene_buildings`	buildings	`tests/golden/recipes/mapscene_buildings.png`	`pytest tests/test_recipe_goldens.py -k mapscene_buildings`
`mapscene_furniture_graticule`	map_furniture	`tests/golden/recipes/mapscene_furniture_graticule.png`	`pytest tests/test_recipe_goldens.py -k mapscene_furniture_graticule`
`mapscene_alignment_utm`	alignment_crs	`tests/golden/recipes/mapscene_alignment_utm.png`	`pytest tests/test_recipe_goldens.py -k mapscene_alignment_utm`
`mapscene_material_maps`	terrain_materials	`tests/golden/recipes/mapscene_material_maps.png`	`pytest tests/test_recipe_goldens.py -k mapscene_material_maps`
`mapscene_png16_color`	output_color	`tests/golden/recipes/mapscene_png16_color.png`	`pytest tests/test_recipe_goldens.py -k mapscene_png16_color`