TranslateTo - ObjectReference
Revision as of 22:12, 23 February 2012 by imported>Jbizek (comment about recommended starting point for afSpeed)
Member of: ObjectReference Script
Makes the object translate to the passed in position and orientation at the given speed.
Syntax
Function TranslateTo(float afX, float afY, float afZ, float afAngleX, float afAngleY, float afAngleZ, float afSpeed, \
float afMaxRotationSpeed = 0.0) nativeParameters
- afX: Position along the X axis.
- afY: Position along the Y axis.
- afZ: Position along the Z axis.
- afAngleX: Destination X Angle.
- afAngleY: Destination Y Angle (rarely used).
- afAngleZ: Destination Z Angle.
- afSpeed: Movement Speed.
- afMaxRotationSpeed: Maximum rotation Speed (default is 0 to mean "don't clamp the rotation speed") - Negative values cause unpredictable rotation.
Return Value
None.
Examples
; Translate the bird slowly to 0,0,0 with a rotation of 90,90,90
Bird.TranslateTo(0.0, 0.0, 0.0, 90.0, 90.0, 90.0, 1.0)
; Translate the bird slowly to 0,0,0 with a rotation of 90,90,90 with a max rotation speed of 10
Bird.TranslateTo(0.0, 0.0, 0.0, 90.0, 90.0, 90.0, 1.0, 10.0)Tips
A movement speed parameter (afSpeed) of 1 is extremely slow - nearly imperceptible to the human eye. Starting at a an afSpeed of 100 and working up or down towards the desired speed is recommended.