CGXConvertBitmap

Converts a bitmap to a different bitmap.

    Int32 CGXConvertBitmap (
      GSPtr*                   dstBmp,
      short*           dstDepth,
      const GSPtr      srcBmp,
      bool             dither,
      bool             defColTab
    );

Parameters

dstBmp

The new, converted bitmap. You may pass a BITMAPINFOHEADER* to access the returned information easier.

pixHdl

The requested depth (returns the real depth of dstBmp).

srcBmp

The bitmap to be converted.

dither

Use dithering if the destination depth is lower than the original.

defColTab

Use a standard color table instead of a custom.

Return Values

If the function succeeds, the return value is the length (in bytes) of the allocated bitmap. If the function fails, the return value is 0, and dstBmp is NULL.

Remarks

This is a Windows-only function.

If the resulting dstBmp is not NULL, then you should free its value with BMpFree.

Requirements

Version:

GX 10 or later

Header:

Graphics2DIO.h

Import Library:

GXImp.lib

Module:

GX.dll [WIN]