ra.ring_extrude

Rings extruded from a frontal profile.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.RingExtrudeApi.

Functions

Function
all()	Ids of every RingExtrude body in the active document.
create()	Builds a ring body by extruding silhouettes (the ArtisanRingExtrude tool, headless): a frontal silhouette (an EXTERNAL_RING_PROFILE asset) and a lateral silhouette (a RING_SIDE_CURVE asset) are grown around the finger circle by the lengths below and intersected — the quick way to get a wide, sculpted band.

ra.ring_extrude.all()

ra.ring_extrude.all() -> List[str]

Ids of every RingExtrude body in the active document.

ra.ring_extrude.create()

ra.ring_extrude.create(top_length=None, side_length=None, bottom_length=None, top_thickness=None, bottom_thickness=None, hollow=None, linear_thickness=None, angle=None, symmetry=None, advanced_top_thickness=None, advanced_lateral_thickness=None, frontal_profile=None, lateral_profile=None, finger_diameter=None, plane=None) -> str

Builds a ring body by extruding silhouettes (the ArtisanRingExtrude tool, headless): a frontal silhouette (an EXTERNAL_RING_PROFILE asset) and a lateral silhouette (a RING_SIDE_CURVE asset) are grown around the finger circle by the lengths below and intersected — the quick way to get a wide, sculpted band. Millimetres; omitting keeps the tool default (or the user’s saved defaults): top_length 2, side_length 2, bottom_length 2 (metal over the finger at top / sides / bottom), top_thickness 2, bottom_thickness 2 (band width, frontal view). hollow True carves the inside with linear_thickness (2), angle (degrees, NaN = 0), symmetry SYMMETRIC (default) | ASYMMETRIC with advanced_top_thickness / advanced_lateral_thickness (2). frontal_profile / lateral_profile pick assets by name (see AssetsApi). finger_diameter 0 = document ring size. plane omitted = world XY. Returns the Guid of the new ring body (a RingExtrude custom object).

Parameter	Type
top_length	float	optional — None = the tool default
side_length	float	optional — None = the tool default
bottom_length	float	optional — None = the tool default
top_thickness	float	optional — None = the tool default
bottom_thickness	float	optional — None = the tool default
hollow	Optional[bool]	optional — None = the tool default
linear_thickness	float	optional — None = the tool default
angle	float	optional — None = the tool default
symmetry	str	optional — None = the tool default
advanced_top_thickness	float	optional — None = the tool default
advanced_lateral_thickness	float	optional — None = the tool default
frontal_profile	str	optional — None = the tool default
lateral_profile	str	optional — None = the tool default
finger_diameter	float	optional — None = the tool default
plane	Optional[PlaneLike]	optional — None = the tool default