DEMO version ! After registering you will receive a complete version.

Description

This function displays a BMP image on screen. It is included especially for
large images which are displayed only once.
For instance, if you want to display an 1024x768 image in 256 colors, you
don't want to load this image into an array (that would require at least
768kB and a lot of time and effort !).
With FGLShowBmp() you can display the image directly to the screen.
The upperleft corner of the image will be located at ('X','Y').

If you show an image which is stored in more colors than the current color
mode (for instance, an 24 bits picture in 256 color mode), for
every pixel the closest match in the current palet is found.
This method is, of course, dead-slow. If you don't have an optimal palet,
it also mostly gives poor results.

There are two methods to load/display your images in 16 and 256 color mode.
Method one is with a free palette. With this option, the palette of the
image you load will be loaded instead of the current palette. This often
means with 256 color images that all the colors on your screen will change.
This is because different images use different palettes.
If you have never worked with palettes, look at the demo program to see what
happens.  Almost all graphical libraries only have this option.  Unlike other
libraries, Ferns' Graphics Library offers an alternative to loading a palette
and (probably) changing everything that's on your screen. With Ferns' Graphics
Library, you have the option to load your images with a fixed palette. When a
image is loaded, every color in the image is mapped on the current palette (it
finds the closest match).  This means that your current screen isn't changed
and you can load as many images with different palettes as you like ! If you
have a near optimal palette (like the standard palette of Ferns' Graphics
Library), the results will almost always be satisfactory.  See the demo
program to see the difference.
Clipping is performed.


This function can be used only if you have set the screen to a graphic mode
using FGLSetMode().


Syntax

 FGLShowBMP(< X >,< Y >,< Filename >[, FGL_FIXEDPALETTE | FGL_FREEPALETTE ])
                                                 -> Result.