GXDIB2GSPixMap

Converts a packed DIB (Microsoft Device Independent Bitmap) to a Graphisoft pixmap.

    GSErr GXDIB2GSPixMap (
      GSPtr            bitmapInfo,
      Int32            dibSize,
      GSPixMapHandle*  pixMap
    );

Parameters

bitmapInfo

Pointer to the starting of the DIB (which is a BITMAPINFO structure).

dibSize

The size of the memory pointed by bitmapInfo.

pixMap

The address of the target pixmap. The target pixmap should be NULL-initiated.

Return Values

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

Remarks

This type of DIB is called as packed DIB and differs from a BMP is that a BMP has a two byte mark ('0x42 0x4D' = "BM") on the first two position. So if you have a BMP and increase its starting pointer by two bytes, you get the DIB which this function can transform.

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