Utils

13 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

Halo Channel Profile by Name

Gets a halo channel profile Asset by name (SOFT_DOOM, DOMMED_RECTANGLE, FLAT_ROUNDED_CORNERS)

Nickname: HaloChProfile · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Default	Description
Profile Name	Name	Text	item	SOFT_DOOM	Profile name: SOFT_DOOM, DOMMED_RECTANGLE, FLAT_ROUNDED_CORNERS

Outputs

Name	Nickname	Type	Access	Description
Asset	A	Generic	item	Profile Asset

SKU Combiner

Combine geometric SKU list with material/gem options into all possible combinations.

Nickname: SKU Combiner · Tab: Artisan › Utils

Inputs

Name	Nickname	Type	Access	Default	Description
Enabled	Enabled	Boolean	item	false	Enable saving JSON to disk
Prefix	Prefix	Text	item	—	Style identifier prefix (e.g. RIN001)
Path (optional)	Path	Text	item	—	Folder path where the JSON file will be saved
SKU Geometric	SKU's Geometric	Text	list	—	Geometric SKU list
Geometry Version (optional)	Version	Integer	item	1	Geometry version number
Metal 01	M1	Text	list	—	Lines: value,sku,name
Metal 02	M2	Text	list	—	Lines: value,sku,name
Metal 03	M3	Text	list	—	Lines: value,sku,name
Gem 01	G1	Text	list	—	Lines: value,sku,name
Gem 02	G2	Text	list	—	Lines: value,sku,name
Gem 03	G3	Text	list	—	Lines: value,sku,name

Outputs

Name	Nickname	Type	Access	Description
SKU	SKU	Text	list	Combinatorial SKUs
Max	Max	Integer	item	Total number of SKUs generated
JSON	JSON	Text	item	JSON array with all SKU combinations
Exported Path	Exported	Text	item	Path of the exported JSON file, or empty if not exported

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)

Resolve GH File Name

Resolve the current Grasshopper definition file name. If input is null/empty, returns the .gh definition file name.

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

Inputs

Name	Nickname	Type	Access	Description
Custom Name (optional)	Name	Text	item	Custom file name. If empty, use Grasshopper definition file name.

Outputs

Name	Nickname	Type	Access	Description
Resolved Name	Name	Text	item	Final file name

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