Suimple Inputs

Inputs

Primitive Types (int, text, number, bool)

Native Inputs

If you use a GUI type input (e.g. slider, dropdown, etc.) then Suimple will automatically re-create that input in the Suimple window.

Tip

For the Drop Downs, if you put the word “Layer” or “Block” in the name of that component, the Suimple form will populate with the Layers and Blocks in the Active Document, so you can build scripts without having to know what Layers the user will have.

Warning

Note that the checklist currently defaults to a DropDown. Checklists will come in a future update.

Native Params

If instead, you use a Param, Suimple will create a simple text box (except for Booleans, which create a check box). However, if your Param has exactly one GUI Input upstream, then the form will still recreate that Input in the form for you, following the same principles above.

Note some of the following behaviors:

• The value in the form will default to the value of the input
• Dropdowns with “Layer” in the name will still autopopulate with the layers in the active document
• Params are still names based on their own NickName, not the name of the input upstream
• File Path Params will automatically create a button where the user can navigate files on their computer.
• If you use the word “Folder” on a File Path Param, the navigation button will allow the user to specify a folder instead of a file path.

Important

Suimple will ultimately assign the value in the Text Boxes of the form, so you can either use the sliders, or simply type in the value you want.

Params vs. Inputs

Tip

If you want there to be default values, it might be safer to assign to the Param directly, so that if the file is saved, it won’t override your defaults.

When you press any of the “Run” buttons, Suimple will take the value in the form, and assign it to the component in the Group. Take the case of a slider:

Notice how for the first input, the value is assigned directly to the Param in the Group, whereas the second value is assigned directly to the Slider.

Contextual Params

Suimple will also work with Contextual Params

Geometry Inputs

Suimple supports native geometry inputs.

Note

At the moment, it only allows “base types”, not “derived” types - so Curve works, but Circle or Line is not implemented yet.

The form will create a button, which allows the user to select objects in the Rhino model. Once selected, the form indicates how many objects are selected, and the user can also choose to preview their selection by expanding the arrow. The user can choose to preview in Rhino and/or the preview viewport, and the Zoom button will zoom whatever viewports are active, to the selection.

Note

The Get Geometry and other geometry-based Contextual Params will be implemented in future versions.