XPRINT COPY statement

Purpose | Copy a bitmap to a host printer page.
Syntax | XPRINT COPY hbmpSource???, id& [, style&] XPRINT COPY hbmpSource???, id& TO (x!, y!) [, style&] XPRINT COPY hbmpSource???, id&, (x1!, y1!)-(x2!, y2!) TO (x!, y!) [, style%]

Remarks

You can copy a complete bitmap, or a portion of it, to the host printer page. The expression hbmpSource??? specifies the handle of the source bitmap or window. The expression id& is the unique control i dentifier in the range 1 to 65535, as assigned with the CONTROL ADD GRAPHIC statement. id& must be 0 for a GRAPHIC WINDOW or a bitmap. The destination of the copy operation is the host printer page. You must use care that your parameters are valid for the specified bitmaps, or results of the operation are undefined.

The first form of the XPRINT COPY statement copies the complete bitmap, positioning it at (0,0), which is the upper left corner of the destination.

The second form of XPRINT COPY also copies the complete bitmap, but positions it at the point specified by the parameter (x!, y!).

The third form copies a portion of the bitmap, positioning it at the point specified by the parameter (x!, y!). If style& is included, it is one of the following values:

%mix_Blackness | Pixel is always 0 (black).
%mix_NotMergeSrc | Pixel is the inverse of the MergeSrc color.
%mix_MaskNotSrc | Pixel is a combination of the colors common to both the pixel and the inverse of the source.
%mix_NotCopySrc | Pixel is the inverse of the pen color.
%mix_MaskSrcNot | Pixel is a combination of the colors common to both the source and the inverse of the pixel.
%mix_Not | Pixel is the inverse of the pixel color.
%mix_XorSrc | Pixel is a combination of the colors in the source and in the pixel, but not in both.
%mix_NotMaskSrc | Pixel is the inverse of the MaskSrc color.
%mix_MaskSrc | Pixel is a combination of the colors common to both the source and the pixel.
%mix_NotXorSrc | Pixel is the inverse of the XorSrc color.
%mix_Nop | Pixel remains unchanged.
%mix_MergeNotSrc | Pixel is a combination of the source color and the inverse of the pixel color.
%mix_CopySrc | Pixel is the source color (default).
%mix_MergeSrcNot | Pixel is a combination of the source color and the inverse of the pixel color.
%mix_MergeSrc | Pixel is a combination of the source color and the pixel color.
%mix_Whiteness | Pixel is always 1 (white).

A host printer must first be connected with XPRINT ATTACH. If a host printer is not attached, error 57 is generated.

See also | XPRINT ATTACH, XPRINT RENDER, XPRINT STRETCH, XPRINT SET STRETCHMODE