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

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

===== NEW IMAGE ✓ =====

===== SYNTAX =====
     = NEW IMAGE( width, height )

==== PURPOSE ====


The ''NEW IMAGE'' command allows you to define a memory area where you can 
store an image coming from the screen (with the ''GET IMAGE'' command), or 
from another graphic resource. 

The area must be defined by (constant) width and (constant) height, expressed in pixels. The actual size, 
in terms of bytes of RAM, will depend on the graphics mode selected at the time. 

If it is not possible to define an image in that screen mode, a specific error will be issued.



==== EXAMPLE ====
    background = NEW IMAGE(32,32)


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/contrib_cube.bas|contrib_cube.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/contrib_cube2.bas|contrib_cube2.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_get_01.bas|images_get_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_get_02.bas|images_get_02.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_get_03.bas|images_get_03.bas]]''


==== ABBREVIATION ====
   NwIm


==== AVAILABLE ON ====


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

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