Skip to content

Scripting API

ICathedral

Returned by CathedralApi — the cathedral ring shank: arms rising toward the setting. Like Classic, a multi-gem ring body with no single mother gem. Adds to IParametricObject:

MemberMeaning
RingSizeLabel / RingSizeRegionRing size as label + region
RingDiameterMmInner diameter, mm
ShankThe band, arms and bridge — ICathedralShank
GemsThe pavé row — ICathedralGems
SetTopWidth / SetTopHeight / SetBottomWidth / SetBottomHeightShortcuts for the most common edits — same as the equivalent Shank setters

Both sections are live views over the shank’s stored parameters: their getters read the current values and every setter regenerates the shank in place (same Guid), gems and prongs included.

Band and arms (ICathedralShank)

MemberMeaning
ProfileNameRING_PROFILE asset name, "" when unset
TopWidth / TopHeightBand section at the top, mm
BottomWidth / BottomHeightBand section at the bottom, mm
ArmAngleArm angle, degrees
ArmWidthOpening between the rising arms, mm
ArmHeightHow high the arms climb over the finger circle, mm
ArmTangentTangency of the arm transition
CapDistancemm
BridgeEnabledWhether the bridge spanning the arms is built
BridgeWidth / BridgeThickness / BridgeDiameter / BridgeFilletBridge section, mm
SetProfile(assetName)Swap the profile — a RING_PROFILE asset by name
SetTopWidth / SetTopHeight / SetBottomWidth / SetBottomHeightBand sections, mm
SetArmAngle / SetArmWidth / SetArmHeight / SetArmTangent / SetCapDistanceThe arms
SetBridgeEnabled / SetBridgeWidth / SetBridgeThickness / SetBridgeDiameter / SetBridgeFilletThe bridge

Pavé row (ICathedralGems)

The row of small stones along the top — one run per arm. The advanced cathedral shares this exact section.

MemberMeaning
EnabledWhether the row is built
GemShape"ROUND", "PRINCESS", …
GemSizeStone size, mm
AngleDegrees of the band covered by gems (180 = top half)
MinDistance / Margin / InnerMargin / Vertical / GemInsidePlacement, mm
InnerWidth / InnerHeight / BrightCutInner channel, mm
ProngType"NONE", "SHARED" or "SCALLOPED"
ProngHeightmm
AutomaticProngDiameter / ProngDiameterAutomatic diameter, or the explicit one in mm
DrillEnabled / DrillType / DrillWidth / DrillHeightDrills — type is "NONE", "ROUND" or "QUAD"
DrillVisible / DrillAllowIntersectionBake the drill cutters, allow them to intersect
ExtensionForManufacturingmm
DoubleProngSetting / ScallopRemoveChannelScalloped-setting switches
ScallopGemWidth / ScallopGemHeight / ScallopRailWidth / ScallopRailHeight / ScallopProngWidth / ScallopProngHeightScalloped proportions (percentages, not mm)
SetEnabled, SetGemShape, SetGemSize, SetAngleThe row itself
SetMinDistance, SetMargin, SetInnerMargin, SetVertical, SetGemInsidePlacement, mm
SetInnerWidth, SetInnerHeight, SetBrightCutChannel, mm
SetProngType, SetProngHeight, SetAutomaticProngDiameter, SetProngDiameterProngs
SetDrillEnabled, SetDrillType, SetDrillWidth, SetDrillHeight, SetDrillVisible, SetDrillAllowIntersectionDrills
SetExtensionForManufacturing, SetDoubleProngSetting, SetScallopRemoveChannel
SetScallopGem(w, h) / SetScallopRail(w, h) / SetScallopProng(w, h)Scalloped proportions, in one call each

String parameters are case-insensitive and tolerate dashes/spaces; an unknown value raises a clear error listing the valid ones.