FRAMES

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.

SYNTAX

 = FRAMES(images)


Legend
  • id : identifier
  • type : datatype
  • v : value
  • "..." : string
  • [...] : optional

EXAMPLE

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


Used in:

ABBREVIATION: Frs

Join BASIC 10Liner Contest with ugBASIC!

An interesting competition is held at the beginning of each year: the BASIC 10Liner Contest. It is possible to use ugBASIC to participate in the next "BASIC10Liner" competition, in the following categories:

  • PUR-120 - A game in 10 lines of max 120 characters (w/abbrev.)
  • EXTREME-256 - A game in 10 lines of max 256 characters (w/abbrev.)
  • SCHAU - Any program in 10 lines of max 256 characters (w/abbrev.)
In order to reduce space you can use this abbreviation for this instruction:

FRAMES ↔ Frs

Any problem?

If you have found a problem with this keyword, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO KEYWORDS