GemsByNetworkApi

Gems on a network of curves (the ArtisanGemsByNetwork tool, headless): fills a network of intersecting curves with stones, sizing them so they meet at the nodes. This is NOT a parametric type: the tool bakes loose gems in a plain group, there is no Regenerate and ArtisanEdit does nothing with it. So this facade creates and returns gem ids — there is no handle to enumerate or edit afterwards, and the gems are edited individually like any other loose stone (GemApi).

from ArtisanPlugin.Scripting import GemsByNetworkApi

See also the guide, Gemsets › Gems by network, and the Python package, ra.gems_by_network.

Methods

Method
Create	Fills curveIds with stones and bakes them as loose gems.

Create

IReadOnlyList<Guid> GemsByNetworkApi.Create(
    IEnumerable<Guid> curveIds = null,
    double gemSize = 0,
    double minDistance = 0,
    double moveInZ = double.NaN,
    bool? fitToEnd = null)

Fills curveIds with stones and bakes them as loose gems. Millimetres; 0 keeps the default: the user’s saved Gems on Network defaults when there are any, otherwise the tool’s (gemSize 1.0, minDistance 0.1, moveInZ 0: the stones sit on the curves). curveIds null/empty uses the current selection. Returns the ids of the baked gems.

Parameter	Type	Default
curveIds	IEnumerable<Guid>	null
gemSize	double	0
minDistance	double	0
moveInZ	double	double.NaN
fitToEnd	bool?	null

Returns IReadOnlyList<Guid>.