Skip to content

.NET API

.NET API

Every facade of ArtisanPlugin.Scripting — API 0.9.0, RhinoArtisan 7.0.0.10 — with the exact C# signature of each method, its parameters and defaults, and the handles, sections and results it hands back. This reference is generated from the plugin itself, so it always matches the version it names. For walkthroughs and examples, see the API reference guides; for Python 3, the rhinoartisan package.

Conventions: millimetres everywhere; an optional number left at 0 keeps the default (the user’s saved defaults for that element, else the tool’s); a Guid list left null or empty uses the current selection; every mutating call needs a valid license; wrap changes in a Transaction so they land as one undo step.

  • Core types — Transaction, ScriptingInfo, LicenseGate and the exceptions a script can catch.
  • Results — the read-only records methods return (prices, weights, exports…).
  • Other interfaces — the shared bases of the handles (IParametricObject, IGemSetting…).

Gems

Facade
AdvancedGemsOnCurveApiRuns of stones along a curve with per-stone sizes, shapes and rotations.
GemApiCreate, query and edit stones: shapes, materials, carats, placement, copies, collisions.
GemOrientationApiFix the orientation plane of stones without moving them.
GemSizeApiStones by millimetre size instead of carats.
GemToolsApiUtilities over existing stones: centers, tags, alignment, curves from gems, copy by gems, colors by size.
GemsByNetworkApiStones over a network of intersecting curves, sized to meet at the nodes.
GemsFromCircleApiTurn circles into round stones of the matching size.
GemsOn2CurvesApiStones fitted between two rails, sized to the gap.
GemsOnCurveApiA run of stones along one curve, with prongs and cutters, editable afterwards.
TaperedBaguettesApiTapered baguettes between two curves.
ThreeStonesApiThe classic three-stone layout.
ToiEtMoiApiTwo stones facing each other.
TrilogyApiThree-stone families: trellis, halo, individual, bezel set, east-west.

Settings

Facade
AdvancedBasketApiBaskets with independent prong and rail profiles.
AdvancedBezelApiBezels with a custom profile.
BasketApiBasket settings: prongs, upper and base rails.
BasketUpdateApiBasket settings: prongs, upper and base rails.
BezelApiBezel settings with support, cutter and air-gap sections.
CabochonApiCabochon stones and their settings.
ChannelApiChannel settings along a curve.
ClusterApiCluster settings around a centre stone.
CutterApiThe cutters that carve the seat of a stone into the metal.
HaloApiA halo of small stones around a centre stone.
HiddenHaloApiA hidden halo under the centre stone.
MartiniApiMartini settings.
MicroSettingApiMicro settings (micro-pave heads).
PearlApiPearls and their cups.
PegheadApiPeghead seats under a stone: prongs, height, thickness.
TrellisGemsetApiTrellis settings.
TulipApiTulip settings.

Shanks and rings

Facade
AdvancedCathedralApiCathedral shanks with station-by-station control.
AdvancedRingApiRings built from positioned sections along the finger curve.
AdvancedSignetRingApiSignet rings with independent top and side profiles.
BypassApiBypass shanks whose arms cross past each other.
CathedralApiCathedral shanks: arms rising toward the setting.
ClassRingApiClass rings.
ClassicApiClassic ring shanks: comfort-fit bands at the document finger size, optionally with a stone row.
EternityApiEternity bands with stones all around.
GraduatedApiGraduated shanks: a run of stones shrinking away from the centre.
MatchingShankApiMatching shanks fitted against an engagement ring.
MatchingShankBuilderApiMatching shanks fitted against an engagement ring.
PaveShankApiPave shanks: rows of stones along the band.
PaveShankBuilderApiPave shanks: rows of stones along the band.
RingCurveApiRing rail curves at the document finger size (closed, open, bypass, shaped).
RingExtrudeApiRings extruded from a frontal profile.
RingToolsApiUtilities on ring geometry: cut by ring size, estimate size, rail helpers.
ScoopRingApiScoop rings.
SignetRingApiSignet rings with a shaped top face.
SplitShankApiSplit shanks.
TwoRowsShankApiTwo-row shanks.
TwoRowsShankBuilderApiTwo-row shanks.
WeddingApiWedding sets (band pairs) built as one editable object.
WeddingBandApiSingle wedding bands.
WeddingBuilderApiWedding sets (band pairs) built as one editable object.

