Table of Contents

ugBASIC User Manual

FRAMES ✓

SYNTAX

   = FRAMES(images)

PURPOSE

This function allows you to obtain the number of frames that make up a set of images (ATLAS). If applied to a single image resource (IMAGE), however, it always returns 1. The value is obtained by retrieving it from the resource itself, and therefore is constant for the entire duration of the execution.

There is also a compile-level function for this keyword, which is called when the value is used to initialize a constant. In this case, the value is that taken from inspecting the instructions at the time of compilation.

EXAMPLE

  animazione := LOAD ATLAS("images.png") FRAME SIZE (16, 16)
  FOR i = 0 TO FRAMES(animazione)
     PRINT "frame ";i
  NEXT

See also the following example files:

ABBREVIATION

 Frs

AVAILABLE ON

ALIAS FOR

FRAME IMAGES COUNT IMAGE COUNT FRAMES COUNT FRAME COUNT

ANY PROBLEM?

If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please open an issue for this keyword on GitHub. Thank you!

POWERED BY