GXDrawGSPixMapPartOnHDC

Draw a part of a GSPixMap on a device context.

    GSErr GXDrawGSPixMapPartOnHDC (
      HDC                 hDC,
      GSPixMapHandle      pixMap,
      const GSRect&       srcRect,
      const GSRect&       dstRect,
      bool                withDither = true,
      bool                useDefaultColorTable = false,
      AlphaChannelUsage   acUsage = CopyAlphaChannel
    );

Parameters

hDC

Device context handle to draw on.

pixMap

The source pixmap.

srcRect

Rectangle that determines a part of the source pixmap that is to be drawn.

dstRect

Destination rectangle in the device context. The picture is stretched to fit this rectangle.

withDither

Use dithering. Ignored if acUsage is AlphaChannelBlending or the pixel depth of the hDC is 32.

useDefaultColorTable

Use the default color table. Ignored if acUsage is AlphaChannelBlending or the pixel depth of the hDC is not 8.

acUsage

If this value is AlphaChannelBlending, then the alpha channel value is used for blending the source pixel to the destination pixel. If it is CopyAlphaChannel, then the alpha channel value is copied just like the RGB color values.

Return Values

If the function succeeds, the return value is NoError. If the function fails, the return value is the error code.

Remarks

This function exists only on Windows platform.

Requirements

Version:

GX 10 or later

Header:

Graphics2DWin.h

Import Library:

GXImp.lib

Module:

GX.dll [WIN], GX.framework [MAC]

See Also

Graphics Windows-specific functions