layer_vspeed

You can use this function to set the vertical speed (in pixels per game frame) of the layer within the currently scoped room.

You supply the layer ID (which you get when you create the layer using layer_create) or the layer name (as a string - this will have a performance impact) and the speed value to set, where a positive value is downwards and a negative value upwards.

NOTE This function does not affect any Instances already contained or later added in the layer - they remain at their (xy) position - unless those instances are controlled by a sequence (i.e. when in_sequence is true).

 

Syntax:

layer_vspeed(layer_id, vspd)

Argument Type Description
layer_id String or Layer ID The unique ID value of the layer to set the vertical speed of
vspd Real The vertical speed (in pixels per game frame) to set

 

Returns:

N/A

 

Example:

var lay_id = layer_get_id("Sprites");
if layer_get_hspeed(lay_id) != 0 || layer_get_vspeed(lay_id) != 0
{
    layer_hspeed(lay_id, 0);
    layer_vspeed(lay_id, 0);
}

The above code checks the given layer horizontal and vertical speeds and if they are not both set to 0 then it is sets them to 0.