In the model Edit mode, the parameter widget is enhanced with administrative settings that are only available to the author of the model.

When clicking on the "Apply settings" button, the parameter settings will be stored with the model and become the default for whoever accesses it in the future. They will also be reflected when interacting with the model through the API. We break down all the model settings below.

Names

After uploading a model, the default parameter names are imported from the Grasshopper definition. In the Edit mode, those values can still be overwritten at any time without having to reupload the model.

Order

Reorganize the parameters in the preferred order using the burger handles on the left of each parameter. The order will also be stored as a parameter property accessible through the API.

Visibility

Each parameter can be hidden from the standard mode of the control widget. Toggle the parameter visibility using the eye icon on the top right of each parameter. In the edit mode, hidden parameters are blurred and can be made visible again any time using the toggle. The visibility will also be stored as a parameter property accessible through the API.

Order and visibility of embedded model parameters
When the viewer is embedded on a different website and uses a custom UI instead of ShapeDiver's control widget, it is the responsibility of the website developer to use the order and visibility properties to display the parameters accordingly. Depending on the implementation, hiding parameters in the Edit mode will not automatically hide them from a custom third-party UI.

Default values

In the Edit mode, one can play with parameters just like in the standard mode and trigger geometry updates. When applying settings, the currently selected parameter values will become the default ones, used every time the model is loaded in the future. This is both the case for models in the ShapeDiver platform and the ones embedded externally.