ra.pave_along_surface

Pave rows following a surface direction.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.PaveAlongSurfaceApi.

Functions

Function
create()	Rows of round diamonds along the isocurves of a surface — the ArtisanPaveAlongSurface (Pave UV) tool, headless.

ra.pave_along_surface.create()

ra.pave_along_surface.create(surface_id: IdLike, points: Sequence[PointLike], gem_size=None, distance=None, border_distance=None, direction=None, justify=None, vertical_alignment=None) -> List[str]

Rows of round diamonds along the isocurves of a surface — the ArtisanPaveAlongSurface (Pave UV) tool, headless. surface_id is a surface or single-face polysurface; each entry of points replaces one click on it and yields one row along the isocurve through that point, in direction U (default) or V. Millimetres; omitting keeps the tool default (or the user’s saved defaults): gem_size 1.5, distance 0.1 between gems, border_distance 0.2. justify True squeezes the row to fill the isocurve; vertical_alignment CENTER (default) / TOP / BOTTOM shifts the row sideways by half a gem. Positions shared by two rows are baked once. Returns the ids of the created gems.

Parameter	Type
surface_id	IdLike	required
points	Sequence[PointLike]	required
gem_size	float	optional — None = the tool default
distance	float	optional — None = the tool default
border_distance	float	optional — None = the tool default
direction	str	optional — None = the tool default
justify	Optional[bool]	optional — None = the tool default
vertical_alignment	str	optional — None = the tool default