Scripting API
Advanced pavé shank
from ArtisanPlugin.Scripting import AdvancedPaveShankApi as pave
A band carrying one or more longitudinal rows of stones - each row a line of equal stones at its own lateral offset, running between two angles along the band.
Create
No Create yet. Run ArtisanAdvancedPaveShank in the UI once, then script every variant from the handle.
Edit
The IAdvancedPaveShank handle exposes the band and the rail; each setter regenerates the shank in place, re-baking stones and prongs:
| Section | What it edits |
|---|---|
TopProfile | The band section - the same classic profile model: asset, closing type, width/height, thickness, comfort, rotation, orientation |
Advanced | The opening at the bottom: none, cut or strangle |
Rail | The rows (replace the whole list, or edit one by index), the prong definitions, and the global prong height and diameter |
CuttersEnabled | Whether the gem cutters are subtracted from the band |
from ArtisanPlugin.Scripting import AdvancedPaveShankApi as pave, Transaction
ring = pave.Selected()[0]
with Transaction.Begin("Tighter centre row"):
ring.Rail.SetRow(0, gemSize = 1.1, offset = 0.0, spacing = 0.15,
startAngle = 20, endAngle = 160)
ring.Rail.SetProngDiameter(0.6)
Each row reports GemSize, Offset, Spacing, StartAngle, EndAngle and Mirror; each prong reports its RowIndex, position, Diameter, Height and flags.
Queries
All(), Find(id), Count(), Selected(), ByLayer(name).