Component: GLCD Bitmap Drawer FAT (Graphical Library)

Author	Matrix TSL
Version	2.2
Category	Graphical Library

GLCD 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. Compatible with GLCD, NeoPixel, MIACv3, HT16K33

Component Pack

STORAGE

Detailed description

No detailed description exists yet for this component

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.
- STRING	Filename
The filename of the bitmap we want to measure
- UINT	Return

	GetWidth
Returns the width of the loaded bitmap file in pixels.
- STRING	Filename
The filename of the bitmap we want to measure
- UINT	Return

	SetTransparentColour
Sets the transparency colour, the colour that is not drawn when transparency is enabled.
- BYTE	R
- BYTE	G
- BYTE	B
- VOID	Return

	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
- STRING	Filename
Bitmap file to open from current directory on SD card 8.3 format
- 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
- BYTE	Return

	Display_BMP_Fast
Draws the bitmap image from ROM onto the display at the corrdinates X and Y. Attempts to draw a row at a time by not forcing coordinates for every pixel so may not work on some displays. Return Values: 0=OK, 1=ColourDepthNotSupported, 237=FileNotFound
- STRING	Filename
Bitmap file to open from current directory on SD card 8.3 format
- 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
- BYTE	Return

Property reference

	Properties
	FAT Object
FAT / SD Card Object to read the bitmap image from
	gLCD Object
Graphical LCD Object to draw the bitmap image to
	ColourDisplay
Automatically detects if the graphical LCD object is colour or monochrome
	Connections
	Simulations