UsdCapsuleCreate
The UsdCapsuleCreate node creates a USD capsule prim. This node is derived from the UsdPrimCreate node, but the type is already populated as a capsule, with a default prim path /capsule, and the relevant properties, allowing you to easily and quickly create geometry in your scene.
Note: For more information on prims, see Native USD Prims in the user guide, and Pixar's USD Glossary.
Inputs
|
Connection Type |
Connection Name |
Function |
| Input | in | The incoming scene graph data that the node will operate on or modify. |
Controls
|
Control (UI) |
Default Value |
Function |
| primPath | /capsule | Specify location where capsule prim is to be created. Prims are generated at each specified path, in the order listed. |
| primSpec | define |
Choose the specifier for the prim. This is the role or function of the prim in the scene description. • define - defines a new, complete specification for a prim and its properties within a layer. • class - defines a prim meant to act as a template for other prims. It ensures uniformity and reusability throughout the scene by allowing other prims to adopt or specialize it, inheriting its characteristics. • over - indicates that the prim is an override. It's used to non-destructively modify prims defined in lower-priority layers. A prim with an "over" specifier is meant to modify or extend the properties or hierarchy of existing prims, without redefining them entirely. For more information, refer to the USD Glossary under specifier. |
| primSpecHierarchy | enabled | Determines whether to create all prims in the provided hierarchy with the primSpec. If disabled, all but the final Prim will be "over" primSpec to avoid writing over primSpecs in lower order layers. |
| properties | ||
| proxyPrim | N/A | A list of paths to use as a proxy prim. |
| axis | Z | The axis on which the capsule is aligned with. |
| doubleSided | disabled | For renderers that distinguish between single-sided and double-sided surfaces, controls whether this prim is double-sided. |
| > extent | 2 x 3 | The extent of the capsule. |
| height | 1 | The height of the capsule. |
| orientation | rightHanded | The orientation of the capsule. |
| > primvars | ||
| purpose | default |
Purpose is a classification of geometry into categories that can each be independently included or excluded from traversals of prims on a stage, such as rendering or bounding-box computation traversals. • default - the object has no particular purpose and is rendered by default. • render - the object is the full resolution version for use when rendering the scene. • proxy - the object is a proxy version used for test purposes, which can be a lower resolution to decrease render times. • guide - the object is not rendered, but is visible in the Viewer for reference. |
| radiusBottom | 0.5 | The radius of the bottom of the capsule. |
| radiusTop | 0.5 | The radius of the top of the capsule. |
| visibility | inherited |
Controls whether the object and its descendants are visible in the scene: • inherited - the object's visibility is controlled by its parent. • invisible - the object and its descendants are invisible in the scene. Visibility is meant to be the simplest form of "pruning" visibility that is supported by most DCC apps. Visibility is animatable, allowing a sub-tree of geometry to be present for some segment of a shot, and absent from others; unlike the action of deactivating geometry prims, invisible geometry is still available for inspection, for positioning, for defining volumes, etc. |
| > xformOpOrder | 0 x 1 | xformOpOrder describes a series of transformations to apply. |
| transform | ||
| xformOpName | UsdCapsuleCreate | The name to be given to the XformOp when stored in USD. |
| order | Scale Rot Trans | Select the order by which the three transformations are applied. |
| rotateOrder | Rx Ry Rz | Select the axes order by which the rotation takes place. By default the rotation is first around the x axis, then y, and finally z. |
| translate | 0.0, 0.0, 0.0 | Transforms the prim by moving it on the x, y, or z axes. Modifying in the viewer using the Translate manipulators also updates these parameter values. |
| rotate | 0.0, 0.0, 0.0 | Transforms the prim by rotating it around the x, y, or z axes. Modifying in the viewer using the Rotate manipulators also updates these parameter values. |
| scale | 1.0, 1.0, 1.0 | Transforms the prim by scaling it along the x, y, or z axes. Modifying in the viewer using the Scale manipulators also updates these parameter values. |
| pivotTranslate | 0.0, 0.0, 0.0 | The amounts by which the pivot point for transformations is translated along the x, y, and z axes. |
| pivotRotate | 0.0, 0.0, 0.0 | The amounts by which the pivot point for transformations is rotated along the x, y, and z axes. |
| makeInteractive | Yes | When set to "Yes", the selected path can be interactively manipulated in the Viewer. |