Physics Basic Shape: Rotate

Rotate the shape until it is at the specified orientation.

Only one rotation can be performed at a time. If this function is called before a previous rotation has completed, the first rotation will stop where it is, and the new rotation will start from that point.

🔁 Function

void Rotate(direction, tilt, roll, dirSpeed, tiltSpeed, rollSpeed);

void Rotate(direction, tilt, roll, dirSpeed, tiltSpeed, rollSpeed, dirAcc, dirDec, tiltAcc, tiltDec, rollAcc, rollDec);

void Rotate(direction, tilt, roll, dirSpeed, tiltSpeed, rollSpeed,CallbackFunction);

void Rotate(direction, tilt, roll, dirSpeed, tiltSpeed, rollSpeed,CallbackFunction, dirAcc, dirDec, tiltAcc, tiltDec, rollAcc, rollDec);

⚙️ Parameters

Name	Type	Description
`Direction`	Number	The direction to move the shape’s Direction towards, in degrees.
`Tilt`	Number	The tilt to move the shape’s Tilt towards, in degrees.
`Roll`	Number	The roll to move the shape’s Roll towards, in degrees.
`dirSpeed`	Number	The speed to modify the direction in, in degrees per second.
`tiltSpeed`	Number	The speed to modify the tilt in, in degrees per second.
`rollSpeed`	Number	The speed to modify the roll in, in degrees per second.
`CallbackFunction`	function(shape, direction, tilt, roll)	This function will be called with the shape instance and the direction tilt and roll in degrees when the rotation is completed.
`dirAcc`	Number	Acceleration of direction rotation in degrees/second^2.
`dirDec`	Number	Deceleration of direction rotation in degrees/second^2.
`tiltAcc`	Number	Acceleration of tilt rotation in degrees/second^2.
`tiltDec`	Number	Deceleration of tilt rotation in degrees/second^2.
`rollAcc`	Number	Acceleration of roll rotation in degrees/second^2.
`rollDec`	Number	Deceleration of roll rotation in degrees/second^2.

📝 Example

function OnSimulationStart()
{
    let shape = GetComponentByNameAndType("PhysicsBasicShape1", "Physics Basic Shape");
    shape.Rotate(20, 30, 40, 5, 3, 2, OnRotateComplete);
}

function OnRotateComplete(sender,  direction,  tilt,  roll)
{
    LogDebug(`${sender.Name} = ${direction} ${tilt} ${roll}`);
}