39 Pen Manager

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 section "Receiving User Input" in the Palm OS Programmer's Companion.

Pen Manager Functions

PenCalibrate

Purpose

Set the calibration of the pen.

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.

Result

Returns 0 if no error.

Comments

Called by Preferences application when calibrating pen.

See Also

PenResetCalibration

PenResetCalibration

Purpose

Reset the calibration in preparation for calibrating the pen again.

Prototype

Err PenResetCalibration (void)

Parameters

None.

Result

Always returns 0.

Comments

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

See Also

PenCalibrate

---

WARNING!

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

---