Artisan Grasshopper
Gems
14 components in Gems › Gems.
Center Stone
Creates a gem from CenterStone Reader outputs. Uses carat if provided, otherwise XYZ dimensions.
Nickname: CenterStone · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane |
| Material (optional) | Material | Text | item | — | Gem material (compound). Defaults to Diamond. |
| Shape (optional) | Shape | Text | item | — | Gem shape. Defaults to ROUND. |
| Size (ct) (optional) | Size by Ct | Number | item | — | Gem size by carats |
| Size X (optional) | Size X | Number | item | — | Gem size X |
| Size Y (optional) | Size Y | Number | item | — | Gem size Y |
| Size Z (optional) | Size Z | Number | item | — | Gem size Z |
| Move in Z | MoveZ | Number | item | 0.0 | Move gem along the selected plane’s Z axis by this distance |
| Rotate 90 | Rotate90 | Boolean | item | false | Rotate gem 90 degrees |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
| Scheme | Scheme | Generic | item | Center stone scheme with reader-compatible keys |
Center Stone for Solitaire Rings
Creates a center stone for a solitaire ring. Instead of a plane, takes a ring Diameter and a Distance: the gem plane is the XY plane moved up in Z by (Diameter / 2) + Distance, with the gem resting on that surface.
Nickname: CenterStone Solitaire · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Diameter | Diameter | Number | item | 16.92 | Ring diameter |
| Distance | Distance | Number | item | 0.0 | Distance from the ring surface to the gem |
| Material (optional) | Material | Text | item | — | Gem material (compound). Defaults to Diamond. |
| Shape (optional) | Shape | Text | item | — | Gem shape. Defaults to ROUND. |
| Size (ct) (optional) | Size by Ct | Number | item | — | Gem size by carats |
| Size X (optional) | Size X | Number | item | — | Gem size X |
| Size Y (optional) | Size Y | Number | item | — | Gem size Y |
| Size Z (optional) | Size Z | Number | item | — | Gem size Z |
| Move in Z | MoveZ | Number | item | 0.0 | Move gem along the plane’s Z axis by this distance |
| Rotate 90 | Rotate90 | Boolean | item | false | Rotate gem 90 degrees |
| Connector (optional) | Connector | Generic | item | — | Dictionary from a Reader Connector output (material, shape, carat, sizeX/Y/Z, moveInZ, rotate90). Individual inputs override. |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
| Scheme | Scheme | Generic | item | Center stone scheme with reader-compatible keys |
Gem
Creates a gem by Width
Nickname: Gem · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane for gem |
| Shape (optional) | Shape | Generic | item | — | GemShape (index or name, e.g. 0 or ROUND) |
| Width | Width | Number | item | 5.0 | Width or diameter |
| Compound (optional) | Compound | Generic | item | — | GemCompound (index or name, e.g. 0 or Diamond) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
Gem by Carat
Creates a gem by weight (carat)
Nickname: Gem Ct · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane |
| Shape (optional) | Shape | Generic | item | — | GemShape (index or name, e.g. 0 or ROUND) |
| Carat | Ct | Number | item | 1.0 | Weight in carats |
| Compound (optional) | Compound | Generic | item | — | GemCompound (index or name, e.g. 0 or Diamond) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
Gem by Carat for Solitaire Rings
Creates a gem by weight (carat) placed on a solitaire ring: the base XY plane is moved up in Z by (Diameter / 2) + Distance
Nickname: Gem Ct Solitaire · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Diameter | Diameter | Number | item | 16.92 | Ring diameter |
| Distance | Distance | Number | item | 0.0 | Distance from the ring surface to the gem plane |
| Shape (optional) | Shape | Generic | item | — | GemShape (index or name, e.g. 0 or ROUND) |
| Carat | Ct | Number | item | 1.0 | Weight in carats |
| Compound (optional) | Compound | Generic | item | — | GemCompound (index or name, e.g. 0 or Diamond) |
| Connector (optional) | Connector | Generic | item | — | Dictionary from a Reader Connector output (shape, carat, compound). Individual inputs override. |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
Gem by XYZ
Creates a gem by Width (X), Height (Y) and Depth (Z)
Nickname: Gem XYZ · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane |
| Shape | Shape | Integer | item | 0 | GemShape |
| Width | X | Number | item | 1.0 | Width or diameter |
| Height | Y | Number | item | 1.0 | Height |
| Depth | Z | Number | item | 0.6 | Depth |
| Compound (optional) | Compound | Generic | item | — | GemCompound (index or name, e.g. 0 or Diamond) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gem | Gem | GemObject | item | Full gem object |
| Gem Mesh | Mesh | Mesh | item | Just a beautiful gem mesh |
| Curve | Crv | Curve | item | Gem outline curve |
| Dictionary | Dict | Generic | item | Gem values as dictionary |
| Semantic | Semantic | Text | item | Semantic text description of the gem |
Three Stones
Creates a three-stones set: one center stone plus two symmetric side stones placed around a ring diameter. Same placement as the ArtisanThreeStones command.
Nickname: ThreeStones · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane. Y axis = finger axis, Z axis = top of the ring. |
| Ring Diameter | Ring Diameter | Number | item | 17.0 | Finger circle diameter (mm) |
| Center Material (optional) | C Material | Text | item | — | Center gem material (compound). Defaults to Diamond. |
| Center Shape (optional) | C Shape | Text | item | — | Center gem shape. Defaults to ROUND. |
| Center Size (ct) | C Size Ct | Number | item | 1.0 | Center gem size by carats |
| Center Distance | C Distance | Number | item | 4.0 | Center gem distance above the finger circle (mm) |
| Center Rotation | C Rotation | Number | item | 0.0 | Center gem rotation around its vertical axis (degrees) |
| Side Material (optional) | S Material | Text | item | — | Side gems material (compound). Defaults to Diamond. |
| Side Shape (optional) | S Shape | Text | item | — | Side gems shape. Defaults to ROUND. |
| Side Size (ct) | S Size Ct | Number | item | 0.5 | Side gems size by carats |
| Side Distance | S Distance | Number | item | 3.2 | Side gems distance above the finger circle (mm) |
| Side Angle | S Angle | Number | item | 28.0 | Side gems position angle from the top of the ring, around the finger axis (degrees) |
| Side Rotation | S Rotation | Number | item | 0.0 | Side gems rotation around each gem’s vertical axis, mirrored on both sides (degrees) |
| Side Rotation Y | S Rotation Y | Number | item | 25.0 | Side gems tilt around the finger axis at each gem’s origin, mirrored on both sides (degrees) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gems | Gems | GemObject | list | Gem objects: center, side A, side B |
| Gem Meshes | Meshes | Mesh | list | Gem meshes: center, side A, side B |
| Curves | Crvs | Curve | list | Gem outline curves: center, side A, side B |
| Finger Circle | Circle | Curve | item | Finger reference circle |
| Dictionaries | Dicts | Generic | list | Gem values as dictionaries: center, side A, side B |
| Semantic | Semantic | Text | list | Semantic text description of each gem: center, side A, side B |
| Scheme | Scheme | Generic | item | Three stones scheme with reader-compatible keys |
Toi et Moi
Creates a Toi et Moi pair: two independent stones straddling the top of a ring diameter, one leaning to each side. Same placement as the ArtisanToiEtMoi command.
Nickname: ToiEtMoi · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Base plane. Y axis = finger axis, Z axis = top of the ring. |
| Ring Diameter | Ring Diameter | Number | item | 17.35 | Finger circle diameter (mm) |
| Stone A Material (optional) | A Material | Text | item | — | Stone A material (compound). Defaults to Diamond. |
| Stone A Shape (optional) | A Shape | Text | item | — | Stone A shape. Defaults to ROUND. |
| Stone A Size (ct) | A Size Ct | Number | item | 0.75 | Stone A size by carats |
| Stone A Distance | A Distance | Number | item | 3.2 | Stone A distance above the finger circle (mm) |
| Stone A Angle | A Angle | Number | item | 14.0 | Stone A position angle from the top of the ring, around the finger axis (degrees) |
| Stone A Rotation | A Rotation | Number | item | 0.0 | Stone A rotation around its vertical axis (degrees) |
| Stone A Rotation Y | A Rotation Y | Number | item | 20.0 | Stone A tilt around the finger axis at the gem’s origin (degrees) |
| Stone B Material (optional) | B Material | Text | item | — | Stone B material (compound). Defaults to Diamond. |
| Stone B Shape (optional) | B Shape | Text | item | — | Stone B shape. Defaults to ROUND. |
| Stone B Size (ct) | B Size Ct | Number | item | 0.75 | Stone B size by carats |
| Stone B Distance | B Distance | Number | item | 3.2 | Stone B distance above the finger circle (mm) |
| Stone B Angle | B Angle | Number | item | -14.0 | Stone B position angle from the top of the ring, around the finger axis (degrees) |
| Stone B Rotation | B Rotation | Number | item | 0.0 | Stone B rotation around its vertical axis (degrees) |
| Stone B Rotation Y | B Rotation Y | Number | item | -20.0 | Stone B tilt around the finger axis at the gem’s origin (degrees) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Gems | Gems | GemObject | list | Gem objects: stone A, stone B |
| Gem Meshes | Meshes | Mesh | list | Gem meshes: stone A, stone B |
| Curves | Crvs | Curve | list | Gem outline curves: stone A, stone B |
| Finger Circle | Circle | Curve | item | Finger reference circle |
| Dictionaries | Dicts | Generic | list | Gem values as dictionaries: stone A, stone B |
| Semantic | Semantic | Text | list | Semantic text description of each gem: stone A, stone B |
| Scheme | Scheme | Generic | item | Toi et Moi scheme with reader-compatible keys |
Baguette
Baguette stone: length, top and bottom widths (tapered when they differ), depth and table proportions
Nickname: Baguette · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Stone plane (girdle plane, table along the normal) |
| Compound | Compound | Text | item | d.Compound.ToString() | Gem compound (Diamond, Ruby, Emerald, Sapphire…) |
| Length | L | Number | item | d.Length | Length |
| Top Width | TopW | Number | item | d.TopWidth | Width at one end |
| Bottom Width | BottomW | Number | item | d.BottomWidth | Width at the other end |
| Depth Percentage | Depth% | Integer | item | d.DepthPercentage | Total depth as a percentage of the width |
| Table Percentage | Table% | Integer | item | d.TablePercentage | Table as a percentage of the width |
| Girdle Depth | GirdleD | Number | item | d.GirdleDepth | Girdle depth |
| Crown Depth | CrownD | Number | item | d.CrownDepth | Crown depth |
| Pavilion Depth | PavilionD | Number | item | d.PavilionDepth | Pavilion depth |
| Pavilion Scale | PavilionS | Number | item | d.PavilionScale | Pavilion scale |
| Culet Length | CuletL | Number | item | d.CuletLength | Culet length |
| Angle | Angle | Number | item | d.Angle | Rotation on the plane (degrees) |
| Vertical Alignment | VAlign | Text | item | d.AlignmentVertical | Which level sits on the plane: Girdle, Table or Culet |
| Move In Z | MoveZ | Number | item | d.MoveInZ | Offset along the plane normal |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Mesh | Mesh | Mesh | item | Baguette mesh |
Cabochon
Cabochon stone: Round, Oval, Rectangular, Heart, Pear, Marquise or Diamond outline; Cabochon, FlatTop or BuffTop with single or double bevel
Nickname: Cabochon · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Stone plane (girdle plane, top along the normal) |
| Shape | Shape | Text | item | d.Shape.ToString() | Round, Oval, Rectangular, Heart, Pear, Marquise or Diamond |
| Type | Type | Text | item | d.Type.ToString() | Cabochon, FlatTopSingleBevel, FlatTopDoubleBevel, BuffTopSingleBevel or BuffTopDoubleBevel |
| X | X | Number | item | d.X | Size along X (radius for Round) |
| Y | Y | Number | item | d.Y | Size along Y |
| Z | Z | Number | item | d.Z | Dome height |
| Angle | Angle | Number | item | d.Angle | Bevel angle (degrees) |
| Girdle Height | GirdleH | Number | item | d.GirdleHeight | Girdle height |
| Girdle Angle | GirdleA | Number | item | d.GirdleAngle | Girdle angle (degrees) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Brep | Brep | Brep | item | Cabochon brep |
Gem Info
Extracts gem information and outputs it as JSON with setting type and compound.
Nickname: Gem Info · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Gems | Gems | GemObject | list | — | List of gem objects |
| Setting Type (optional) | Setting | Text | item | PRONGS | Gem setting type (e.g. PRONGS, PAVE, CHANNEL, FLUSH, BEZEL, PRESSURE, WAX, OTHER) |
| Compound (optional) | Compound | Text | item | DIAMOND | Gem compound (e.g. DIAMOND, RUBY, SAPPHIRE) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| JSON | JSON | Text | item | JSON output with gem info |
| GemInfo | GemInfo | Generic | item | Gem info as a dictionary object |
Metal Info
Extracts metal geometry information and outputs it as JSON with material.
Nickname: Metal Info · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Geometry | Geo | Geometry | list | — | List of metal geometry |
| Material (optional) | Material | Text | item | GOLD_YELLOW_18 | Metal material (e.g. GOLD_YELLOW_18, SILVER, PLATINUM) |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| JSON | JSON | Text | item | JSON output with metal info |
| MetalInfo | MetalInfo | Generic | item | Metal info as a dictionary object |
Pearl
Pearl with an optional wire and calotte
Nickname: Pearl · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Plane | Plane | Plane | item | Plane.WorldXY | Pearl plane (the wire goes along the normal) |
| Size | Size | Number | item | d.PearlSize | Pearl diameter |
| Wire | Wire | Boolean | item | d.WireEnable | Build the wire |
| Wire Diameter | WireD | Number | item | d.WireDiameter | Wire diameter |
| Wire Length | WireL | Number | item | d.WireLength | Wire length |
| Calotte | Calotte | Boolean | item | d.CalotteEnable | Build the calotte |
| Calotte Angle | CalotteA | Number | item | d.CalotteAngle | Calotte opening angle (degrees) |
| Calotte Thickness | CalotteT | Number | item | d.CalotteThickness | Calotte thickness |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Pearl | Pearl | Brep | item | Pearl brep |
| Wire | Wire | Brep | item | Wire brep (when enabled) |
| Calotte | Calotte | Brep | item | Calotte brep (when enabled) |
Prong Axis
Axis curves for the prongs of a gem: number of prongs, height over and under the girdle, bottom diameter
Nickname: Prong Axis · Tab: Gems › Gems
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Gem | Gem | GemObject | item | — | Gem the prongs go around |
| Number Of Prongs | N | Integer | item | d.NumberOfProngs | Number of prongs |
| Straight | Straight | Boolean | item | d.Straight | Straight prongs (vertical axis) instead of following the gem |
| Diameter | D | Number | item | d.Diameter | Prong diameter at the girdle |
| Height | H | Number | item | d.Height | Prong height under the girdle |
| Gem Inside | GemIn | Number | item | d.GemInside | How far the prong enters the gem |
| Over Girdle | OverG | Number | item | d.OverGirdle | Prong rise over the girdle |
| Bottom Diameter | BottomD | Number | item | d.BottomDiameter | Diameter of the bottom rail the prongs meet |
| Bottom Rail Inside | BottomIn | Number | item | d.BottomRailInside | Bottom rail offset inwards |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Curves | Curves | Curve | list | One axis curve per prong |