Display Graphic Area

\i g A word::start_x word::start_y word::width word::height word::graphic_index

Parameter	Type	Range	Description
start_x	word	0 ... graphic width - 1	horizontal offset in graphic
start_y	word	0 ... graphic height - 1	vertical offset in graphic
width	word	1 ... graphic width	width of the area to display
height	word	1 ... graphic height	height of the area to display
graphic_index	word	0 ... max. graphic index	index of the graphic

by name:

\i g A word::offset_x word::offset_y word::width word::height by_name::graphic_name

Parameter	Type	Range	Description
start_x	word	0 ... graphic width - 1	horizontal offset in graphic
start_y	word	0 ... graphic height - 1	vertical offset in graphic
width	word	1 ... graphic width	width of the area to display
height	word	1 ... graphic height	height of the area to display
graphic_name	by_name	ASCII chars (0x01 .. 0xFF)	0-terminated graphic name

by filename:

\i g A word::offset_x word::offset_y word::width word::height by_file::graphic_filename

Parameter	Type	Range	Description
start_x	word	0 ... graphic width - 1	horizontal offset in graphic
start_y	word	0 ... graphic height - 1	vertical offset in graphic
width	word	1 ... graphic width	width of the area to display
height	word	1 ... graphic height	height of the area to display
graphic_filename	by_file	DOS filename (8.3 format)	name and path of the graphics file

Draws a part of 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.
• If one of the offsets x or y exceeds the graphic dimensions, a [NACK] is returned. Coordinates scaling is not taken into account for these values, as they refer to the graphic and not to the screen (refer to Set Column Coordinates Scaling and Set Row Coordinates Scaling).
• Graphic alignment is taken into account (refer to Set Graphic Alignment). If the alignment area is smaller than the specified graphic area, 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 convert an image to a Raw iLCD Graphics Image, use the "Save As" button on iLCD Manager XE's "Graphics" page and select the *.rii filetype.
• Graphics stored manually on the MicroSD card can be loaded by their filenames, but not by their graphic names.

Response:

[ACK]

Example

\igA\D10\D20\D100\D200\D5
\igA\D10\D20\D100\D200\mGRAPHIC\0
\igA\D10\D20\D100\D200\fDIR/FILE.RII\0

Displays an area (100x200 pixel from pixel at position 10/20) of graphic with index 5 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.

Not supported by: DPC3020, DPC2060, DPC10xx

Display Local Graphic
Set Graphic Alignment
Set Graphic Offset
Set Graphic Name Prefix
Set Graphic Name Suffix
Set Alpha
Set Adjustment for Graphics