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

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

===== LOAD TILE  =====

===== SYNTAX =====
     = LOAD TILE( filename [AS alias][,mode] ) [fl]
         fl : [FLIP X] [FLIP Y] [FLIP XY] [FLIP YX]
         fl : [ROLL X] [ROLL Y] [ROLL XY] [ROLL YX]

==== PURPOSE ====


The ''LOAD TILE'' command allows you to load an image and to convert it into 
an ''TILE'', that is a format that will be converted into a way that can be efficiently drawn 
on the screen using the tiles. The second parameter is the mode to use to convert 
the given data (by default, it is equal to current mode) 

The command support a set of modern image format, like JPEG baseline & progressive,
PNG 1/2/4/8/16-bit-per-channel, TGA, BMP (non-1bpp, non-RLE), PSD 
(composited view only, no extra channels, 8/16 bit-per-channel), 
GIF, HDR (radiance rgbE format), PIC (Softimage PIC) and PNM (PPM and PGM 
binary only) The image will be converted into a way that can be 
efficiently drawn on the screen. 

Since it is possible to load only one file of the same 
type at a time, it is necessary to be able to indicate an "alias" with 
which to exceed this limit. In this regard, there is also 
the ''AS'' syntax, which allows you to load the same file several 
times but with different names. 

A series of flags, separated by spaces, can be added at loading time 
to modify the behavior of ugBASIC.

The ''FLIP X'' flag allows you to flip the image horizontally,
before translating it into the native format. The same is true for the 
''FLIP Y'' command, which instead inverts the image vertically. 
There is also the ''FLIP XY'' (or ''FLIP YX'') parameter to act, 
simultaneously, on both directions.

The ''COMPRESSED'' flag allows you to compress the image, if 
possible. Compression is a space-saving mechanism, in which the 
native data of the image is represented in a more compact form, 
which ugBASIC will be able to quickly convert into graphics at 
the appropriate time.

The ''ROLL X'' flag allows you to SHIFT the (entire) image horizontally,
for the entire size of a frame, in order to generate intermediate
frames. The very same for ''ROLL Y'' command, which does the same
vertically. There is also the ''ROLL XY'' (or ''ROLL YX'') parameter to act, 
simultaneously, on both directions.



==== EXAMPLE ====
    starship = LOAD TILE("starship.png")
    starship2 = LOAD TILE("starship.png" AS "starship2")
    alienAt11 = LOAD TILE("alien.jpg",11)
    alien2 = LOAD TILE("alien.jpg" AS "alien2",11)


==== ABBREVIATION ====
   LdTl


==== AVAILABLE ON ====


==== ALIAS FOR ====
[[TILE LOAD]] 

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

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