Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# Widget Types

Depending on the user parameter defined in a shader's Args File, different Widget Types are available to choose from. The main user parameters are the Number, String, and color parameters. The widget types available for a Number shader parameter are shown below.

The widget types for a String shader parameter are shown below.

The widget types and widget hint values for the different user parameters are shown in the table below:

Widget Type | Widget Hint Values | Description and Example
Number, String, Button, Toolbar, TeleParameter, Node Drop Proxy, and Capsule
Boolean | boolean | Displays two values or options, such as true or false. <param name="opacity" widget="boolean"/>
Popup Menu | popup | Displays entries specified in the Widget Options in a dropdown menu. <param name="opacity" widget="popup"> <hintlist name="options"> <string value="1.0"/> <string value="1.5"/> <string value="2.0"/> </hintlist> </param>
Mapping Popup Menu | mapper | Similar to Popup Menu, but with the option to map values. See Widget Options for more information. <param name="opacity" widget="mapper"> <hintdict name="options"> <float value="0.0" name="A"/> <float value="0.5" name="B"/> <float value="1.0" name="C"/> </hintdict> </param>
Check Box | checkBox | Similar to Boolean, but displayed as a checkbox. <param name="opacity" widget="checkBox"/>
String, Button, Toolbar, TeleParameter, Node Drop Proxy, and Capsule
Scene Graph Location | scenegraphLocation | Widget for specifying locations in the Scene Graph tab, for example, /root/world/geo/pony1 <param name="loc" widget="scenegraphLocation"/>
CEL Statement | cel | Specify a CEL Statement. For more information, see Collections and CEL. <param name="loc" widget="cel"/>
PBC Statement |  | Specify a PBC Statement. For more information, see Pattern-Based Collections with USD.
USD Collections Statement |  | Specify a USD Collections Statement. For more information, see Pattern-Based Collections with USD.
Resolution | resolution | A resolution, for example: 1024x768. <param name="loc" widget="resolution"/>
Asset | assetIdInput | Widget to represent an asset. The fields that are displayed in the UI and the browser that is used for selection can be customized using the Asset Management System API. <param name="EnvMap" widget="assetIdInput"/>
File Path | fileInput | String parameter representing a file on disk. Uses the standard Katana file browser for selection. <param name="texname" widget="fileInput"/>
Script Button | scriptButton | A button executing a Python script when clicked. <param scriptText="print 'Hello'" name="btn" buttonText="Run Script" widget="scriptButton"/>
TeleParameter | teleparam | Creates a parameter that 'teleports' parameters from another source (node, SuperTool, or similar). <param name="EnvMap" widget="teleparam"/>
Script Editor | scriptEditor | A field for entering a script as the parameter. <param name="EnvMap" widget="scriptEditor"/>
Capsule | capsule | A capsule widget can be used for a string parameter, and allows you to choose from a given list of options.
String Only
Attribute Name | attributeName | String parameter value which is the full name of an attribute, with names of ancestor group attributes separated by dots: xform.translate
Attribute Type | attributeType | String parameter value which is the name of the attribute's type: float
Group Only
Multi | multi | Creates a group set of parameters within a group.
Gradient |  | Select color gradient values.
Color Ramp | colorRamp | Select color ramp values.
Float Ramp | floatRamp | Select float ramp values.
Number Array Only
Color | color | Creates a color widget that allows you to set the RGB, HSL, and HSV values.
String Array Only
Scene Graph Locations | scenegraphLocationArray | Creates three Scene Graph Locations widgets that allow you to set locations.

Note: See Help > Developer Guide for more on setting hint strings on User Parameters.

Note: See also Adding User Parameters.