Copy Viewport

\i C V C byte::screen byte::viewport bool::copy_content word::pos_x word::pos_y

Parameter	Type	Range	Description
screen	byte	M, 0 ... number of screens - 1	index of the screen to copied to (M = main screen)
viewport	byte	1 ... 8	index of the new viewport
copy_content	bool	0 ... 1	copy display content (1) or just the parameters (0)
pos_x	word	0 ... display width - 1	x coordinate for the new viewport's origin
pos_y	word	0 ... display height - 1	y coordinate for the new viewport's origin

Creates a new viewport with viewport as index at the specified position (pos_x and pos_y) of the selected screen and assigns all attributes of the currently selected viewport to it.

• Creating a new viewport with this command will also update the target screen's cursor position to the specified origin coordinates.
• The new viewport will inherit the dimensions (width and height) of the source viewport in any case.
• Depending on the boolean value copy_content the new viewport will have the same content (every pixel) as the currently active viewport. If the currently active viewport contains a running animation, only a screenshot of the currently shown frame is copied.
• screen can also be set to the currently active draw screen, allowing to copy a viewport 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 a viewport to it.

Response:

[ACK]

Example

\iCVC\0\2\1\D45\D60

On screen #0, a new viewport with an index of 2 and the same dimensions as the previously selected viewport is created. It has the same content as the selected viewport, its origin is at the coordinates x = 45 and y = 60. The cursor position of screen #0 is also set to this position.

Not supported by: DPC3020, DPC2060, DPC10xx

Concept of Viewports