Copy Screen Area

\i M A word::width word::height byte::screen word::pos_x word::pos_y

Parameter	Type	Range	Description
width	word	1 ... display width	width of the area to copy
height	word	1 ... display height	height of the area to copy
screen	byte	M, 0 ... number of screens - 1	index of the screen to copy to (M = main screen)
pos_x	word	0 ... display width - 1	horizontal position to copy the content to
pos_y	word	0 ... display height - 1	vertical position to copy the content to

Copies the content of an area of the currently active draw screen starting from the current cursor position.

• If index exceeds the available screens or width or height exceed the screen size, [NACK] is returned.
• When the selected area exceeds the screen, it is truncated accordingly.
• index can also be set to the currently active draw screen, allowing copying an area to a different position on the same screen.
• Even if the target screen was never selected as draw screen before, it is possible to select it as view screen after copying an area to it.
• If using a DPC3050 iLCD controller, index has to be M in any case.

Response:

[ACK]

Example

\iMA\D25\D45M\D500\D250

This example copies an area of 25 pixels width and 45 pixels height (starting from the current cursor position) from the currently active draw screen to main screen at coordinates x = 500 and y = 250 pixels.

Not supported by: DPC3020, DPC2060, DPC10xx

Screen Memory Related Commands
Copy Screen To
Copy Screen From
Paint Screen From
Set View Screen