Changes the frame
of the spritesheet image
with the specified id
. Has no effect if the image
is not a spritesheet.
starts with 1 for the first frame. If you attempt to set the frame
lower than 1 or larger than the maximum number of frames, the frame will be set to the first or last frame respectively.
The frames are numbered from left to right and from top to bottom. So the top left frame is frame number 1 and the bottom right frame is the last frame. See image below for an example spritesheet with 4 frames.
Sample 1: Creating a spritesheet and changing the frame
The used image
must be a loaded as a spritesheet image
with the image
-command so it has multiple frames!
frame is 1-based for this command. Meaning that the first frame is frame 1 and the last possible frame of an image with N frames is frame number N.
If you want to animate a spritesheet you should use tween_animate
instead (causes less traffic than changing the frame manually multiple times)!