![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_53.png)
8-8
TText Display Management
Programmer’s Manual
8.6
Text character cursor position
The character cursor position determines where within the text display area text
will be displayed next. This position is relative to the origin of the text display area
specified in the given text template. The range of valid cursor positions is zero
through one less than the size of the text display area in number of characters.
In Figure 8-1 the range of valid cursor positions is zero through (m * n - 1), aEnglish fonts. Large Normal and Large Italic are 16 x 20 pixels English fonts. GB
the current cursor position is 3 after “abc” is displayed
8.6.1
Setting the character cursor position
STATUS
TextSetCursor
(U32
templateId
, U16
cursor)
Setting the character cursor position of the text display area of the specified text
template to the given value. Subsequent displaying of text start at this new
character cursor position.
Example 8-5 Set character cursor position
53
static U32 gTextId, gTmpTextId;
.
.
.
279 /* Clear the text on the display and reset cursor */
280
TextUnmap(gTextId);
281
TextSetCursor(gTextId, 0);
8.6.2
Reading the character cursor position
STATUS
TextReadCursor
(U32
templateId
, P_U16
cursor
)
Applications can inquire the current character cursor position of a text display area
specified by a text template. The returned character cursor position is where text
will be displayed next.
Example 8-6 Set and read the character cursor position
U32
TEXT
tId;
moto[] = {’M’, ’o’, ’t’, ’o’, ’r’, ’o’, ’l’, ’a’, 0};/* text to be displayed
*/
len;
/* # chars to be displayed */
curPos;/* cursor position */
/* text template id */
U16
U16
.
.
.
/* create a text template */
TextCreate(&tId);
/* calculate # chars to be displayed */
len = Strlen(moto);
/* set up text properties. */
TextSetup(tId, LARGE_NORMAL_FONT, EXOR_STYLE, 3, 102, 0, len, 6);
/* set current character cursor position to beginning of 2nd row in the text template
*/
TextSetCursor(tId, len);
/* display “Motorola” using the modified text properties */
Personal Portable System Manager
Programmer’s Manual
8-5
P_U8
bitmap;
/* pointer to character bitmap */
} FONTATTR, *P_FONTATTR;
8.4.3.1 Font Types
Eight font types are supported. Small Normal and Small Italic are 8 x 10 pixels
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.
If a scalable font engine is available, the BIG5_VARIABLE_FONT font type allows
an application to specify the font width and height of the characters in a text
template. The minimum and maximum width and height supported depend on the
All the other font types are fixed size fonts. Any attempt to modify the font width
and height of those font types is ignored.
8.4.3.3 Special font attributes
No other special font attributes are currently being supported. So, attempts to
modify the font attributes field of a text template is ignored. The attribute field is
Table 8-3 Supported Font Types and Sizes
Output Styles
Operation
SMALL_NORMAL_FONT
8 x 10 English Normal
SMALL_ITALIC_FONT
8 x 10 English Italic
LARGE_NORMAL_FONT
16 x 20 English Normal
LARGE_ITALIC_FONT
16 x 20 English Italic
GB_NORMAL_FONT
16 x 16 GB Normal
CHINESE_NORMAL_FONT
same as
GB_NORMAL_FONT
BIG5_NORMAL_FONT
16 x 16 BIG5 Normal
BIG5_VARIABLE_FONT
Variable size BIG5
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.