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

====== ugBASIC User Manual ======

===== IMAGES COUNT ✓ =====

===== SYNTAX =====
     = IMAGES COUNT(images)

==== PURPOSE ====


This function allows you to obtain the number of frames that make up a set of images (''IMAGES'').
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 IMAGES("images.png") FRAME SIZE (16, 16)
    FOR i = 0 TO IMAGES COUNT(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 ====
   Ims C%


==== AVAILABLE ON ====
  * Atari (400/800)
  * Atari XL/XE
  * Commodore 128 (MOS 8502)
  * Commodore 128 (Zilog Z80)
  * Commodore 64
  * Commodore 64+REU
  * TRS-80 Color Computer
  * TRS-80 Color Computer 3
  * ColecoVision
  * Amstrad CPC 664
  * Dragon 32
  * Dragon 64
  * Thomson MO5
  * Thomson MO5
  * Olivetti Prodest PC128
  * Commodore PLUS/4
  * SEGA SC-3000
  * SEGA SG-1000
  * VG-5000
  * Commodore VIC-20
  * ZX Spectrum 48


==== 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 IMAGES COUNT|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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