physics_joint_get_value

This function tests a joint and returns a value depending on the type of joint being tested and the constant being used.

Syntax:

physics_joint_get_value(joint, value)

Returns: Real

Description

By using a series of predefined constants, you can ask GameMaker: Studio to tell you a number of things about the state of any given joint. This is very useful as it gives you the ability to delete joints or change an instances behaviour depending on whatever your needs are at the time. There are a number of constants that can be used in this function and they can be found here: Physics Joint Constants, but be aware that complex calculations are done when you call these, so they should be used with care and only when necessary and note that many are unique to a specific type of joint.

If the property does not exist (if, for example, you check a pulley joint for prismatic translation) then 0 will be the return value.

Example:

var reactionForceX, reactionForceY, reactionForce;
if shipJoint
   {
   reactionForceX = physics_joint_get_value(shipJoint, phy_joint_reaction_force_x);
   reactionForceY = physics_joint_get_value(shipJoint, phy_joint_reaction_force_y);
   reactionForce = point_distance(0, 0, reactionForceX, reactionForceY);
   if reactionForce > 2
      {
      physics_joint_delete(shipJoint);
      shipJoint = -1;
      }
   }

The above code checks to see if the variable "shipJoint" holds a joint index and if it does, it then calculates the force being applied to that joint using the two constants. Finally, if the total force is greater than 2, the joint is deleted.

© Copyright YoYo Games Ltd. 2018 All Rights Reserved