You can use this function to set the horizontal 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 to the right and a negative value to the left.
NOTE This function doesn't affect the position at which Instances on that layer are drawn - they remain at their (x, y) position - unless those instances are controlled by a sequence (see in_sequence for more info).
layer_hspeed(layer_id, hspd)
| Argument | Type | Description |
|---|---|---|
| layer_id | String or Layer | The unique ID value of the layer to set the horizontal speed of |
| hspd | Real | The horizontal speed (in pixels per game frame) to set |
N/A
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.