![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_117.png)
21-2
Database Management Tools
Graphics Tools
Programmer’s Manual
Parameter
Return Value
Hint
For DBAddRecord() to work, the reference database ID must have DrawEllipse(), DrawArc() and DrawVector().
created by calling DBAdd() prior to the calling of DBAddRecord().
21.3
DBAddRecToTop
Syntax
STATUS
DBAddRecToTop
(U32 dbId S32 numFmt P_U32 outRecId)
Description
Adds a blank record at the beginning of the record list of a given databReturn Value
User has the option to specify additional formatted data fields to be allocated.
The valid range of numFmtis from 0 to 5.
This tool is meant to complement the action of DBAddRecord().
Parameter
Name
Description
dbId
Identifier of the database
recId
Returns the identifier of the record added
numFmt
Number of additional formatted data fields
in the record
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_NUM_FMT
Invalid user format field number
Name
Description
dbId
Identifier of the database
numFmt
Number of additional formatted data fields
in the record
outRecId
Returns the identifier of the added record
Personal Portable System Manager
Programmer’s Manual
20-31
20.38
SetDotWidth
Syntax
STATUS
SetDotWidth
Description
This tool sets the width for a dot in number of pixels so that a thick dot can be
drawn by DrawDot(), a thick line can be drawn by DrawLine(), etc.
This dot width is applied to DrawDot(), DrawLine(), DrawRec(), DrawCircle(),
If oldWidth is non-zero, the current dot width will be saved in oldWidth.
Parameter
20.39
SetPatternFill
STATUS
SetPatternFill
fillSpace
Description
PPSM_ERR_LCD_X
Invalid x-coordinate
PPSM_ERR_LCD_Y
Invalid y-coordinate
PPSM_ERR_WIDTH
Invalid width
PPSM_ERR_HEIGHT
Invalid height
Name
Description
newWidth
oldWidth
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DOT_WIDTH
Name
Description
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.