ra.automatic_pave

Relaxed multi-size pave fill with symmetry.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.AutomaticPaveApi.

Functions

Function
on_surface()	Fills surface_ids with stones and bakes them as loose gems.

ra.automatic_pave.on_surface()

ra.automatic_pave.on_surface(surface_ids=None, gem_sizes=None, min_distance=None, border_distance=None, fill_mode=None, symmetry=None, start_point=None, relax_iterations=None) -> List[str]

Fills surface_ids with stones and bakes them as loose gems. gem_sizes is the size palette in millimetres — the tool’s distinguishing feature: pass several and the relaxation picks per stone (e.g. [1.5, 1.2, 0.9]); None/empty uses 1.3. min_distance is the metal left between stones, border_distance the margin to the surface edge (both mm, 0 keeps 0.1). fill_mode is FROM_BORDER (default, seeds the outline first) or FROM_CENTER, which grows from start_point. symmetry mirrors the layout: NONE (default), X, Y or BOTH. relax_iterations runs extra relaxation passes for a tidier result. Returns the ids of the baked gems.

Parameter	Type
surface_ids	Sequence[IdLike]	optional — None = the tool default
gem_sizes	Sequence[float]	optional — None = the tool default
min_distance	float	optional — None = the tool default
border_distance	float	optional — None = the tool default
fill_mode	str	optional — None = the tool default
symmetry	str	optional — None = the tool default
start_point	Optional[PointLike]	optional — None = the tool default
relax_iterations	int	optional — None = the tool default