overview.d

来自「WinCE 3.0 BSP, 包含Inter SA1110, Intel_815」· D 代码 · 共 66 行

//      @doc    EXTERNAL DRIVERS TOUCH_DRIVER 
/*      @topic Touch Driver |


The touch driver is responsible for reading input from the touch panel 
hardware and converting it to touch events which are fed into the input 
system.  The driver is also responsible for converting from uncalibrated 
digitizer coordinates to calibrated coordinates which take into account 
any hardware idiosyncracies such as skew or non-linearties.  

The driver must report points back while the stylus or finger is down on 
the touch panel.  When the stylus or finger comes up, the driver must 
report at least one final reading which shows that the stylus tip came up.  See
<l TouchDriverEnableCallback.PFN_TOUCH_PANEL_CALLBACK> 
and <l enumTouchPanelSampleFlags.enumTouchPanelSampleFlags>.

The calibrated coordinates must be reported back to the nearest 1/4 pixel of the
screen.<nl>

The basic algorithm for using the touch panel is<nl>
<tab><l TouchPanelEnable.TouchPanelEnable>  // Start the panel sampling<nl>
<tab><l TouchPanelGetDeviceCaps.TouchPanelGetDeviceCaps> // request # of calibration points<nl>
<tab>for( i=0; i<lt># points; i++ )<nl>
<tab><tab><l TouchPanelGetDeviceCaps.TouchPanelGetDeviceCaps> // Get a calibration coordinate<nl>
<tab><tab>//Draw croshair at returned coordinate<nl>
<tab><tab><l TouchPanelReadCalibrationPoint.TouchPanelReadCalibrationPoint> // Get calibration data<nl>
<tab><l TouchPanelSetCalibration.TouchPanelSetCalibration> // Calculate Calibration Coefficients<nl>

After executing this sequence, any pen samples generated for the touch
panel will be passed to the callback function specified in the TouchPanelEnable.
The driver may pass either calibrated or uncalibrated points to the callback.  
If the driver has an efficient calibration algorithm, it can return calibrated
points.  However, if the calibration is very compute intensive the driver might
choose to return uncalibrated points rather than perform extensive calculations
in the high priority driver thread.  The lower priority thread processing points 
from the callback can then perform the calibration.

MDD<nl>
<tab>Exported Functions <nl>
<tab><tab><l TouchPanelSetCalibration.TouchPanelSetCalibration> <nl>
<tab><tab><l TouchPanelDllEntry.TouchPanelDllEntry> <nl>
<tab><tab><l TouchPanelGetDeviceCaps.TouchPanelGetDeviceCaps> <nl>
<tab><tab><l TouchPanelEnable.TouchPanelEnable> <nl>
<tab><tab><l TouchPanelDisable.TouchPanelDisable> <nl>
<tab><tab><l TouchPanelSetMode.TouchPanelSetMode> <nl>
<tab><tab><l TouchPanelReadCalibrationPoint.TouchPanelReadCalibrationPoint> <nl>
<tab><tab><l TouchPanelReadCalibrationAbort.TouchPanelReadCalibrationAbort> <nl>
<tab><tab><l TouchPanelCalibrateAPoint.TouchPanelCalibrateAPoint> <nl>
<tab><tab><l TouchPanelPowerHandler.TouchPanelPowerHandler> <nl>
<tab>Internal Functions <nl>
<tab><tab><l TouchPanelpDetach.TouchPanelpDetach> <nl>
<tab><tab><l TouchPanelpAttach.TouchPanelpAttach> <nl>
<tab><tab><l TouchPanelpISR.TouchPanelpISR> <nl>

<nl>
PDD<nl>
<tab>Exported Functions<nl>
<tab><tab><l PddpTouchPanelEvaluateSamples.PddpTouchPanelEvaluateSamples><nl>
<tab><tab><l TouchDriverCalibrationPointGet.TouchDriverCalibrationPointGet><nl>
<tab>Internal Functions<nl>
<tab><tab><l PddpTouchPanelGetSamples.PddpTouchPanelGetSamples><nl>
<tab><tab><l PddpTouchPanelAdcCommand.PddpTouchPanelAdcCommand><nl>
<tab><tab><l PddpTouchPanelDeallocateVm.PddpTouchPanelDeallocateVm><nl>
*/