rectcopy(3G)rectcopy(3G)NAMErectcopy - copies a rectangle of pixels with an optional zoom
C SPECIFICATION
void rectcopy(x1, y1, x2, y2, newx, newy)
Screencoord x1,y1, x2, y2, newx, newy;
PARAMETERS
x1 expects the x coordinate of one corner of the rectangle.
y1 expects the y coordinate of one corner of the rectangle.
x2 expects the x coordinate of the opposite corner of the rectangle.
y2 expects the y coordinate of the opposite corner of the rectangle.
newx expects the x coordinate of the lower-left corner of the new
position of the rectangle.
newy expects the y coordinate of the lower-left corner of the new
position of the rectangle.
DESCRIPTIONrectcopy copies a rectangular array of pixels (x1, y1, x2, y2) to another
position on the screen. The current viewport and screenmask mask the
drawing of the copied region. Self-intersecting copies work correctly in
all cases.
Use readsource to specify the front buffer, the back buffer, the z-
buffer, or the optional Live Video Digitizer frame buffer as the source.
When using the Live Video Digitizer as the readsource, the coordinate
arguments should be specified relative to a video origin of (0,0).
On machines that support it, you can use rectzoom to independently zoom
the destination in both the x and y directions. Self-intersecting copies
with zoom also work correctly. Likewise, on machines that support it,
pixmode can be used to greatly affect the copy operation. Pixel shifts,
reflections, and numeric offsets are all possible.
Use frontbuffer, backbuffer, and zdraw to specify the destination. All
coordinates are relative to the lower-left corner of the window.
The result of rectcopy is undefined if zbuffer is TRUE, except when pixel
mode PM_ZDATA is enabled (see pixmode). This special pixel mode, in
conjunction with stencil operation, can be used to implement rectangle
copies with depth buffering.
rectcopy always operates within the currently active framebuffer, as
specified by drawmode.
Page 1
rectcopy(3G)rectcopy(3G)rectcopy leaves the current character position unpredictable
SEE ALSO
pixmode, readsource, rectzoom, stencil
NOTES
This subroutine is available only in immediate mode.
The Live Video Digitizer option is available only on the IRIS-4D GTX.
BUGS
Pixel format is not considered during the copy. For example, if you copy
pixels that contain color index data into an RGB window, the display
subsystem cannot correctly interpret it.
On IRIS-4D GTX models the zoom factor is not applied when reading from
the Live Video Digitizer's frame buffer.
Page 2
