Set Filling Tile

\i A P T word::graphic_index

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

by name:

\i A P T by_name::graphic_name

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

by filename:

\i A P T by_file::graphic_filename

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

Sets the active fill pattern to tiling using the graphic specified by graphic_index, graphic_name or graphic_filename as tiles. All subsequent filling will be done with this tile graphic.

• If no graphic with graphic_index, graphic_name or graphic_filename is available, [NACK] is returned.
• 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.
• Display and area filling can be done with scaled tiles (refer to Set Graphics Scaling). Scaling will be ignored when drawing filled shapes (e.g. Draw Rectangle) though.
• When filling with a tile graphic, any previously set adjustments for graphics are taken into account (see Set Adjustment for Graphics) at the time filled drawing is done.
• The text/graphic orientation is ignored when filling with tiles (refer to Set Text/Graphic Orientation).

Response:

[ACK]

Example

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

Sets the graphic with index 1, graphic "GRAPHIC" from the on-board flash and graphic "FILE.RII" from the SD card's "DIR" folder as the fill pattern. Only the last successfully set tile graphic is used for future filling.

Not supported by: DPC3020, DPC2060, DPC10xx

Fill Display
Fill Display Area
Set Filling Color
Set Filling Gradient
Set Adjustment for Graphics
Draw Rectangle
Draw Styled Circle