Model Render

Overview

The camera that converts a Model mesh into a pixel-art asset. It is the Model counterpart to solid_render and shares its parameter vocabulary: azimuth, elevation, pixels_per_unit, and FixedCanvas. It orthographically projects a PBR-material Model to a Surface with normals, depth, and material IDs. This is the 2D exit for a workflow that creates both GLB and HD-2D images from the same model.

Usage tips

• Basic position: model_group(組み立て済み) → モデル素材割り当て → model_render → surface_light_preview. See the bundled workflows/model_asset_c1.ppl.

• Think about parameters in the same way as solid_render:

  • One still image → AutoFit; animation or eight directions → always FixedCanvas
  • pixels_per_unit controls pixel density, with 16 as the baseline
  • Use camera_angle_snap = 45 for eight-direction assets

• As with Solid, find an angle in the 3D viewer (Model 3D Stage), then write it back with "Use this angle."

• Azimuth uses z-up world axes and increases from +X toward +Y when viewed from +Z.

  Azimuth	Camera side	Screen-right direction
  0°	+X	+Y
  90°	+Y	-X

• In FixedCanvas, the image plane spans Canvas Width/Height ÷ Pixels Per Unit around frame_center_*. frame_world_* defines the near/far volume and depth/height normalization. Geometry beyond either range produces a non-fatal diagnostic in the warnings output and beside Frame Mode.

• For rigid-body animation such as a treasure chest opening, drive model_transform rotation with a waveform → this node in FixedCanvas → animation_render. Bake the same motion into the GLB with Animation Frames in model_gltf_export. See workflows/model_chest_animation_c7.ppl.

Common pitfalls

• Frame size or center changes between frames: the node is rotating in AutoFit. Use FixedCanvas and set frame_world_* large enough to contain the subject. This is the same major trap as in solid_render.
• The result is flat and lacks material character: this node does not light the model. Send the surface output through surface_light_preview and adjust roughness in the PBR material.
• Textures bleed or sample adjacent faces: the texture gutter is too small. Extend edge colors with texture_layout_dilate before bundling them in pbr_material.

PBR consumer compatibility

Related nodes

• solid_render — the equivalent camera in the Solid (SDF) lane
• model_gltf_export — the 3D GLB exit for the same model
• surface_light_preview — lights the output Surface
• pbr_material / model_texture_layout — companions for texture production