Class Transform

Controls the position, rotation, and scale of a SceneObject. Every SceneObject automatically has a Transform attached.

Example

// Move attached Transform 1 unit up
var transform = script.getTransform();
var pos = transform.getWorldPosition();
pos.y += 1;
transform.setWorldPosition(pos);

// Bind to "Frame Updated" to rotate the object every frame
var transform = script.getTransform();
var rotation = transform.getLocalRotation();
var rotateBy = quat.angleAxis(Math.PI*getDeltaTime(), vec3.up());
rotation = rotation.multiply(rotateBy);
transform.setLocalRotation(rotation);

Hierarchy (View Summary, Expand)

Constructors

constructor

Properties

back down forward left right segmentScaleCompensate up

Methods

getInvertedWorldTransform getLocalPosition getLocalRotation getLocalScale getSceneObject getTypeName getWorldPosition getWorldRotation getWorldScale getWorldTransform isOfType isSame setLocalPosition setLocalRotation setLocalScale setLocalTransform setWorldPosition setWorldRotation setWorldScale setWorldTransform

Constructors

Protectedconstructor

Properties

Readonlyback

back: vec3

Returns the Transform's back directional vector.

Readonlydown

down: vec3

Returns the Transform's down directional vector.

Readonlyforward

forward: vec3

Returns the Transform's forward directional vector.

Readonlyleft

left: vec3

Returns the Transform's left directional vector.

Readonlyright

right: vec3

Returns the Transform's right directional vector.

segmentScaleCompensate

segmentScaleCompensate: boolean

When scaling a parent with segment scale enabled, instead of scaling child objects, it creates position offsets. This setting is used when exporting from certain 3d authoring tools.

Readonlyup

up: vec3

Returns the Transform's up directional vector.

Methods

getInvertedWorldTransform

  • getInvertedWorldTransform(): mat4

    Returns the Transform's world-to-local transformation matrix.

    Returns mat4

getLocalPosition

  • getLocalPosition(): vec3

    Returns the Transform's position relative to its parent.

    Returns vec3

getLocalRotation

  • getLocalRotation(): quat

    Returns the Transform's rotation relative to its parent.

    Returns quat

getLocalScale

  • getLocalScale(): vec3

    Returns the Transform's scale relative to its parent.

    Returns vec3

getSceneObject

getTypeName

getWorldPosition

  • getWorldPosition(): vec3

    Returns the Transform's position relative to the world.

    Returns vec3

getWorldRotation

  • getWorldRotation(): quat

    Returns the Transform's rotation relative to the world.

    Returns quat

getWorldScale

  • getWorldScale(): vec3

    Returns the Transform's scale relative to the world.

    Returns vec3

getWorldTransform

  • getWorldTransform(): mat4

    Returns the Transform's local-to-world transformation matrix.

    Returns mat4

isOfType

  • isOfType(type: string): boolean

    Returns true if the object matches or derives from the passed in type.

    Parameters

    • type: string

    Returns boolean

isSame

  • isSame(other: ScriptObject): boolean

    Returns true if this object is the same as other. Useful for checking if two references point to the same thing.

    Parameters

    Returns boolean

setLocalPosition

  • setLocalPosition(pos: vec3): void

    Sets the Transform's position relative to its parent.

    Parameters

    Returns void

setLocalRotation

  • setLocalRotation(rotation: quat): void

    Sets the Transform's rotation relative to its parent.

    Parameters

    Returns void

setLocalScale

  • setLocalScale(scale: vec3): void

    Sets the Transform's scale relative to its parent.

    Parameters

    Returns void

setLocalTransform

  • setLocalTransform(transformMat: mat4): void

    Sets the Transform's local transformation matrix.

    Parameters

    Returns void

setWorldPosition

  • setWorldPosition(pos: vec3): void

    Sets the Transform's position relative to the world.

    Parameters

    Returns void

setWorldRotation

  • setWorldRotation(rotation: quat): void

    Sets the Transform's rotation relative to the world.

    Parameters

    Returns void

setWorldScale

  • setWorldScale(scale: vec3): void

    Sets the Transform's scale relative to the world. This may produce lossy results when parent objects are rotated, so use setLocalScale() instead if possible.

    Parameters

    Returns void

setWorldTransform

  • setWorldTransform(transformMat: mat4): void

    Sets the Transform's transformation matrix.

    Parameters

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
MMNEPVFCICPMFPCPTTAAATR