XPRINT STRETCH statement

Purpose

Copy and resize a bitmap to a host printer page.

Syntax

XPRINT STRETCH hbmpSource???, id&, (x1!, y1!)-(x2!, y2!) TO (x3!, y3!)-(x4!, y4!) [, style%]

Remarks

You can copy a complete bitmap, or a portion of it, to the host printer page, while resizing it to a larger or smaller size. The expression hbmpSource??? specifies the handle of the source bitmap or window. The expression id& is reserved for future compatibility, and must always be set to zero. The destination of the copy operation is the host printer page. The bitmap is automatically resized to fit the destination parameters. You must use care that your parameters are valid for the specified bitmaps, or results of the operation are undefined.

If the style% parameter is included, it is one of the values in the following table. If not included, a default of %mix_CopySrc is presumed. There are 8 mix modes available to use for mixing drawing colors with the colors which already exist at the at the drawing location. The mix mode equates are predefined in PowerBASIC.

%mix_NotMergeSrc

Pixel is the inverse of the MergeSrc color.

%mix_NotCopySrc

Pixel is the inverse of the source color.

%mix_MaskSrcNot

Pixel is a combination of the colors common to both the source and the inverse of the pixel.

%mix_XorSrc

Pixel is a combination of the colors in the source and the pixel, but not in both.

%mix_MaskSrc

Pixel is a combination of the colors common to both the source and the pixel.

%mix_MergeNotSrc

Pixel is a combination of the pixel color and the and the inverse of the source color.

%mix_CopySrc

Pixel is the source color (default).

%mix_MergeSrc

Pixel is a combination of the source color and the pixel color.

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 COPY, XPRINT RENDER