Artisan Grasshopper
Relief
7 components in Artisan › Relief.
Relief Project
Builds a relief from a stack of operations (connect the Relief operation components to Operations, in order) and outputs the mesh
Nickname: Relief · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Operations (optional) | Ops | Generic | list | — | Relief operations, applied in this order (Shift+drag to connect several) |
| Workbench | Plane | Plane | item | d.Workbench | Plane the relief sits on: grid centred at its origin, heights along its normal |
| Width | W | Number | item | d.WorldWidth | Relief width (model units) |
| Height | H | Number | item | d.WorldHeight | Relief height (model units) |
| Resolution | Res | Integer | item | d.Resolution | Grid nodes along the longest side |
| Thickness | Solid | Boolean | item | d.OutputType == ReliefOutputType.Thickness | True: closed solid with a flat back at Cap Distance; false: open surface |
| Cap Distance | Cap | Number | item | d.CapDistance | Distance from the plane to the back of the solid |
| Delete Base | NoBase | Boolean | item | d.DeleteBase | Drop the untouched (zero height) area of the field |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Mesh | Mesh | Mesh | item | Relief mesh |
Relief Extrude
Relief operation: raises (or engraves, with a negative height) the area inside closed curves
Nickname: Extrude · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Curves | Curves | Curve | list | — | Closed curves, on or projected onto the workbench plane |
| Height | H | Number | item | d.Height | Extrusion height (negative engraves) |
| Feather | Feather | Number | item | d.Feather | Edge blend distance (0 = hard edge) |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
| Combine Mode | Mode | Text | item | ReliefCombineMode.Add.ToString() | How the layer merges into the field: Add, Subtract, ZMax or ZMin |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |
Relief Geometry
Relief operation: heights from meshes, breps or SubDs sitting over the workbench plane
Nickname: Geometry · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Geometry | Geo | Geometry | list | — | Meshes, breps or SubDs over the workbench plane |
| Feather | Feather | Number | item | d.Feather | Edge blend distance (0 = hard edge) |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
| Combine Mode | Mode | Text | item | ReliefCombineMode.Add.ToString() | How the layer merges into the field: Add, Subtract, ZMax or ZMin |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |
Relief Image
Relief operation: heights from a grayscale image (white = Height), fitted to the workbench or to the given closed curves
Nickname: Image · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Image | Image | Text | item | — | Path to the image file |
| Curves (optional) | Curves | Curve | list | — | Optional closed curves: the image is fitted to their bounds and clipped by them |
| Height | H | Number | item | d.Height | Height at pure white (negative engraves) |
| Invert | Invert | Boolean | item | d.Invert | Invert the image (black = Height) |
| Scale | Scale | Number | item | d.Scale | Multiplier over the fitted size |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
| Combine Mode | Mode | Text | item | ReliefCombineMode.Add.ToString() | How the layer merges into the field: Add, Subtract, ZMax or ZMin |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |
Relief Profile
Relief operation: puffs the area inside closed curves with a height profile (Round, Smooth, Chamfer, Plateau or a profile from your library)
Nickname: Profile · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Curves | Curves | Curve | list | — | Closed curves, on or projected onto the workbench plane |
| Profile | Profile | Text | item | d.Profile.Name | Profile name: Round, Smooth, Chamfer, Plateau, or one saved in the Artisan profile library |
| Height | H | Number | item | d.Height | Peak height (negative engraves) |
| Starting Height | H0 | Number | item | d.StartingHeight | Height at the curve edge |
| Inflate | Inflate | Boolean | item | d.InflateMode == ReliefInflateMode.Inflate | True: the profile stretches to peak at the deepest point; false: fixed Profile Width from the edge |
| Profile Width | PW | Number | item | d.ProfileWidth | Profile width from the edge (when Inflate is false) |
| Feather | Feather | Number | item | d.Feather | Edge blend distance (0 = hard edge) |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
| Combine Mode | Mode | Text | item | ReliefCombineMode.Add.ToString() | How the layer merges into the field: Add, Subtract, ZMax or ZMin |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |
Relief Smooth
Relief operation: blurs the operations below it, over the whole relief or only around the given points
Nickname: Smooth · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Points (optional) | Pts | Point | list | — | Dab centres (world points on the workbench). Empty: the whole relief is smoothed |
| Radius | R | Number | item | 2.0 | Dab radius (model units) |
| Strength | S | Number | item | 1.0 | Dab strength (0-1) |
| Blur Radius | Blur | Number | item | d.BlurRadius | Blur kernel radius (model units) |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |
Relief Texture
Relief operation: tiles a grayscale texture (a name from the Artisan Textures3D library, or an image path) over the workbench or inside the given closed curves
Nickname: Texture · Tab: Artisan › Relief
Inputs
| Name | Nickname | Type | Access | Default | Description |
|---|---|---|---|---|---|
| Texture | Texture | Text | item | — | Texture file name in the Artisan Textures3D library (e.g. KNURL01.jpg), or a full image path |
| Curves (optional) | Curves | Curve | list | — | Optional closed curves: the texture is fitted to their bounds and clipped by them |
| Height | H | Number | item | d.Height | Height at pure white (negative engraves) |
| Invert | Invert | Boolean | item | d.Invert | Invert the texture (black = Height) |
| Tiles U | U | Number | item | d.TilesU | Repetitions along U |
| Tiles V | V | Number | item | d.TilesV | Repetitions along V |
| Enabled | On | Boolean | item | true | Include this operation in the relief |
| Combine Mode | Mode | Text | item | ReliefCombineMode.Add.ToString() | How the layer merges into the field: Add, Subtract, ZMax or ZMin |
Outputs
| Name | Nickname | Type | Access | Description |
|---|---|---|---|---|
| Operation | Op | Generic | item | Relief operation (connect to Relief Project) |