![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_52.png)
8-2
TText Display Management
Programmer’s Manual
8.3
Text Templates
A text template refers to a collection of text properties that describes the text to be
displayed. These text properties include font type, font size, grey level, output
style, coordinates and size of the text display, and the position of the display The text display layout of a text template is rectangular and must reside within the
cursor. These text templates are independent of the text itself and provide the
flexibility for applications to change the appearance of text in a collective and
efficient manner. Applications can create and delete the text templates at their
discretion on an as needed basis. The soft cursor in text is an invisible positito the size of the selected font type. The specified cursor positions must lie within
indicator showing where the text should be mapped.
8.3.1
Creating text templates
STATUS
TextCreate
(P_U32 templateId)
A text template needs to be created before any text can be displayed. A unique
unsigned 32-bit text template identifier is returned from the system for each text
template created. This text template identifier is used for future references to the
created text template. Refer to Table 8-4for the default values of the text
properties when a text template is created.
Example 8-1 Create a text template
336 U32 tId; /* textId for the text template */
337
338 if(TextCreate(&tId) != PPSM_OK)
...........
...........
.
.
0
1
2
n-1
...............................
0
1
2
m-1
.
n COLUMNS
m ROWS
y-coord
x-coord
a
b
c
Figure 8-1 A Text Display Area on the Panning Display Screen
Panning Display Screen Width
P
Personal Portable System Manager
Programmer’s Manual
8-3
339 return PPSM_ERROR;
340
8.3.2
Deleting text templates
STATUS
TextDelete
)
When a text template is not needed anymore, applications should delete it to free
up space that is being used to store the text properties. The text template identifier
returned by TextCreate() is used to specify which text template to be deleted.
Example 8-2 Delete a text template
352 /* Delete the text when it’s no longer needed */
353 if(TextDelete(tId) != PPSM_OK)
354 return PPSM_ERROR;
8.4
Text Properties
Text properties describes the layout and appearance of the text to be displayed on
the panning display screen. These text properties, stored collectively in a text
template, include the position and size of the text display area, the outlook of the
text characters, the font attributes, and the position of the text soft cursor within
the text display area. Refer to
for the default values of these properties
of a text template when it is created.
8.4.1
Setting Text Display Layout
STATUS
TextSetDisplay
U16 height
,
)
boundary of the panning screen. The layout is anchored by the xy-coordinate of
the upper left corner, and the width and height of the area in number of
characters. The size of the text display area in number of pixels will vary according
the range of 0 and one less than the number of characters the text display area
can display.
In Figure 8-1, the text display area is located at location (x, y) and it is m rows by n
columns in size. This text display area can be moved around as the application
wishes.
STATUS
TextSetOutlook
)
The text outlook of a text template are the output style and the grey level of the text
to be displayed on the text display area. The new output style and grey level will
take effect on subsequent text mapped using the text template after it’s been
modified.
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.