rectco(3G)

NAME
     rectco - copies a rectangle of pixels with an optional zoom

FORTRAN 77 SPECIFICATION
     subroutine rectco(x1, y1, x2, y2, newx, newy)
     integer*4 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.

DESCRIPTION
     rectco 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 readso 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 rectzo 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, pixmod
     can be used to greatly affect the copy operation.  Pixel shifts,
     reflections, and numeric offsets are all possible.

     Use frontb, backbu, and zdraw to specify the destination.  All
     coordinates are relative to the lower-left corner of the window.

     The result of rectco is undefined if zbuffe is .TRUE., except when pixel
     mode PMZDAT is enabled (see pixmod).  This special pixel mode, in
     conjunction with stencil operation, can be used to implement rectangle
     copies with depth buffering.

     rectco always operates within the currently active framebuffer, as
     specified by drawmo.
     rectco leaves the current character position unpredictable

SEE ALSO
     pixmod, readso, rectzo, stenci

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.