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 paths size, or any row has the wrong length.