Difference between revisions of "GINPUT"
| Line 5: | Line 5: | ||
A touchscreen can be interfaced very easily through the GINPUT module. It doesn't matter if it is a [http://en.wikipedia.org/wiki/Touchscreen#Resistive resistive], [http://en.wikipedia.org/wiki/Touchscreen#Capacitive capacitive] or any other touchscreen technology. | A touchscreen can be interfaced very easily through the GINPUT module. It doesn't matter if it is a [http://en.wikipedia.org/wiki/Touchscreen#Resistive resistive], [http://en.wikipedia.org/wiki/Touchscreen#Capacitive capacitive] or any other touchscreen technology. | ||
| + | === Calibration === | ||
| + | The GINPUT module provides a calibration routine which uses a three-point algorithm. Three calibration points will show up, one after another. You have to press each. At the end of this process, a 4rd one will appear in the center of the screen. This last one is only used to test if the calibration was successful. If the offset is too big, the calibration process will be restarted automatically. | ||
| + | |||
| + | ==== Options ==== | ||
| + | The following settings can alter the behaviour of the calibration routine: | ||
| + | |||
| + | {| class="wikitable" | ||
| + | ! scope="col"|Option | ||
| + | ! scope="col"|Description | ||
| + | |- | ||
| + | |GINPUT_MOUSE_CALIBRATE_EXTREMES | ||
| + | |If this is set to ''TRUE'' in your [[gfxconf.h]], the calibration points are display at the very corner of the display. This gives an overall more accurate result but they are less intuitive. | ||
| + | |- | ||
| + | |GINPUT_MOUSE_MAX_CALIBRATION_ERROR | ||
| + | |This macro is part of the config file of the driver in your board directory and takes a pixel value. It defines how big the pixel offset of the test point can be before the calibration process is repeated automatically. | ||
| + | |} | ||
== Digital input == | == Digital input == | ||
| + | ToDo | ||
== Analog input == | == Analog input == | ||
| + | ToDo | ||
Revision as of 21:23, 1 July 2014
GINPUT is a powerful module which provides an easy way to interface different hardware peripherals such as touchscreens to the rest of the library. It provides everything which these peripherals need in order to operate properly such as calibration routines for the touchscreens.
Touchscreen
A touchscreen can be interfaced very easily through the GINPUT module. It doesn't matter if it is a resistive, capacitive or any other touchscreen technology.
Calibration
The GINPUT module provides a calibration routine which uses a three-point algorithm. Three calibration points will show up, one after another. You have to press each. At the end of this process, a 4rd one will appear in the center of the screen. This last one is only used to test if the calibration was successful. If the offset is too big, the calibration process will be restarted automatically.
Options
The following settings can alter the behaviour of the calibration routine:
| Option | Description |
|---|---|
| GINPUT_MOUSE_CALIBRATE_EXTREMES | If this is set to TRUE in your gfxconf.h, the calibration points are display at the very corner of the display. This gives an overall more accurate result but they are less intuitive. |
| GINPUT_MOUSE_MAX_CALIBRATION_ERROR | This macro is part of the config file of the driver in your board directory and takes a pixel value. It defines how big the pixel offset of the test point can be before the calibration process is repeated automatically. |
Digital input
ToDo
Analog input
ToDo
