ra.engraving

Ring engravings.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.EngravingApi.

Functions

Function
create()	Engraves text around a ring of the given inner diameter (mm; 0 = the session’s current finger size, default 17.35).

ra.engraving.create()

ra.engraving.create(text: str, diameter=None, angle=None, height=None, spacing=None, thickness=None, font=None, font_style=None, horizontal_align=None, vertical_align=None, plane=None) -> List[str]

Engraves text around a ring of the given inner diameter (mm; 0 = the session’s current finger size, default 17.35). angle rotates the text around the ring (the tool’s gumball, degrees). thickness 0 keeps flat engraving curves only; > 0 also builds the solid text. Defaults: font Bienchen regular, height 1.5, spacing 0.5, horizontal align CENTER, vertical align CENTER. plane is the text orientation plane (default: active construction plane). Returns the ids of the created objects (solid text on the metal layer, engraving curves on the user layer, all grouped as an editable Engrave Ring component).

Parameter	Type
text	str	required
diameter	float	optional — None = the tool default
angle	float	optional — None = the tool default
height	float	optional — None = the tool default
spacing	float	optional — None = the tool default
thickness	float	optional — None = the tool default
font	str	optional — None = the tool default
font_style	str	optional — None = the tool default
horizontal_align	str	optional — None = the tool default
vertical_align	str	optional — None = the tool default
plane	Optional[PlaneLike]	optional — None = the tool default