Fcalva/gint
1
0
Fork 0
mirror of https://git.planet-casio.com/Lephenixnoir/gint.git synced 2025-04-04 17:47:11 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

keyboard: add a note about the use of transforms in getkey_opt()

Browse source
This commit is contained in:
Lephe 2021-09-01 16:21:53 +02:00
parent 2d0e18f2d8
commit 7adcdea5f1
No known key found for this signature in database
GPG key ID: 1BBA026E13FC0495
1 changed files with 9 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
include/gint/keyboard.h
View file

@ -246,6 +246,15 @@ typedef bool (*getkey_feature_t)(key_event_t event);
value whenever you want to interrupt the call; using a timer with value whenever you want to interrupt the call; using a timer with
[timer_timeout] as callback is suitable. See <gint/timer.h>. [timer_timeout] as callback is suitable. See <gint/timer.h>.
Event transforms in getkey_opt() (SHIFT, ALPHA and repetitions) are handled
by changing the transform settings on the keyboard device. These settings
are restored when getkey_opt() returns, so if they are originally disabled
(which they are unless set manually) then the status of the SHIFT and ALPHA
keys is lost between calls (this has an effect it getkey_opt() is
interrupted by timeout). Therefore, in order to use modifiers across several
calls to getkey_opt(), make sure to enable the transforms on the keyboard
device; see <gint/drivers/keydev.h> for details.
@options An or-combination of values from the GETKEY_* enumeration @options An or-combination of values from the GETKEY_* enumeration
@timeout Optional pointer to a timeout value @timeout Optional pointer to a timeout value
Returns a key event of type KEYEV_DOWN or KEYEV_HOLD with [mod=1]. */ Returns a key event of type KEYEV_DOWN or KEYEV_HOLD with [mod=1]. */