GpiWCBitBlt

GpiWCBitBlt enables you to retain the bit-map data in the segment store of the target presentation space. It is a valid in all three drawing modes:

• DM_DRAW-display, printer, or into metafile
  
• DM_RETAIN-into metafile or segment
  
• DM_DRAWANDRETAIN-display, printer, then into associated segment or metafile.

Most of the bit-map drawing operations occur in an application's device space. GpiWCBitBlt, however, lets an application draw in its world space, but requires that you use device coordinates for the source rectangle, and world coordinates for the target rectangle.

An application can use GpiWCBitBlt to draw a bit map with consistent dimensions on devices with different aspect ratios. The aspect ratio is the ratio of a pel's width to its height.

When creating data for interchange, use GpiWCBitBlt. GpiWCBitBlt provides the same function as GpiBitBlt, with the following exceptions:

• The target rectangle is specified in world coordinates, and all four coordinates (the two source-rectangle coordinates and the two target-rectangle coordinates) must be specified.

• The source handle must be a bit-map handle. It must not be the handle of a source presentation space. The bit map identified by the source handle must not be selected into a memory device context when you call GpiWCBitBlt.

• GpiWCBitBlt conforms to the current drawing mode in the target presentation space. If the drawing mode is retain or draw-and-retain, the bit map is retained in segment store.