Skip to content

Python package

ra.three_stones

The classic three-stone layout.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.ThreeStonesApi.

Functions

Function
create()Creates the editable Three Stones group.

ra.three_stones.create()

ra.three_stones.create(center_shape: str, center_carats: float, side_shape: str, side_carats: float, center_material=None, side_material=None, center_distance=None, center_rotation=None, side_distance=None, side_angle=None, side_rotation=None, side_rotation_y=None, finger_diameter=None) -> List[str]

Creates the editable Three Stones group. The center stone sits at the top of the finger size; the side stones mirror each other at side_angle degrees to each side, optionally leaning toward the center (sideRotationY). Defaults are the tool’s own. finger_diameter 0 = the document’s finger size. Returns the gem ids as [center, side A, side B] (the group also carries the finger reference circle).

ParameterType
center_shapestrrequired
center_caratsfloatrequired
side_shapestrrequired
side_caratsfloatrequired
center_materialstroptional — None = the tool default
side_materialstroptional — None = the tool default
center_distancefloatoptional — None = the tool default
center_rotationfloatoptional — None = the tool default
side_distancefloatoptional — None = the tool default
side_anglefloatoptional — None = the tool default
side_rotationfloatoptional — None = the tool default
side_rotation_yfloatoptional — None = the tool default
finger_diameterfloatoptional — None = the tool default