From 9eb87ca32556add2e909befb79ce96f9078b04f1 Mon Sep 17 00:00:00 2001 From: Sam Lantinga Date: Fri, 22 Mar 2024 10:58:27 -0700 Subject: [PATCH] Note that many things are considered mice and keyboards that you might not expect --- include/SDL3/SDL_keyboard.h | 2 ++ include/SDL3/SDL_mouse.h | 2 ++ 2 files changed, 4 insertions(+) diff --git a/include/SDL3/SDL_keyboard.h b/include/SDL3/SDL_keyboard.h index 84e8409832..451090556d 100644 --- a/include/SDL3/SDL_keyboard.h +++ b/include/SDL3/SDL_keyboard.h @@ -70,6 +70,8 @@ extern DECLSPEC SDL_bool SDLCALL SDL_HasKeyboard(void); /** * Get a list of currently connected keyboards. * + * Note that this will include any device or virtual driver that includes keyboard functionality, including some mice, KVM switches, motherboard power buttons, etc. You should wait for input from a device before you consider it actively in use. + * * \param count a pointer filled in with the number of keyboards returned * \returns a 0 terminated array of keyboards instance IDs which should be * freed with SDL_free(), or NULL on error; call SDL_GetError() for diff --git a/include/SDL3/SDL_mouse.h b/include/SDL3/SDL_mouse.h index 0c97fc1a56..18e476a4b3 100644 --- a/include/SDL3/SDL_mouse.h +++ b/include/SDL3/SDL_mouse.h @@ -95,6 +95,8 @@ extern DECLSPEC SDL_bool SDLCALL SDL_HasMouse(void); /** * Get a list of currently connected mice. * + * Note that this will include any device or virtual driver that includes mouse functionality, including some game controllers, KVM switches, etc. You should wait for input from a device before you consider it actively in use. + * * \param count a pointer filled in with the number of mice returned * \returns a 0 terminated array of mouse instance IDs which should be * freed with SDL_free(), or NULL on error; call SDL_GetError() for