Debug drawing

Last updated 2 August 2011

ep_gm_functions_init

ep_gm_functions_init()

Initializes GM functions, for GM6, GM7 and GM8. It doesn't work in GM8.1, use the next function instead. You should call this function before using debug drawing. Don't rely on this function, use it only for debugging purposes.

Returns whether successful.

ep_gm_functions_init_address

ep_gm_functions_init_address(address)

Same as the previous function, but for GM8.1. It should be called like this:

ep_gm_functions_init_address(get_function_address("get_function_address"));

get_function_address was added in GM 8.1.106. If you get an error message saying the function can't be found, you should update Game Maker.

Returns whether successful.

ep_debugdraw_set_transformation

ep_debugdraw_set_transformation(translation_x, translation_y, rotation, scale)

Sets a transformation that will be used for debug drawing. The transformations are performed in this order: scale, rotate, translate.

• translation_x: The x component of the translation vector.
• translation_y: The y component of the translation vector.
• rotation: The rotation (in radians).
• scale: The scale factor.

ep_debugdraw_bodies

ep_debugdraw_bodies(world_id, color_static, color_dynamic)

Draws the outline of all bodies.

• world_id: The id of the world.
• color_static: The color of static bodies.
• color_dynamic: The color of dynamic bodies.

ep_debugdraw_links

ep_debugdraw_links(world_id, color_shapelink, color_contactlink, color_jointlink)

Draws links between connected bodies.

• world_id: The id of the world.
• color_shapelink: The color of shape links.
• color_contactlink: The color of contact links.
• color_jointlink: The color of joint links.

ep_debugdraw_views

ep_debugdraw_views(world_id, color_view)

Draws the outline of all views.

• world_id: The id of the world.
• color_view: The color of views.

ep_debugdraw_velocity

ep_debugdraw_velocity(world_id, color_velocity, scale, rotscale)

Draws the velocity vector of all bodies.

• world_id: The id of the world.
• color_velocity: The color of velocity vectors.
• scale: The scale of velocity vectors.
• rotscale: The scale of rotational velocity circles (use 0 to disable this).

ep_debugdraw_forces

ep_debugdraw_forces(world_id, color_force, scale, rotscale)

Draws important forces. This includes contacts, joints, joint limits and forces. This does not include springs and gravity.

• world_id: The id of the world.
• color_force: The color of forces.
• scale: The scale of force vectors.
• rotscale: The scale of torque circles (use 0 to disable this).

ep_debugdraw_constraints

ep_debugdraw_constraints(world_id, color_contactpoint, color_joint)

Draws all contacts and joints.

• world_id: The id of the world.
• color_contactpoint: The color of contact points.
• color_hinge: The color of joints.