get_bitmap_dimensions


bool get_bitmap_dimensions(handle bitmap,
                           idimensions* dimensions_bitmap)

This function obtains the preferred dimensions of a bitmap.

Parameters

handle bitmap

The handle of the bitmap whose preferred dimensions are being queried.

idimensions* dimensions_bitmap

A pointer to an object to hold the dimensions.

Return

bool

true The function succeeded.
false The call failed.

Notes

If the preferred dimensions have not yet been set, zeros are returned for the width and height of the bitmap.

The preferred dimensions are not used by the operating system; rather, they are for use by applications.