22-4
Text Tools
Programmer’s Manual
22.6
TextSetDisplay
Syntax
STATUS
TextSetDisplay
(U32 templateId, U16 xPos, U16 yPos, U16 width
U16 height, U16 cursor)
Description
Sets up the text display layout of the given text template with the corresponding
given values. The text display layout comprises of the location and size of a
text template. Subsequent text mapped using this text template wilSyntax
displayed with the new layout.
The text display layout specified must reside within the boundary ofDescription
panning screen. The size of the text display area in number of pixels varies with
the size of the font type specified in the text template. The range of valid
character cursor positions to set to is zero through (text display area size in
number of characters - 1).
Parameter
Return Value
Name
Description
templateId
Identifier of text template to be modified
xPos
X-coordinate of top left corner of text
display area
yPos
Y-coordinate of top left corner of text
display area
width
Width of text display area in number of
columns of characters
height
Height of text display area in number of
rows of characters
cursor
Character cursor position within the text
display area where text will be displayed
next
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_TEXT_ID
Invalid text template identifier
PPSM_ERR_TEXT_X
Text template x-coordinate out of range
PPSM_ERR_TEXT_Y
Text template y-coordinate out of range
PPSM_ERR_TEXT_WIDTH
Given width extends text display area
beyond the panning screen
Personal Portable System Manager
Programmer’s Manual
Text Tools
22-5
STATUS
TextSetFont
Sets up the font attributes of the given text template. Subsequent text mapped
using this text template will be displayed with these new font attributes.
Eight font types are currently supported. Small Normal and Small Italic are 8 x
8 pixels English fonts. Large Normal and Large Italic are 16 x 16 pixels English
fonts. GB Normal is 16 x 16 Chinese font in GB code format. Chinese Normal
is the same as GB Normal (for backward compatibility). BIG5 Normal is 16 x
16 Chinese font in BIG5 code format. BIG5 Variable is a variable size font in
BIG5 code format.
Note:
Asian fonts are supplied by third parties.
The specified font width and height will only take effect if the BIG5 Variable font
type is specified. The minimum and maximum size will depend on the specific
font libraries being provided.
The attribute field is for future extensions and should be set to zero.
Parameter
PPSM_ERR_TEXT_HEIGHT
Given height extends text display area
beyond the panning screen
PPSM_ERR_TEXT_CUR
Invalid character cursor position
Name
Description
templateId
Name
Description
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.