Browse Source

Note that many things are considered mice and keyboards that you might not expect

Sam Lantinga 1 year ago
parent
commit
9eb87ca325
2 changed files with 4 additions and 0 deletions
  1. 2 0
      include/SDL3/SDL_keyboard.h
  2. 2 0
      include/SDL3/SDL_mouse.h

+ 2 - 0
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

+ 2 - 0
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