copy_bmp_to_screen

Prototypevoid copy_bmp_to_screen(string bmpfile[79])

copy_bmp_to_screen() copies the specified image bmpfile onto the screen. The image must use the resolution 640px x 480px, and should be in the current palette, unless running in true-color mode. If a different palette is used, the game will start using that palette (similar to load_palette).

The specified bmp will cover the background-area of the screen (status bar and tiles), but all sprites will still be visible and act like normal.

Drawing the background will remove the bmp, reverting back to the original tiles. This is useful if you just want to use this function to change the palette without visibly showing the bmp on screen.

Dink

all

• If a different palatte is used, it will only take effect if the game is in 256 colour full-screen mode.
• If a save file is loaded after a palette change, all tiles will revert back to the Dink palette, but sprites will still be use the previously loaded palette. Also, further palette changes might not take effect.

Freedink

all

• If a different palatte is used, it will only take effect if the game is in 256 colour mode.
• It will take effect in both windowed and full-screen mode.
• The palette change always works correctly, and does not mess up after loading a save file.

Copy an image name "tester.bmp" to the screen from the tiles folder:

void main(void)
{
 copy_bmp_to_screen("tiles/tester.bmp");
}