Display Local Graphic

\i G word::graphic_index

Parameter	Type	Range	Description
graphic_index	word	0 ... max. graphic index	index of the graphic

by name:

\i G by_name::graphic_name

Parameter	Type	Range	Description
graphic_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated graphic name

by filename:

\i G by_file::graphic_filename

Parameter	Type	Range	Description
graphic_filename	by_file	DOS filename (8.3 format)	name and path of the graphics file

Draws a graphic according to the graphic's graphic_index, graphic_name or graphic_filename at the current cursor position.

• If no graphic with graphic_index, graphic_name or graphic_filename is available, [NACK] is returned.
• Graphic alignment is taken into account (refer to Set Graphic Alignment). If the alignment area is smaller than the specified graphic, it will be cropped accordingly.
• When addressing by index, the graphic offset (see Set Graphic Offset) is taken into account.
• When addressing by name, the graphic prefix (refer to Set Graphic Name Prefix) and suffix (refer to Set Graphic Name Suffix) are taken into account.
• The cursor position is not changed.
• If an alpha value other than 255 was set before (see Set Alpha), filling is done with the according opacity.
• Any previously set adjustments for graphics are taken into account (see Set Adjustment for Graphics).
• Additional to the by_name and by_file indices, the graphic_index range from 0xFFE0 to 0xFFFF is reserved for internal use!
• When inverse mode is on, the graphic is shown in inverse mode.
• Graphics with transparencies are always drawn transparent, regardless of the transparent mode (see Set Transparent Mode On/Off).
• Monochrome graphics drawn on a color iLCD panel have the originally black pixels shown in the current foreground value and the originally white pixels shown in the current background color allowing to "dye" monochrome graphics.
• While graphics with a color depth of 8 bit occupy less space in the memory, 16 bit graphics are drawn faster as there is no need for converting calculations.
• To show a graphic from the MicroSD card, the file has to be converted into in the RII (Raw iLCD Graphics Image) format. To do that, use the "Save As" button on iLCD Manager XE's "Graphics" page and select the *.rii filetype.
• When a graphic is stored on the MicroSD card automatically (by activating the option "Store graphics to SD card" in the "Project Settings" section of iLCD Manager XE's "Settings" page), it can still be addressed by its index or name as if they would be stored in flash memory. Graphics stored manually on the MicroSD card can only be loaded by their filenames.

Response:

[ACK]

Example

\iG\D1
\iG\mGRAPHIC\0
\iG\fDIR/FILE.RII\0

Displays the graphic with index 1 and graphic "GRAPHIC" from the on-board flash as well as graphic "FILE.RII" from the SD card's "DIR" folder at the current cursor position.

Get Graphic Info
Set Graphic Alignment
Display Graphic Area
Set Graphic Offset
Set Graphic Name Prefix
Set Graphic Name Suffix
Set Alpha
Set Adjustment for Graphics
Load Animated Graphics