This command prompts the user to choose from a list of options
| <viz>.choose( | |
| prompt | # string message accompanying dialog box |
| choices | # choices as string list |
| selection = 0 | # default selection from list |
)
prompt
A string that will show up above the selection
choices
A list of strings that specify the possible choices
selection = 0
The initial selection. The default is 0, which is the first option in the list. 1 would be the second option in the list, and so on.
This command halts all action in the script until the user has chosen an option. For this reason, it is primarily used to collect initialization information before the real-time rendering begins.
The index of the option in the list that the user chose.