Documentation  |   Table of Contents   |  < Previous   |  Next >  

47    Font.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

Aside from some minor changes in function parameter sizes, and the renaming of a couple of structures, the Font APIs are largely unchanged in Palm OS Cobalt.

Deleted APIs ^TOP^

Table 47.1  Deleted functions

Deleted API

Use instead

FntWCharWidth()

FntCharWidth()

Table 47.2  Deleted structures

Deleted API

Use instead

FontCharInfoType

Nothing. This structure was defined but not used by the public APIs.

FontDensityType

FontDensityTypeType

FontTypeV2

FontTypeV2Type. Note that applications should never access the contents of this structure directly.

Table 47.3  Deleted types

Deleted API

Use instead

FontCharInfoPtr

Nothing. This pointer type was defined but not used by the public APIs.

Table 47.4  Deleted #defines

Deleted API

Use instead

fntMissingChar

Applications were likely not using this. It was defined to have a value of -1.

Modified APIs ^TOP^

Table 47.5  Modified functions

Modified API

Description of change

void FntGetScrollValues (const char *, Coord, size_t, uint32_t *, uint32_t *)

The final two parameters, linesP and topLine, previously pointed to an unsigned 16-bit integer.

void FntWordWrapReverseNLines (const char *, Coord, uint32_t *, size_t *)

The third parameter, indicating the number of lines to scroll, previously pointed to an unsigned 16-bit integer.

Table 47.6  Modified enumerated types

Modified API

Description of change

FontID

Formerly an enum, this is now a typedef that accepts one of the values defined by the fontID enum.

Unchanged APIs ^TOP^

Table 47.7  Unchanged functions 

FntAverageCharWidth()

FntBaseLine()

FntCharHeight()

FntCharsInWidth()

FntCharsWidth()

FntCharWidth()

FntDefineFont()

FntDescenderHeight()

FntGetFontPtr()

FntLineHeight()

FntLineWidth()

FntWidthToOffset()

FntWordWrap()

FntGetFont()

FntSetFont()

Table 47.8  Unchanged macros

FntIsAppDefined()

Table 47.9  Unchanged structures

FontType

Table 47.10  Unchanged types

FontPtr

FontTablePtr

Table 47.11  Unchanged #defines

checkboxFont

fntTabChrWidth

Table 47.12  Unchanged enumerated types

fontID