The reference can be the bounding box of another geometry, or the bounds of a set of prims.
Parameters ¶
Sampling Behavior
Cooking this node can generate many USD time samples, rather than just a single time sample at the current time. This can be equivalent to having a Cache LOP following this node, but it will evaluate much faster, and does not cache data from any other nodes. This allows animated data to be authored to USD without introducing a node time dependency which would then cause all following nodes to also be time dependent. This can vastly improve playback performance of some LOP Networks.
In all sampling modes, if a parameter on this node does not vary with time, and does not rely on other time sampled data from the stage, only a single default value will be generated in USD for the corresponding attribute. USD time samples are only generated for parameters that may vary over time.
Sample Current Frame
A single time sample will be generated for the current time.
Sample Frame Range If Input Is Not Time Dependent
If the input to this node is time dependent, this node behaves as if it is in Sample current frame
mode. Otherwise it behaves as if it is in Sample frame range
mode.
Sample Frame Range
The Start/End/Inc parameter is used to generate multiple times at which this node’s parameters are evaluated, and a USD time sample is created for each attribute at each one of these times.
Start/End/Inc
When the Sampling behavior is Sample frame range
, this parameter controls the number and spacing of base time samples to be generated by this node. The default values of this parameter are @fstart
, @fend
, and @finc
. These values correspond to the start, end, and step size of the global Houdini animation settings when interacting with Houdini. When using a ROP node to generate a range of frames, these values correspond to the start, end, and increment values specified on the ROP node being executed. This default ensures that a USD file written to disk will contain time samples for exactly the frame range requested by the ROP (regardless of the Houdini animation settings).
Subframe Sampling
For each primary sample generated by this node, these parameters can cause additional samples to be generated around that primary sample time. This is most often used to ensure that accurate data exists at exactly the camera shutter open and close times, as well as at the primary sample time.
Shutter
Controls the method used to specify the shutter open and close times relative to the primary sample times.
Specify Manually
The Shutter Open/Close parameter values provide exact offset values relative to the primary sample time.
Use Camera Prim
The Camera Prim parameter provides the scene graph path of a camera primitive from which the shutter open and close times are extracted to provide the offset values relative to the primary time sample.
Shutter Open/Close
When Shutter is set to Specify Manually, these two offset values are added to the primary sample time to indicate the shutter open and close times. The open time should be less than or equal to zero, and the close time should be greater than or equal to zero.
Camera Prim
When Shutter is set to Use Camera Prim, this is the scene graph path of a camera prim on the input node’s stage. The shutter open and close attribute values are read from this primitive.
Samples
The number of subframe samples to create for each primary sample. These samples are evenly distributed between the shutter open and close times. Note that such an even distribution may or may not create a sample at exactly the primary sample time.
Always Include Frame Sample
When turned on, forces a sample to be created at exactly the primary sample time. If the Samples value, together with the shutter open and close times, already place a sample at the primary sample time, turning on this option has no effect. Otherwise, this option causes an addition sample to be added. This means that the actual number of samples per primary sample may in fact be one more than the number specified in the Samples parameter.
Primitives
The primitive(s) the node should operate on. You can drag primitives from the scene graph tree pane into this textbox to add their paths, or click the Reselect button beside the text box to select the primitives in the viewer, or ⌃ Ctrl-click the Reselect button to choose prims from a pop-up tree window. You can also use primitive patterns for advanced matching, including matching all prims in a collection (using /path/to/prim.collection:‹name›
).
Note
This parameter needs to be exposed in order for the transform handles to be context-aware. Without it, the handles may not be positioned properly.
Import Frame
The frame number at which to evaluate the stage.
Justify With
How to compute the reference bounding box.
Origin and Unit Size
The reference point is a unit bounding box. The reference size will be unit-sized.
Target Primitive(s)
The bounding box of the specified primitive(s) will be used as reference. If there is primitive, a zero-sized bounding box at the origin is used.
Location and Size
The reference bounding box is anchored to a specific point and given the specific size. Which corner of the bounding box is anchored depends on the Justify With options.
Target Source
Specify, whether the target primitives should be sourced from the node’s first or second input.
Target Primitives
The primitive(s) to use as reference. With more than one primitive, their combined bounding box will be used.
Target Position
This parameter is only visible with Justify With set to Location and Size. Anchor for the reference bounding box if no second input is given. It represents the center of the box unless the relevant axis' justification is Min or Max, in which case it represents the edge of the reference box.
Target Size
This parameter is only visible with Justify With set to Location and Size. Size of the reference bounding box if no second input is given.
Action
Apply Transform
Applies the resulting match size transform as an Xform op on the primitive.
Transform Geometry
Applies the resulting match size transform directly onto the attributes of type point3f
.
Transform Suffix
When Mode is set to Apply Transform, specify the suffix of the Xform op.
Match Each Prim
When turned on, each primitive specified by Primitives will be match-sized individually. When turned off, all primitives will be treated as a single piece of geometry.
Translate
Translates the object to match the reference box.
Justify X/Y/Z
Controls how the each axis is translated to match the reference box.
None
No movement on the X axis
Min
The minimum of the object’s bounding box is aligned to the minimum of the reference’s bounding box.
Center
The center of the object’s bounding box is aligned to the center of the reference’s bounding box.
Max
The maximum of the object’s bounding box is aligned to the maximum of the reference’s bounding box.
To
Controls which axis of the reference box the object is justified to.
Same
Matches the justification of reference: so the minimum will match minimum, or center match center.
Min
The justification side of the object’s bounding box is aligned to the minimum of the reference’s bounding box.
Center
The justification side of the object’s bounding box is aligned to the center of the reference’s bounding box.
Max
The justification side of the object’s bounding box is aligned to the maximum of the reference’s bounding box.
Offset by
Additional offset to apply to the justification. This allows you to specify a fixed-size gap, or fixed-size overlap.
Scale to Fit
Whether to scale the geometry to match the size of the reference box.
Uniform Scale
Preserve the aspect ratio of the geometry by scaling all axes equally.
Scale Axis
In case of uniform scale not all axes can necessarily be fit. This determines which axis is used.
X
The X axis will be matched.
Y
The Y axis will be matched.
Z
The Z axis will be matched.
Best Fit
The object will be fully contained in the reference box.
Perimeter
The total edge lengths of the two models will be scaled to match. This is not well defined if either model lacks edges.
Area
The total surface area of the two models will be scaled to match. This is not well defined if either model has no surface.
Volume
The total volume of the two models will be scaled to match. This is not well defined if either model lacks volume.
Scale X/Y/Z
Controls, whether each axis will be scaled to the reference box.
Scale
Multiply the resulting scaling by this amount.
See also |