Command · transform

transform.lookAt

Aim local -Z at a world point or entity with a preferred world up vector.

scope edit:sceneidempotentnon-destructive

Params

Typed as TransformLookAtParams. Fields marked * are required.

entity*

entity

Camera, light or other entity whose local -Z axis should face the target.

required

point

option<vec3>

World-space target position. Supply exactly one of point or target.

default nullm

target

option<entity>

Target entity in this document; its world position is used.

default null

option<vec3>

Preferred world-space up vector; defaults to +Y. At a pole a stable perpendicular axis is used.

default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "transform.lookAt",
  "args": {
    "entity": "e_camera",
    "point": [
      0,
      1,
      0
    ],
    "up": [
      0,
      1,
      0
    ]
  }
}

CLI

ara do transform.lookAt --args '{"entity":"e_camera","point":[0,1,0],"up":[0,1,0]}' --why "…"