XPRINT STRETCH statement  

Purpose

Copy and resize a bitmap to the XPRINT page.

Syntax

XPRINT STRETCH hBmp, ID, (x1,y1)-(x2,y2) TO (x3,y3)-(x4,y4) [,Mix, Stretch]

XPRINT STRETCH PAGE hBmp, ID [, Mix, Stretch]

Remarks

You can copy a complete bitmap, or a portion of it, to the XPRINT page, while resizing it to a larger or smaller size.  The handle variable hBmp specifies the handle of the source bitmap or window.  ID must be zero (0) for a GRAPHIC WINDOW or a GRAPHIC BITMAP .   The destination of the stretch operation is always the attached XPRINT 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 result of the operation is undefined.

The second form, XPRINT STRETCH PAGE, is a shortcut for copying a complete bitmap to the clip or client area of the host printer page. The image is automatically stretched or condensed to fit the target appropriately.

Mix

If the Mix parameter is included, it is one of the values in the following table.  If not specified, a default of %MIX_COPYSRC is presumed.  There are 16 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_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).

Stretch

If the Stretch parameter is included, it is one of the values in the following table.  If not included, or it is the value zero (0), the stretch mode is unchanged.  An appropriate choice of stretch mode can substantially enhance the quality of bitmaps which are changed in size.  The stretch mode equates are predefined in PowerBASIC.

%BLACKONWHITE

1

This is the default Windows stretch mode, and is most appropriate for monochrome bitmaps, or those with blocks of color.  Performs a boolean OR of eliminated and existing pixels.  It preserves black pixels at the expense of white pixels.

%WHITEONBLACK

2

Performs a boolean OR of eliminated and existing pixels.  It preserves white pixels at the expense of black pixels.

%COLORONCOLOR

3

Deletes eliminated lines of pixels without trying to preserve their information.

%HALFTONE

4

This provides the highest quality for complex color bitmaps.  The average color of the destination pixel block is kept approximately the same as the source pixel block.

 

See also

 XPRINT COPY, XPRINT RENDER, XPRINT SET MIX, XPRINT SET STRETCHMODE