rectcopy(3G)							  rectcopy(3G)

NAME    [Toc]    [Back]

     rectcopy -	copies a rectangle of pixels with an optional zoom

C SPECIFICATION    [Toc]    [Back]

     void rectcopy(x1, y1, x2, y2, newx, newy)
     Screencoord x1,y1,	x2, y2,	newx, newy;

PARAMETERS    [Toc]    [Back]

     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.

DESCRIPTION    [Toc]    [Back]

     rectcopy 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 zbuffer,
 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    [Toc]    [Back]

     pixmode, readsource, rectzoom, stencil

NOTES    [Toc]    [Back]

     This subroutine is	available only in immediate mode.

     The Live Video Digitizer option is	available only on the IRIS-4D GTX.

BUGS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 2222