Component: Bitmap Drawer FAT (Displays: Graphical)

Author	Matrix TSL
Version	2.0 (Release)
Category	Displays: Graphical

Bitmap Drawer FAT component

A component to simplify the process of drawing bitmap images to a graphical display. Reads Bitmap files directly from a SD card formatted with a FAT file system. Compatible with 24-bit & Monochrome Bitmaps. The gLCD object property specifies which LCD component to draw the bitmap to.

Examples

The Bitmap Drawer FAT component must be linked to the graphical LCD using the gLCD Object property and to the FAT component using the FAT Object property.

Here is an example which loops drawing a monochrome and 24-bit bitmaps to the EBM001 graphical display.

Bitmap Drawer FAT Demo

The bitmap files used in the example can be found here.

Bitmap Drawer FAT Files

Downloadable macro reference

GetHeight

Returns the height of the loaded bitmap file in pixels.

Parameters

<- STRING Filename

The filename of the bitmap we want to measure

This parameter may be returned back to the caller

Return value

UINT

GetWidth

Returns the width of the loaded bitmap file in pixels.

Parameters

<- STRING Filename

The filename of the bitmap we want to measure

This parameter may be returned back to the caller

Return value

UINT

SetTransparentColour

Sets the transparency colour, the colour that is not drawn when transparency is enabled.

Parameters

BYTE R

BYTE G

BYTE B

Return value

This call does not return a value

Display_BMP

Draws the bitmap image from ROM onto the display at the corrdinates X and Y.

Return Values: 0=OK, 1=ColourDepthNotSupported, 237=FileNotFound

Parameters

<- STRING Filename

Bitmap file to open from current directory on SD card 8.3 format

This parameter may be returned back to the caller

UINT X

X Axis coordinate, specifies the location of the left edge of the bitmap image

UINT Y

Y Axis coordinate, specifies the location of the top edge of the bitmap image

BYTE Orientation

0=Normal, 1=90 Degrees CW, 2=180 Degrees, 3=270 Degrees CW

BYTE Transparency

0=Off, 1=On Don't Draw Any Pixels which match the transparent colour

BYTE Flip

0=Normal, 1=FlipWidth, 2=FlipHeight, 3=FlipBoth

Return value

BYTE

Simulation macro reference

This component does not contain any simulation macros

Property reference

FAT Object

This property is of type Panel object and can be referenced with the variable name fat_obj.

FAT / SD Card Object to read the bitmap image from

gLCD Object

This property is of type Panel object and can be referenced with the variable name glcd_obj.

Graphical LCD Object to draw the bitmap image to

ColourDisplay

This property is of type True or false and can be referenced with the variable name Colour_Display.

Automatically detects if the graphical LCD object is colour or monochrome