{{htmlmetatags>metatag-robots=()
metatag-title=(FRAMES | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for FRAMES)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(FRAMES | ugBASIC User Manual) 
metatag-og:description=(Manual page for FRAMES)
}}

====== 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:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_load_06.bas|images_load_06.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/multitasking_example_06.bas|multitasking_example_06.bas]]''


==== 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 [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON FRAMES|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]