Rice Lake iRite IDE - Manual (Page 96)

92 920i Programming Reference
6.6 920i User Graphics
iRite user programs can be used to display graphics. The entire 920i display is writeable; graphics can be of any
size, up to the full size of the 920i display, and up to 100 graphic images can be displayed. The actual number of
graphics that can be loaded depends on the size of the graphics and of the user program, both of which reside in
the user program space.
Graphics used in iRite programs can be from any source but must be saved as monochrome bitmap (.bmp) files
with write access (file cannot be read-only). To enable the file for use in an iRite program, it is converted to a user
program #include (.iri) file using the bmp2iri.exe program (see Figure 6-1).
prompt.bmp
bitmapped graphic DOS command window: run bmp2iri.exe
C:\bmp2iri prompt
C:\
bmp2iri.exe
g_Prompt : DisplayImage;
Procedure initPrompt;
begin
g_Prompt [1] := 16;
g_Prompt [1] := 16;
g_Prompt [1] := 132153342;
g_Prompt [1] := 2147368956;
g_Prompt [1] := 536350704;
g_Prompt [1] := 2147385342;
g_Prompt [1] := 1073483760;
g_Prompt [1] := 2122218558;
g_Prompt [1] := 1010572920;
g_Prompt [1] := 132121536;
...
bitmap.iri file
Figure 6-1. Example of Converting Bitmapped Graphic (prompt.bmp) to an .iri File
Figure 6-1 shows the conversion process for a graphic file, prompt.bmp, to a user program #include, bitmap.iri.
The conversion is done by running the bmp2iri.exe program in a DOS command window: note that the bmp2iri
program assumes the .bmp extension for the input graphic file (prompt.bmp). If additional files are converted
using bmp2iri.exe, the output of the program is appended to the bitmap.iri file.
To display the graphic, the bitmap.iri file must be incorporated into the user program by doing the following:
• In the iRite source (.src) file, immediately following the program declaration, add: #include
bitmap.iri
• In the startup handler, call the array initialization routine for each graphic.
• To display or erase a graphic, or to clear all graphics, call the DrawGraphic API with the appropriate
parameters (see page 67).