Tool Input: SceneNode
The Tool Input: SceneNode generates a pickbutton in the rollout. With this input, you may acquire any node in the scene, and access its underlying mesh or spline. Helpers may also be picked in this manner to obtain information about their positions and transforms.
Once a node has been picked, you may right-click on the pickbutton to clear its value.
The behavior of your tool may vary if the scene node has not yet been picked. In the simplest case, you may choose to exit the evaluation of the graph pre-emptively with Exit if SceneNode is Invalid:
Alternatively, you may choose to pursue the execution of the graph even if the node has not yet been picked. Attempting to access the mesh (or the spline) of an unpicked node will return an empty mesh (or an empty spline). In the graph below, we return a cube if the node's contained mesh is empty.
SceneNode Mesh provides the raw definition of the mesh's vertices, however if you are creating a Geometry, a Modifier, or a Spline tool, you can obtain the mesh's definition in the tool's space with SceneNode Mesh in Tool Space. Provide the corresponding tool's "Local to World Matrix" to successfully obtain the mesh definition in the tool's coordinate system. Doing so will have the effect of "binding" that mesh in world space, regardless of the current tool's location.
