Scripting API
Graduated
from ArtisanPlugin.Scripting import GraduatedApi as graduated
A band whose section grows toward the centre stone, carrying a run of stones that shrink along the way - with prongs that taper to match.
Create
No Create yet. Run ArtisanGraduated in the UI once, then script every variant from the handle.
Edit
The IGraduated handle has two sections; each setter regenerates the shank in place, re-baking stones, prongs and the under-bezel rail:
| Section | What it edits |
|---|---|
Shank | The two profiles the section morphs between (TopProfile and BottomProfile, each with profile asset, closing type and dimensions), plus cut bumping and opening margin |
Gems | The run: stone count per side, start and end sizes, spacing, centre stone size, lift; the tapering prongs (heights, diameters, separations, over-girdle - each as a start/end pair); the under-bezel rail; and drills |
Most prong and stone sizes come as start/end pairs - start is nearest the centre stone, end nearest the band - and are set in one call:
from ArtisanPlugin.Scripting import GraduatedApi as graduated, Transaction
ring = graduated.Selected()[0]
with Transaction.Begin("Five stones per side, steeper taper"):
ring.Gems.SetNumberOfStones(5)
ring.Gems.SetSizes(2.8, 1.3) # centre-side, band-side
ring.Gems.SetProngDiameters(0.80, 0.60)
Queries
All(), Find(id), Count(), Selected(), ByLayer(name).