set_prim_transform
Move, rotate, or resize a prim by setting its position, rotation, or scale relative to its parent; any omitted transform values remain unchanged.
Instructions
Set a prim's position, rotation or scale relative to its parent; any of the three left out keeps its value.
Use it to move, turn or size a prim; to aim the viewport camera, use set_camera, and to push a rigid body while physics runs, apply_force. Values are in the parent's space, not world space: get_prim_properties gives a prim's world position. It writes into the prim's own xform ops: the position into its translate op, the rotation into its rotate or orient ops in their kind, the scale into its scale op, adding an op it lacks; other ops, a pivot among them, stay. A part with no op of its own goes into the prim's matrix (xformOp:transform) when it has one, as imported assets often do. An error when the prim doesn't exist or can't be transformed, for an animated op, for ops a stronger layer holds, such as a Kit camera's, and for a rotation or scale on a matrix that can't be factored.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prim_path": "<prim_path>"
},
"name": "set_prim_transform"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | A uniform scale, or [sx, sy, sz] | |
| position | No | [x, y, z] relative to the parent prim, in the stage's units (get_sim_state's meters_per_unit) | |
| rotation | No | Euler angles [rx, ry, rz] in degrees, or a quaternion [w, x, y, z] | |
| prim_path | Yes | Full USD path of the prim, e.g. "/World/Robot" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |