Documentation  |   Table of Contents   |  < Previous   |  Next >  

8    Bitmap.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

Applications that were treating the various bitmap structures as opaque should find little changed in Palm OS Cobalt. Applications that do access the internals these structures directly should use the appropriate accessor functions instead. See Chapter 12, "Bitmap Reference," of Exploring Palm OS: User Interface for a detailed description of each structure and the functions you would use to access that structure's contents.

Deleted APIs ^TOP^

Table 8.1  Deleted functions

Deleted API

Use instead

BmpBitsSize()

BmpGetSizes()

WinHighDensityDispatch()

Nothing. This function was "System Use Only."

Table 8.2  Deleted macros

Deleted API

Use instead

HIGH_DENSITY_TRAP()

Nothing. High-density support is a standard part of the operating system in Palm OS Cobalt.

Table 8.3  Deleted structures

Deleted API

Use instead

BitmapFlagsType

The structure of the bitmap flags is now private. Applications must use accessor functions instead.

Table 8.4  Deleted #defines

Deleted API

Use instead

HDSelector...

See "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

Modified APIs ^TOP^

Table 8.5  Modified functions

Modified API

Description of change

uint32_t BmpSize (const BitmapType *)

This function used to return an unsigned 16-bit integer.

Table 8.6  Modified structures 

Modified API

Description of change

BitmapType

The internals of this structure should be considered private; applications should manipulate bitmaps using the supplied functions only.

BitmapTypeV0

The internals of this structure should be considered private; applications should manipulate bitmaps using the supplied functions only.

BitmapTypeV1

The internals of this structure should be considered private; applications should manipulate bitmaps using the supplied functions only.

BitmapTypeV2

The internals of this structure should be considered private; applications should manipulate bitmaps using the supplied functions only.

BitmapTypeV3

The internals of this structure should be considered private; applications should manipulate bitmaps using the supplied functions only.

ColorTableType

The numEntries field has been renamed to entryCount.

Table 8.7  Modified enumerated types

Modified API

Description of change

BitmapCompressionType

Formerly an enum, this is now a typedef that accepts one of the values declared by the new BitmapCompressionTag enum.

DensityType

Formerly an enum, this is now a typedef that accepts one of the values declared by the new DensityTag enum.

PixelFormatType

Formerly an enum, this is now a typedef that accepts one of the values declared by the new PixelFormatTag enum. The PixelFormatTag enum has two new values, both of which define pixel formats with an alpha channel: pixelFormat5551, and pixelFormat4444.

Unchanged APIs ^TOP^

Table 8.8  Unchanged functions

BmpColortableSize()

BmpCompress()

BmpCreate()

BmpCreateBitmapV3()

BmpDelete()

BmpGetBitDepth()

BmpGetBits()

BmpGetColortable()

BmpGetCompressionType()

BmpGetDensity()

BmpGetDimensions()

BmpGetNextBitmap()

BmpGetNextBitmapAnyDensity()

BmpGetSizes()

BmpGetTransparentValue()

BmpGetVersion()

BmpSetDensity()

BmpSetTransparentValue()

Table 8.9  Unchanged macros

ColorTableEntries()

Table 8.10  Unchanged structures

BitmapDirectInfoType

RGBColorType

Table 8.11  Unchanged types

BitmapPtr

BitmapPtrV0

BitmapPtrV1

BitmapPtrV2

BitmapPtrV3

Table 8.12  Unchanged #defines

BitmapVersionOne

BitmapVersionThree

BitmapVersionTwo

BitmapVersionZero

kTransparencyNone