Type Method

applyImpulse:duration:

Creates an action that applies an impulse to the center of gravity of a physics body.

Declaration

+ (SKAction *)applyImpulse:(CGVector)impulse duration:(NSTimeInterval)duration;

Parameters

impulse

A vector that describes how much momentum to impart to the body in each dimension over the duration of the action. The impulse is measured in Newton-seconds.

sec

The duration over which the total impulse should be applied to the physics body.

Return Value

A new action object.

Discussion

When the action executes, applies a constant force to the physics body for the duration of the action. The force is calculated by dividing the impulse strength by the duration of the action. For example, if an impulse of 1 Newton-second is applied to the physics body, and the the duration is 10 seconds, then a force of 0.1 Newtons is applied to the physics body.

This action is reversible; it applies an equal impulse in the opposite direction.

See Also

Animating Properties of a Node's Physics Body

+ applyForce:duration:

Creates an action that applies a force to the center of gravity of a node’s physics body.

+ applyTorque:duration:

Creates an action that applies a torque to a node’s physics body.

+ applyForce:atPoint:duration:

Creates an action that applies a force to a specific point on a node’s physics body.

+ applyAngularImpulse:duration:

Creates an action that applies an angular impulse to a node’s physics body.

+ applyImpulse:atPoint:duration:

Creates an action that applies an impulse to a specific point of a node’s physics body.

+ changeChargeTo:duration:

Creates an action that changes the charge of a node’s physics body to a new value.

+ changeChargeBy:duration:

Creates an action that changes the charge of a node’s physics body by a relative value.

+ changeMassTo:duration:

Creates an action that changes the mass of a node’s physics body to a new value.

+ changeMassBy:duration:

Creates an action that changes the mass of a node’s physics body by a relative value.

+ strengthTo:duration:

Creates an action that animates a change of a physics field’s strength.

+ strengthBy:duration:

Creates an action that animates a change of a physics field’s strength to a value relative to the existing value.

+ falloffTo:duration:

Creates an action that animates a change of a physics field’s falloff.

+ falloffBy:duration:

Creates an action that animates a change of a physics field’s falloff to a value relative to the existing value.