Iso World To Scene

Overview

Converts an IsoWorld with semantic placement into the pre-render internal IsoScene, serving as the isometric equivalent of a camera. Tile pixel dimensions (tile_step), vertical step, and canvas size are all determined here.

Usage tips

• The IsoWorld lane always ends here: ... → iso_world_compose → iso_world_to_scene → iso_scene_render / iso_scene_to_surface_geometry.
• Tile dimensions (tile_step_x/y, z_step) are managed together here, not per block. For 2:1 isometric projection, step_x is normally the tile width and step_y is half.
• For a still image, use the default AutoFit plus padding. Fix the frame settings when cropping a fixed-size part of a map or animating it.
• AutoFit ignores the initial canvas dimensions and origin when deriving the final frame, including free-form paths at negative coordinates or beyond 64 cells. Only KeepCanvas uses the explicit frame.
• Scenes larger than 4096x4096 are rejected instead of being silently cropped.
• For lighting, do not render the Scene directly; send it through iso_scene_to_surface_geometry into Surface-family nodes.

Notes

• In IsoWorld -> IsoScene -> Raster, this node handles the IsoWorld to IsoScene conversion.
• The current minimal implementation lowers IsoBlock to the equivalent existing IsoExtrusion representation.
• With the default frame_mode = AutoFit, the canvas and origin adjust automatically to the content.
• padding controls margins during automatic fitting.
• Adjust tile_step_x, tile_step_y, and z_step together here; they are not stored on IsoBlock.

Related nodes

• iso_world_compose — combine worlds before conversion
• iso_scene_render — rasterize the Scene
• iso_scene_to_surface_geometry — connect to the Surface lighting path
• iso_scene_compose — combine at the Scene stage (advanced)