Utils

12 components in Artisan › Utils.

Dictionary Query

Retrieve a value from a Dictionary using a key

Nickname: Dict Query · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Description
Dictionary	Dict	Generic	item	Dictionary to search
Key (optional)	Key	Text	item	Key to look for

Outputs

Name	Nickname	Type	Access	Description
Value	Value	Generic	item	Value associated with the key
Keys	Keys	Text	list	All available keys in the Dictionary

JSON Panel

Displays JSON on the canvas (pretty-printed, syntax coloured, resizable, scrollable) and outputs the parsed value. Source accepts a .json file path, JSON text, a Dictionary or any object. Double-click the panel to open it in a window.

Nickname: JSON · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Description
Source	S	Generic	item	JSON source: a .json file path, JSON text, a Dictionary or any object.
Query (optional)	Q	Text	item	Optional JSONPath query, e.g. $.gems[0].size or gems[*].name

Outputs

Name	Nickname	Type	Access	Description
JSON	J	Text	item	Pretty-printed JSON text (after the query, if any).
Value	V	Generic	list	Parsed value: a Dictionary for objects (feeds Dictionary Query and the Artisan readers), one item per element for arrays, or the primitive itself.

Resolve GH File Name

Name and folder of the current Grasshopper definition file.

Nickname: GHFileName · Tab: Artisan › Utils

Inputs

This component has no inputs.

Outputs

Name	Nickname	Type	Access	Description
Name	Name	Text	item	Grasshopper definition file name, without extension (Untitled when not saved)
Folder	Folder	Text	item	Folder of the Grasshopper definition (empty when not saved)

Selector

Create a Selector object from parameters and a panel of items (value,sku,name).

Nickname: Selector · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Default	Description
type	Type	Text	item	—	Selector type
name	Name	Text	item	—	This is the name group on the configurator
ui_index	UI Position	Integer	item	-1	Position in the UI
page_index	Page Index	Integer	item	0	Page index
Panel	Panel	Text	list	—	Panel with lines: value,sku,name

Outputs

Name	Nickname	Type	Access	Description
Selector	Sel	Generic	item	Selector object

Selector Hub

Combine multiple Selectors into one JSON output.

Nickname: Selector Hub · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Description
Selector 1	S1	Generic	item	Selector object

Outputs

Name	Nickname	Type	Access	Description
JSON	JSON	Text	item	Combined Selectors JSON

Selector Types

Predefined list of selector types.

Nickname: Selector Types · Tab: Artisan › Utils · Value list — a dropdown you pick from, with no inputs

Values

Label	Value
Gem Shape	GEM_SHAPE
Gem Size	GEM_SIZE_CT
Ring Size	RING_SIZE
Metal 1	METAL_1
Metal 2	METAL_2
Metal 3	METAL_3
Gem Compound 1	GEM_1
Gem Compound 2	GEM_2
Gem Compound 3	GEM_3

Counter

Counts ticks using a timer-like behaviour

Nickname: Counter · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Run	Run	Boolean	item	false	Start or stop the timer
Reset	Reset	Boolean	item	false	Reset the counter
Max	Max	Integer	item	0	Maximum count before stopping (0 = no limit)
Interval	I	Integer	item	1000	Milliseconds between ticks
Increment	Increment	Boolean	item	false	Connect a button: each press increments the counter by one

Outputs

Name	Nickname	Type	Access	Description
Count	Count	Integer	item	Current tick count

GH Path

Resolve export folder path. If input is null/empty, returns the .gh definition folder.

Nickname: GH Path · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Custom Path (optional)	Path	Text	item	Custom export path. If empty, use Grasshopper definition folder.

Outputs

Name	Nickname	Type	Access	Description
Resolved Path	Path	Text	item	Final export path

Plane Translate

Translates a plane along its local axes

Nickname: PlnTrans · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Plane	P	Plane	item	Plane.WorldXY	Base plane to move
X	X	Number	item	0.0	Translation along the plane’s X axis
Y	Y	Number	item	0.0	Translation along the plane’s Y axis
Z	Z	Number	item	0.0	Translation along the plane’s Z axis

Outputs

Name	Nickname	Type	Access	Description
Plane	P	Plane	item	Translated plane

Progress Bar

Displays progress as a percentage

Nickname: Progress · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Default	Description
Current	Current	Integer	item	0	Current index (0-based)
Max	Max	Integer	item	100	Maximum index

Outputs

Name	Nickname	Type	Access	Description
Percentage	%	Number	item	Progress percentage (0-100)

RhinoArtisan Settings

Control global settings for RhinoArtisan plugin

Nickname: Settings · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

This component has no inputs.

Outputs

Name	Nickname	Type	Access	Description
License Type	License	Text	item	Current license type

String In List

Checks if a string exists in a list of strings

Nickname: StrInList · Tab: Artisan › Utils · In the tab’s dropdown, not on the ribbon face

Inputs

Name	Nickname	Type	Access	Description
Text (optional)	T	Text	item	Text to search
List (optional)	L	Text	list	List of strings

Outputs

Name	Nickname	Type	Access	Description
Exists	Exists	Boolean	item	True if text exists in list