Modifying the Touch Panel Test (Windows CE 5.0)
The Touch Panel Test executes the tux –o –d touchtest command line on default execution. You can modify the test by editing the command line. For information about how to edit the command line for a test, see Editing the Command Line for a Test. The following table shows a modification you can make to the test.
To modify the Touch Panel Test
| To | Add this command-line parameter |
|---|---|
| Specify the name of the touch panel driver to be tested.
If this option is not specified, the test loads the Touch.dll driver. |
|
This test requires you to interact with the touch panel. You must follow the instructions on the display to run the test correctly. When the test prompts you, you must perform the requested action. If you do not complete the action, the test times out and fails. The test times out after approximately 10 seconds.
In some cases, the test requires you to choose Yes or No in response to a question. To respond, you must tap the part of the touch panel that contains the appropriate response.
When you complete the test, the OS does not regain control of the touch panel. You must reset the touch panel to restore normal operation.
The following table shows the test cases for the Touch Panel Test.
| Test case | Result |
|---|---|
| 8001: Query Device Caps Test | Tests the TouchPanelGetDeviceCaps function, if the function is supported by the touch panel driver. The test uses both the TPDC_SAMPLE_RATE_ID and TPDC_CALIBRATION_POINT_COUNT_ID flags. This test fails if the TouchPanelGetDeviceCaps function call fails with either of the specified flags. This test is skipped if the touch panel driver does not export a TouchPanelGetDeviceCaps function. |
| 8002: Set Sample Rate Test | Tests the TouchPanelSetMode function, if the function is supported by the touch panel driver. The test uses both the TPSM_SAMPLE_RATE_LOW_ID and TPSM_SAMPLE_RATE_HIGH_ID flags. The test verifies the sample rate settings with the TouchPanelGetDeviceCaps function. This test fails if the TouchPanelSetMode function call fails with any specified parameters. The test also fails if the TouchPanelGetDeviceCaps function call fails. This test is skipped if the touch panel driver does not export a TouchPanelSetMode or TouchPanelGetDeviceCaps function. |
| 8003: Set Priority Test | Tests the TouchPanelSetMode function, if the function is supported by the touch panel driver. The test uses both the TPSM_PRIORITY_HIGH_ID and TPSM_PRIORITY_NORMAL_ID flags. This test fails if the TouchPanelSetMode function call fails with any specified parameters. This test is skipped if the touch panel driver does not export a TouchPanelSetMode function. |
| 8004: Read Calibration Point Test | Tests the TouchPanelReadCalibrationPoint function, which reads a single point of data from the touch panel. This test requires you to firmly touch and release the screen once during the test. The test prompts you when this action is necessary. This test fails if the TouchPanelReadCailbrationPoint function call fails. Failure may occur if the function is implemented incorrectly, if the touch panel driver fails to recognize the touching of the touch panel as calibration data, or if you fail to touch the panel when prompted. This test is skipped if the touch panel driver does not export a TouchPanelReadCalibrationPoint or TouchPanelReadCalibrationAbort function. |
| 8005: Calibration Abort Test | Tests the TouchPanelReadCalibrationAbort function, which aborts a TouchPanelReadCalibrationPoint function call. The test requires that you do not touch the touch panel for the duration of the test. This test fails if the TouchPanelReadCalibrationPoint function call succeeds. Failure may occur if you touch the touch panel. This test is skipped if the touch panel driver does not export a TouchPanelReadCalibrationPoint or TouchPanelReadCalibrationAbort function. |
| 8006: Calibration Test | Tests the calibration of the touch panel. The test queries the count of calibration points using the TouchPanelGetDeviceCaps function. The test then prompts you to touch a crosshair drawn on the touch panel for each calibration point, and then calls the TouchPanelReadCalibrationPoint function for each point. The test then calls the TouchPanelSetCalibration function based on the data collected when you touched the touch panel. This test fails if the TouchPanelReadCalibrationPoint function fails for any calibration point. If you fail to tap the touch panel for any calibration point, the test times out after approximately 10 seconds and fails. This test is skipped if the touch panel driver does not export a TouchPanelReadCalibrationPoint, TouchPanelReadCalibrationAbort, TouchPanelSetCalibration, or TouchPanelGetDeviceCaps function. |
| 8007: Initialize Cursor Test | Tests the TouchPanelInitializeCursor function, if the touch panel driver implements the function. The test calls the TouchPanelInitializeCursor function and passes a sample callback routine to verify that the function call succeeds. This test fails if the TouchPanelInitializeCursor function call fails when passed a proper callback routine. This test is skipped if the touch panel driver does not export a TouchPanelInitializeCursor function. |
| 8008: Calibrate A Point Test | Tests the TouchPanelCalibrateAPoint function. The test calibrates the touch panel if it is not already calibrated, and then calls the TouchPanelCalibrateAPoint function with a range of point values to verify success. This test fail if calibration fails for any reason or if the TouchPanelCalibrateAPoint function call fails on any value. This test is skipped if the touch panel driver does not export a TouchPanelCalibrateAPoint function. |
| 8009: Pen Up/Down Test | Tests the ability of the touch panel driver to properly detect tap and release events on the touch panel. This test requires you to tap and release the touch panel when prompted. The test relies on the callback routine successfully receiving the TOUCH_PANEL_SAMPLE_FLAGS data type. This test fails if you do not properly tap and release the touch panel when prompted. If you do not respond to the tap or release instructions, the test times out after approximately 10 seconds and fails. |
| 8010: Point Test | Tests the ability of the touch driver to properly detect pen coordinates on the touch panel. This test requires you to tap the touch panel in several locations when prompted. The test relies on the callback routine successfully receiving touch event coordinates. This test fails if you do not respond to a tap request within approximately 10 seconds. This test also fails if you choose No at the end of the test. |
| 8011: Drawing Test | Tests the ability of the touch driver to properly detect tap, release, and pen coordinates on the touch panel. This test requires you to draw on the touch panel when prompted. This test fails only if you choose No at the end of the test. |
Remarks
This test library can have one or more optional command-line entries to change the behavior of the test. To specify one or more optional command-line entries to the test library, you must use the –c command-line option. This option forces Tux to pass the specified string into the test library.
See Also
Send Feedback on this topic to the authors