BGIMAGE
Syntax |
BGIMAGE [#ch,] filename |
Location |
SMSQ/E v2.98+ |
This command allows you to load a screen image as a wallpaper to cover the whole of the available screen (in any resolution).
A valid window channel must be open, default #1 (or #0 on a SBASIC with only #0 open), although one may also be supplied as #ch.
The file will need to be a screen snapshot - the Photon JPEG viewer can be used to convert JPEG files to screen snapshots.
Example
BGIMAGE win1_wallpapers_cats - load a wallpaper.
NOTE
The command expects the screen to have been saved in the current resolution and colour depth, therefore any attempt to load a screen image in a different resolution or colour depth to the one in existence when the screen was saved will result in a corrupt image.
CROSS-REFERENCE
SBYTES gives details on how to store a screen on disk.
In many ways, this command is similar to LOADPIC, except that it caters for non-standard QL resolutions and colour depths.
BGCOLOUR_QL and BGCOLOUR_24 can be used to set a single colour wallpaper.