physics_apply_local_impulse

Description

Not only can you apply force and gravity to an object with the physics in GameMaker Studio 2 but you can also apply an impulse. This is slightly different to a force in that when it is applied it will immediately affect the speed, and, potentially the torque (or "spin") of the object, particularly if the point chosen to apply the impulse has a vector that is not aligned with the centre of mass (note: the center of mass is not necessarily the same as the origin!). This function applies an impulse locally to an instance. What this means is that the strength and direction of the impulse are calculated based on the origin (or the position if it has no sprite) of the instance, without taking into consideration the direction or rotation it may have in the game room or physics world. Here is an illustration: As you can see, the frog in the image gets an impulse from below to make it "jump". The exact impulse is defined by the vector we get from the components ximpulse/yimpulse in relation to the xpos/ypos coordinates - which simply means that the impulse is calculated as the distance from xpos/ypos to ximpulse/yimpulse in Newtons, and the direction is the angle that we get from xpos/ypos to ximpulse/yimpulse.

NOTE: The physics world uses meters for all its calculations, and the ratio of pixels per meter is defined in the room editor or using physics_world_create.

Syntax:

physics_apply_local_impulse(xpos, ypos, ximpulse, yimpulse)

Argument Description
xpos The x coordinate relative to the origin where the impulse will be applied
ypos The y coordinate relative to the origin where the impulse will be applied
ximpulse the x component of the impulse vector (relative to the xpos coordinate)
yimpulse the y component of the impulse vector (relative to the ypos coordinate)

N/A

Example:

if jump physics_apply_local_impulse(0, 20, 0, 50);

The code above will apply an impulse with force of 30 Newtons and a direction going from bottom to top relative to the instance origin if the variable "jump" is true.