kubakub mesh to relief field

Turns a finished 3D mesh (OBJ, or GLB / PLY / STL with trimesh) into a relief field seen from one direction, so relief safety check, mould prep and mass estimate can work on it. The undercut mask shows what a one-piece mould or a single milling setup cannot reach.

By kubakubkub·Created 15 days ago·Updated 3 days ago· 9

field
preview
undercut
report
height

◄mesh_path►

◄mesh_unitsm►

◄up_axisY►

◄azimuth_deg0►

◄elevation_deg0►

◄resolution768►

◄ground_offset_mm0►

◄clamp_relief_mm0►

Categorykubakub/3d/fabricate/relief

Inputs (8)

Name	Type	Default	Description
mesh_path	STRING		Full path of the mesh file. OBJ always works; GLB, GLTF, PLY and STL need trimesh installed. The node re-runs when the file changes. Empty = the built-in sample facade (metres, Y up).
mesh_units	COMBO	m	The unit the mesh was modelled in, so the relief comes out in real millimetres.
up_axis	COMBO	Y	Which axis points up in the mesh file (Y for most OBJ / GLB exports, Z for some CAD tools).
azimuth_deg	FLOAT	0-360–360	Direction you look at the mesh from, turning around the up axis, in degrees. 0 = from the front (+Z for Y up).
elevation_deg	FLOAT	0-89–89	Tilt of the view, in degrees: above 0 looks down from above, 0 = straight on.
resolution	INT	768128–4096	Width of the relief in pixels; the height follows the mesh. Higher = finer but slower.
ground_offset_mm	FLOAT	0-5000–5000	Added to the mesh's own height, in mm: how high its lowest point sits above the ground (for the safety check's reach). 0 = as modelled.
clamp_relief_mm	FLOAT	00–5000	Cut the relief off at this depth, in mm, measured from the back. 0 = no limit.

Outputs (5)

Name	Type	Description
field	RELIEFFORGE_FIELD	The mesh as a relief in mm, for the other relief nodes.
preview	IMAGE	Grey preview of the relief (white = nearest to the viewer).
undercut	MASK	White where geometry hides behind other geometry from this direction (an undercut).
report	STRING	Size, depth, height above ground and the share of undercuts (json).
height	MASK	The relief as a mask: 0 = the back, 1 = the nearest point. The report gives the range in mm (height_range_mm), to use it as a depth or displacement map.