Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

47    Pen Manager

Palm OS® Programmer's API Reference

Palm OS® 68K SDK

     

This chapter provides reference material for the pen manager. The pen manager API is declared in the header file PenMgr.h.

For more information on the pen manager, see "The Pen Manager" of the Palm OS Programmer's Companion, vol. I.

Pen Manager Functions ^TOP^

PenCalibrate Function ^TOP^

Purpose

Set the calibration of the pen.

Declared In

PenMgr.h

Prototype

Err PenCalibrate (
   PointType *digTopLeftP,
   PointType *digBotRightP,
   PointType *scrTopLeftP,
   PointType *scrBotRightP
)

Parameters

digTopLeftP
Digitizer output from top-left coordinate.
digBotRightP
Digitizer output from bottom-right coordinate.
scrTopLeftP
Screen coordinate near top-left corner.
scrBotRightP
Screen coordinate near bottom-right corner.

Returns

Returns 0 if no error.

Comments

Called by Preferences application when calibrating pen.

Compatibility

If Palm OS Cobalt Feature Set is present this function does nothing.

See Also

PenResetCalibration()

PenResetCalibration Function ^TOP^

Purpose

Reset the calibration in preparation for calibrating the pen again.

Declared In

PenMgr.h

Prototype

Err PenResetCalibration (
   void
)

Parameters

None.

Returns

Always returns 0.

Comments

Called by Preferences application before capturing points when calibrating the pen.


WARNING! The digitizer is off after calling this routine and must be calibrated again!

Compatibility

If Palm OS Cobalt Feature Set is present this function does nothing.

See Also

PenCalibrate()