Pave and prongs

Facade
AutomaticPaveApiRelaxed multi-size pave fill with symmetry.
AzureApiAzure cutters under a pave: the openwork underneath.
PaveAlongSurfaceApiPave rows following a surface direction.
PaveApiAutomatic pave over surfaces: one size in a regular grid, with prongs and cutters.
ProngApiProngs: dynamic (between stones), automatic, custom and axis-aligned.

Components

Facade
BailApiPendant bails.
BangleApiBangles.
BeadApiBeads.
ChainApiChains along a curve.
CharmApiCharms.
EngravingApiRing engravings.
HingeApiHinges.
HoneyCombApiHoneycomb patterns over surfaces.
HuggieApiHuggie earrings.
LinkApiChain links.
MilgrainApiMilgrain beading along curves.
NamedPendantApiName pendants from text.
PatternApiRepeated patterns over surfaces.
ProfileSweepApiSweeps of a profile along rails.
RopeApiRope twists.
SmartComponentApiEdit bails, named pendants, bangles, beads, charms, links, milgrain, ropes, 3D textures and ring engravings after creation (their model as JSON).
TextOnCurveApiText laid along a curve.
Texture3DApi3D textures applied to surfaces.
UserElementApiUser-defined elements.
VoronoiApiVoronoi patterns over surfaces.

Solids, curves and transforms

Facade
BooleanApiArtisan booleans that keep the pieces editable: union, difference, intersection, split, update.
BooleanUpdateApiArtisan booleans that keep the pieces editable: union, difference, intersection, split, update.
CurveApiCurve helpers for jewelry layouts.
MeshApiMesh decimation.
RasterToVectorApiTrace an image into curves.
RelationsApiParent/child relations between parametric objects.
ReliefApi2.5D reliefs: creators, the operation stack, sculpt/smooth by points, bake, heightmaps.
SmartProfileApiSmart Profiles: profile sections swept along a curve, varying along the way.
SolidApiSolid modelling helpers: caps, shells, sweeps, offsets.
TransformApiMove, rotate, scale, mirror, arrays, deformations (bend, twist, taper), flow, placement on objects.

Analysis and pricing

Facade
AnalyzeApiWall thickness: at points and globally.
PricingApiPrices and cost breakdowns, markup and taxes profiles.
PricingExtraApiPrices and cost breakdowns, markup and taxes profiles.
WeightApiMetal weights: per layer, per selection, by area.

Production

Facade
FileApiFile utilities: standardize, elements import/export, layer exports.
ManufacturingApiProduction: repair, printability checks, identifiers, sprues, resizing, exports.

Drafting

Facade
DraftingApiReports, gems maps, cost tables, dimensions.
DraftingExtraApiReports, gems maps, cost tables, dimensions.

Render and views

Facade
RealtimeRenderApiThe web Realtime Render viewer: open, update, camera, materials, screenshots.
RenderApiRender materials, staging and batch rendering.
RenderStudioApiRender Studio: environments, materials, stills and turntables.
ViewApiViewport cameras, display modes, named views and captures.

Document and library

Facade
AssetsApiThe profile library the parametric tools build from.
DocumentApiThe document: open/save/new, computation mode, metals, ring size, STL/PDF/GLB exports.
ElementsApiSaved element presets: build from them, apply them, save objects as new ones, organize the library.
PanelsApiThe open Artisan command panel: which one it is, and closing it without applying.
SemanticsApiSemantic descriptions of the design.

Integrations

Facade
FileSearchApiInstant search over indexed design files.
NivodaApiNivoda certified-diamond search.

Other

Facade
AiImageApiAI images with fal.ai, the engine of Generative AI Studio and of the Assistant’s generate_image: a photoreal render of the viewport, an edit of an image file, or an image from a prompt alone.
BoutiqueApiThe Boutique: ready-made designs (solitaires, trilogies, halos, bands, earrings…) grouped in collections that are downloaded from the RhinoArtisan catalog to this computer and imported into the document like the Boutique window does.
TimeTrackingApiThe time tracker’s records (the ArtisanTimeTracker panel), read-only: how long each saved file has been worked on, per day.