Component: GLCD Bitmap Drawer ROM (Graphical Library)

Author	Matrix TSL
Version	2.2
Category	Graphical Library

GLCD Bitmap Drawer ROM component

A component to simplify the process of drawing bitmap images to a graphical display. Stores up to 10 bitmap images inside ROM based look up tables. Compatible with 24-bit / 256 Colour / 16 Colour / Monochrome Bitmaps. The gLCD object property specifies which LCD component to draw the bitmap to. Compatible with GLCD, NeoPixel, MIACv3, HT16K33

Component Pack

DISPLAYS

Detailed description

No detailed description exists yet for this component

Examples

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

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

Bitmap Drawer Demo

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

Bitmap Drawer Files

Here is another example which overlays several monochrome images to give the impression of animation. Shows a pair of eyes, which can randomly and momentarily look left, right or blink.

Bitmap Drawer Demo 2

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

Bitmap Drawer Files 2

Downloadable macro reference

	GetHeight
Returns the height of the loaded bitmap file in pixels.
- BYTE	BitmapIndex
Selects from attached bitmaps. Range: 0-9
- UINT	Return

	GetWidth
Returns the width of the loaded bitmap file in pixels.
- BYTE	BitmapIndex
Selects from attached bitmaps. Range: 0-9
- 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.
- BYTE	BitmapIndex
Selects from attached bitmaps. Range: 0-9
- 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
- VOID	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. Currently only supports colour displays.
- BYTE	BitmapIndex
Selects from attached bitmaps. Range: 0-9
- 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	Transparency
0=Off, 1=On Don't Draw Any Pixels which match the transparent colour
- VOID	Return

Property reference

	Properties
	gLCD Object
Graphical LCD Object to draw the bitmap image to
	ColourDisplay
Automatically detects if the graphical LCD object is colour or monochrome
	ROM Bytes
Total number of ROM bytes used to store attached bitmap images.
	Number of Bitmaps
Number of bitmaps the component can store and draw to the LCD. Min 1 / Max 10
	Bitmap 0
	Bitmap File
Bitmap file you wish to embed into the program. Compatible with .bmp files in the following formats: 24-Bit / 256 Colour / 16 Colour / Monochrome
	File Colour Depth
Number of bits per pixel. Currently the component only supports bitmap files with 1-bit or 24-bit colour depth.
	File Length
The number of bytes of ROM the bitmap file will consume. You can vie wthe number of ROM bytes available on your target device using the Device Helper component.
	File Width
Width of the bitmap file in pixels
	File Height
Height of the bitmap file in pixels
	Data Offset
Offset in the file where the bitmap pixel data starts