setXformWorldPoses#
Fully qualified name: isaacsim::foundation::usd::openusd::setXformWorldPoses
- void isaacsim::foundation::usd::openusd::setXformWorldPoses(
- int64_t stageId,
- const std::vector<std::string> &paths,
- const std::optional<array::Array> &positions = std::nullopt,
- const std::optional<array::Array> &orientations = std::nullopt,
Sets the world poses of the given Xformable prims.
Only the specified components are updated; unspecified ones are read from the current world transform. Preserves the existing local scale.
- Parameters:
stageId – [in] Stage to operate on.
paths – [in] List of absolute SdfPath strings of Xformable prims.
positions – [in] Optional array of shape
(N, 3)with[x, y, z]world positions.orientations – [in] Optional array of shape
(N, 4)with xyzw-ordered world orientations.
- Throws:
std::invalid_argument – If any path does not refer to a valid or Xformable prim.
std::invalid_argument – If any prim does not have the canonical transform ops order [xformOp:translate, xformOp:orient, xformOp:scale].
std::invalid_argument – If a provided array’s row count does not match
pathssize, or any row has the wrong length.