Sets the current tool in a scene viewer (or lists available tools).
Usages
viewtool [-t tool_name] viewer_name
This command sets the currently active tool in a scene viewer (that is, the selected tool that shows its options in the operator control toolbar and acts on mouse clicks and key presses). This command simulates the effect of the user choosing a tool in the viewer, such as via the tab menu . If no options are specified, then this command lists all the available tools for the given viewer.
Use the viewls command to list the available scene viewers.
Note
The tools you can select depend on the viewer type. For example, you can only select object tools (such as Pose) when the viewer is at the object level.
Options
-t tool_name
| Name of the tool to select in the viewer. This is the internal name of the tool, not the name that
usually shows up in the user interface, for example Use this command without any options to obtain the list of available tools. |
Examples
viewtool Build.pane1.worldPrints a list of tools available in the scene viewer named
Build.pane1.world. This list may depend on the viewer type (e.g.,
POP viewer vs. SOP viewer).
viewtool -t geo Build.pane1.worldSelects the Geometry Object in the scene viewer named
Build.pane1.world.
viewtool -t polyextrude Build.pane1.worldSelects the Poly Extrude SOP in the scene viewer named
Build.pane1.world.