KX_ObjectActuator(SCA_IActuator)

base class — SCA_IActuator

class bge.types.KX_ObjectActuator(SCA_IActuator)

The object actuator (“Motion Actuator”) applies force, torque, displacement, angular displacement, velocity, or angular velocity to an object. Servo control allows to regulate force to achieve a certain speed target.

force

The force applied by the actuator.

Type:list [x, y, z]

useLocalForce

A flag specifying if the force is local.

Type:boolean

torque

The torque applied by the actuator.

Type:list [x, y, z]

useLocalTorque

A flag specifying if the torque is local.

Type:boolean

dLoc

The displacement vector applied by the actuator.

Type:list [x, y, z]

useLocalDLoc

A flag specifying if the dLoc is local.

Type:boolean

dRot

The angular displacement vector applied by the actuator

Type:list [x, y, z]

Note

Since the displacement is applied every frame, you must adjust the displacement based on the frame rate, or you game experience will depend on the player’s computer speed.

useLocalDRot

A flag specifying if the dRot is local.

Type:boolean

linV

The linear velocity applied by the actuator.

Type:list [x, y, z]

useLocalLinV

A flag specifying if the linear velocity is local.

Type:boolean

Note

This is the target speed for servo controllers.

angV

The angular velocity applied by the actuator.

Type:list [x, y, z]

useLocalAngV

A flag specifying if the angular velocity is local.

Type:boolean

damping

The damping parameter of the servo controller.

Type:short

forceLimitX

The min/max force limit along the X axis and activates or deactivates the limits in the servo controller.

Type:list [min(float), max(float), bool]

forceLimitY

The min/max force limit along the Y axis and activates or deactivates the limits in the servo controller.

Type:list [min(float), max(float), bool]

forceLimitZ

The min/max force limit along the Z axis and activates or deactivates the limits in the servo controller.

Type:list [min(float), max(float), bool]

pid

The PID coefficients of the servo controller.

Type:list of floats [proportional, integral, derivate]

reference

The object that is used as reference to compute the velocity for the servo controller.

Type:KX_GameObject or None