Fast Models Reference Manual - ARM Information Center

Peripheral and Interface Components
void configureWindow(unsigned int width, unsigned int height, unsigned int bit_depth)
This sets the visualization window to the requested size and bit depth. Depending
on the display capabilities, the window might actually get a different bit depth
from the size you requested.
VisBitmap *loadImage(char const *filename)
This allocates a new VisBitmap object, initialized by loading a Microsoft
Windows Bitmap (.BMP) from the given file.
VisBitmap *loadImageWithAlphaKey(char const *filename, unsigned int red, unsigned int
green, unsigned int blue)
This allocates a VisBitmap object, as with loadImage(). All pixels of the color
specified by red, green, blue are converted into a transparent alpha channel.
VisBitmap *cropImage(VisBitmap *source, int x, int y, unsigned int width, unsigned int
height)
This allocates a new VisBitmap object, by cropping a region from the source
bitmap.
void releaseImage(VisBitmap *)
This releases the resources held by the given VisBitmap. The underlying bitmap
is only be unloaded if it is not in use.
void setBackground(VisBitmap *background, int x, int y)
This sets the background image for the visualization window. This takes a copy
of the data referenced by the VisBitmap, so it is safe for the client to call
releaseImage(background) immediately after calling setBackground(). The
background is not displayed until the first call to poll().
VisRenderRegion *createRenderRegion()
This allocates a new VisRenderRegion object that can be used to display arbitrary
graphics, including LCD contents, in a rectangular region.
VisPushButtonRegion *createPushButtonRegion()
This allocates a new VisPushButtonRegion, which can be placed at a location on
the display to provide a clickable push button.
bool poll(VisEvent *event)
This call allows the visualisation library to poll for GUI events. The client passes
a reference to a VisEvent structure, which receives details of a single
mouse/keyboard event.
The method returns false if no events have occurred.
Your LISA visualization implementations should call this periodically by using a
GUIPoll component. On each gui_callback() event, you must ensure that the
visualization component repeatedly calls poll() until it returns false.
void lockMouse(VisRegion *region)
This method locks the mouse to the visualization window and hides the mouse
pointer.
void unlockMouse()
This unlocks and redisplays the mouse pointer.
ARM DUI 0423J Copyright © 2008-2011 ARM. All rights reserved. 5-153
ID051811
Non-Confidential