SDL 3.0
SDL_scancode.h
Go to the documentation of this file.
1/*
2 Simple DirectMedia Layer
3 Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
4
5 This software is provided 'as-is', without any express or implied
6 warranty. In no event will the authors be held liable for any damages
7 arising from the use of this software.
8
9 Permission is granted to anyone to use this software for any purpose,
10 including commercial applications, and to alter it and redistribute it
11 freely, subject to the following restrictions:
12
13 1. The origin of this software must not be misrepresented; you must not
14 claim that you wrote the original software. If you use this software
15 in a product, an acknowledgment in the product documentation would be
16 appreciated but is not required.
17 2. Altered source versions must be plainly marked as such, and must not be
18 misrepresented as being the original software.
19 3. This notice may not be removed or altered from any source distribution.
20*/
21
22/**
23 * # CategoryScancode
24 *
25 * Defines keyboard scancodes.
26 *
27 * Please refer to the Best Keyboard Practices document for details on what
28 * this information means and how best to use it.
29 *
30 * https://wiki.libsdl.org/SDL3/BestKeyboardPractices
31 */
32
33#ifndef SDL_scancode_h_
34#define SDL_scancode_h_
35
36#include <SDL3/SDL_stdinc.h>
37
38/**
39 * The SDL keyboard scancode representation.
40 *
41 * An SDL scancode is the physical representation of a key on the keyboard,
42 * independent of language and keyboard mapping.
43 *
44 * Values of this type are used to represent keyboard keys, among other places
45 * in the `scancode` field of the SDL_KeyboardEvent structure.
46 *
47 * The values in this enumeration are based on the USB usage page standard:
48 * https://usb.org/sites/default/files/hut1_5.pdf
49 *
50 * \since This enum is available since SDL 3.2.0.
51 */
52typedef enum SDL_Scancode
53{
55
56 /**
57 * \name Usage page 0x07
58 *
59 * These values are from usage page 0x07 (USB keyboard page).
60 */
61 /* @{ */
62
89
100
106
111 SDL_SCANCODE_BACKSLASH = 49, /**< Located at the lower left of the return
112 * key on ISO keyboards and at the right end
113 * of the QWERTY row on ANSI keyboards.
114 * Produces REVERSE SOLIDUS (backslash) and
115 * VERTICAL LINE in a US layout, REVERSE
116 * SOLIDUS and VERTICAL LINE in a UK Mac
117 * layout, NUMBER SIGN and TILDE in a UK
118 * Windows layout, DOLLAR SIGN and POUND SIGN
119 * in a Swiss German layout, NUMBER SIGN and
120 * APOSTROPHE in a German layout, GRAVE
121 * ACCENT and POUND SIGN in a French Mac
122 * layout, and ASTERISK and MICRO SIGN in a
123 * French Windows layout.
124 */
125 SDL_SCANCODE_NONUSHASH = 50, /**< ISO USB keyboards actually use this code
126 * instead of 49 for the same key, but all
127 * OSes I've seen treat the two codes
128 * identically. So, as an implementor, unless
129 * your keyboard generates both of those
130 * codes and your OS treats them differently,
131 * you should generate SDL_SCANCODE_BACKSLASH
132 * instead of this code. As a user, you
133 * should not rely on this code because SDL
134 * will never generate it with most (all?)
135 * keyboards.
136 */
139 SDL_SCANCODE_GRAVE = 53, /**< Located in the top left corner (on both ANSI
140 * and ISO keyboards). Produces GRAVE ACCENT and
141 * TILDE in a US Windows layout and in US and UK
142 * Mac layouts on ANSI keyboards, GRAVE ACCENT
143 * and NOT SIGN in a UK Windows layout, SECTION
144 * SIGN and PLUS-MINUS SIGN in US and UK Mac
145 * layouts on ISO keyboards, SECTION SIGN and
146 * DEGREE SIGN in a Swiss German layout (Mac:
147 * only on ISO keyboards), CIRCUMFLEX ACCENT and
148 * DEGREE SIGN in a German layout (Mac: only on
149 * ISO keyboards), SUPERSCRIPT TWO and TILDE in a
150 * French Windows layout, COMMERCIAL AT and
151 * NUMBER SIGN in a French Mac layout on ISO
152 * keyboards, and LESS-THAN SIGN and GREATER-THAN
153 * SIGN in a Swiss German, German, or French Mac
154 * layout on ANSI keyboards.
155 */
159
161
174
178 SDL_SCANCODE_INSERT = 73, /**< insert on PC, help on some Mac keyboards (but
179 does send code 73, not 117) */
189
190 SDL_SCANCODE_NUMLOCKCLEAR = 83, /**< num lock on PC, clear on Mac keyboards
191 */
208
209 SDL_SCANCODE_NONUSBACKSLASH = 100, /**< This is the additional key that ISO
210 * keyboards have over ANSI ones,
211 * located between left shift and Y.
212 * Produces GRAVE ACCENT and TILDE in a
213 * US or UK Mac layout, REVERSE SOLIDUS
214 * (backslash) and VERTICAL LINE in a
215 * US or UK Windows layout, and
216 * LESS-THAN SIGN and GREATER-THAN SIGN
217 * in a Swiss German, German, or French
218 * layout. */
219 SDL_SCANCODE_APPLICATION = 101, /**< windows contextual menu, compose */
220 SDL_SCANCODE_POWER = 102, /**< The USB document says this is a status flag,
221 * not a physical key - but some Mac keyboards
222 * do have a power key. */
237 SDL_SCANCODE_HELP = 117, /**< AL Integrated Help Center */
238 SDL_SCANCODE_MENU = 118, /**< Menu (show menu) */
240 SDL_SCANCODE_STOP = 120, /**< AC Stop */
241 SDL_SCANCODE_AGAIN = 121, /**< AC Redo/Repeat */
242 SDL_SCANCODE_UNDO = 122, /**< AC Undo */
243 SDL_SCANCODE_CUT = 123, /**< AC Cut */
244 SDL_SCANCODE_COPY = 124, /**< AC Copy */
245 SDL_SCANCODE_PASTE = 125, /**< AC Paste */
246 SDL_SCANCODE_FIND = 126, /**< AC Find */
250/* not sure whether there's a reason to enable these */
251/* SDL_SCANCODE_LOCKINGCAPSLOCK = 130, */
252/* SDL_SCANCODE_LOCKINGNUMLOCK = 131, */
253/* SDL_SCANCODE_LOCKINGSCROLLLOCK = 132, */
256
257 SDL_SCANCODE_INTERNATIONAL1 = 135, /**< used on Asian keyboards, see
258 footnotes in USB doc */
267 SDL_SCANCODE_LANG1 = 144, /**< Hangul/English toggle */
268 SDL_SCANCODE_LANG2 = 145, /**< Hanja conversion */
269 SDL_SCANCODE_LANG3 = 146, /**< Katakana */
270 SDL_SCANCODE_LANG4 = 147, /**< Hiragana */
271 SDL_SCANCODE_LANG5 = 148, /**< Zenkaku/Hankaku */
272 SDL_SCANCODE_LANG6 = 149, /**< reserved */
273 SDL_SCANCODE_LANG7 = 150, /**< reserved */
274 SDL_SCANCODE_LANG8 = 151, /**< reserved */
275 SDL_SCANCODE_LANG9 = 152, /**< reserved */
276
277 SDL_SCANCODE_ALTERASE = 153, /**< Erase-Eaze */
279 SDL_SCANCODE_CANCEL = 155, /**< AC Cancel */
289
336
339 SDL_SCANCODE_LALT = 226, /**< alt, option */
340 SDL_SCANCODE_LGUI = 227, /**< windows, command (apple), meta */
343 SDL_SCANCODE_RALT = 230, /**< alt gr, option */
344 SDL_SCANCODE_RGUI = 231, /**< windows, command (apple), meta */
345
346 SDL_SCANCODE_MODE = 257, /**< I'm not sure if this is really not covered
347 * by any of the above, but since there's a
348 * special SDL_KMOD_MODE for it I'm adding it here
349 */
350
351 /* @} *//* Usage page 0x07 */
352
353 /**
354 * \name Usage page 0x0C
355 *
356 * These values are mapped from usage page 0x0C (USB consumer page).
357 *
358 * There are way more keys in the spec than we can represent in the
359 * current scancode range, so pick the ones that commonly come up in
360 * real world usage.
361 */
362 /* @{ */
363
364 SDL_SCANCODE_SLEEP = 258, /**< Sleep */
365 SDL_SCANCODE_WAKE = 259, /**< Wake */
366
367 SDL_SCANCODE_CHANNEL_INCREMENT = 260, /**< Channel Increment */
368 SDL_SCANCODE_CHANNEL_DECREMENT = 261, /**< Channel Decrement */
369
370 SDL_SCANCODE_MEDIA_PLAY = 262, /**< Play */
371 SDL_SCANCODE_MEDIA_PAUSE = 263, /**< Pause */
372 SDL_SCANCODE_MEDIA_RECORD = 264, /**< Record */
373 SDL_SCANCODE_MEDIA_FAST_FORWARD = 265, /**< Fast Forward */
374 SDL_SCANCODE_MEDIA_REWIND = 266, /**< Rewind */
375 SDL_SCANCODE_MEDIA_NEXT_TRACK = 267, /**< Next Track */
376 SDL_SCANCODE_MEDIA_PREVIOUS_TRACK = 268, /**< Previous Track */
377 SDL_SCANCODE_MEDIA_STOP = 269, /**< Stop */
378 SDL_SCANCODE_MEDIA_EJECT = 270, /**< Eject */
379 SDL_SCANCODE_MEDIA_PLAY_PAUSE = 271, /**< Play / Pause */
380 SDL_SCANCODE_MEDIA_SELECT = 272, /* Media Select */
381
382 SDL_SCANCODE_AC_NEW = 273, /**< AC New */
383 SDL_SCANCODE_AC_OPEN = 274, /**< AC Open */
384 SDL_SCANCODE_AC_CLOSE = 275, /**< AC Close */
385 SDL_SCANCODE_AC_EXIT = 276, /**< AC Exit */
386 SDL_SCANCODE_AC_SAVE = 277, /**< AC Save */
387 SDL_SCANCODE_AC_PRINT = 278, /**< AC Print */
388 SDL_SCANCODE_AC_PROPERTIES = 279, /**< AC Properties */
389
390 SDL_SCANCODE_AC_SEARCH = 280, /**< AC Search */
391 SDL_SCANCODE_AC_HOME = 281, /**< AC Home */
392 SDL_SCANCODE_AC_BACK = 282, /**< AC Back */
393 SDL_SCANCODE_AC_FORWARD = 283, /**< AC Forward */
394 SDL_SCANCODE_AC_STOP = 284, /**< AC Stop */
395 SDL_SCANCODE_AC_REFRESH = 285, /**< AC Refresh */
396 SDL_SCANCODE_AC_BOOKMARKS = 286, /**< AC Bookmarks */
397
398 /* @} *//* Usage page 0x0C */
399
400
401 /**
402 * \name Mobile keys
403 *
404 * These are values that are often used on mobile phones.
405 */
406 /* @{ */
407
408 SDL_SCANCODE_SOFTLEFT = 287, /**< Usually situated below the display on phones and
409 used as a multi-function feature key for selecting
410 a software defined function shown on the bottom left
411 of the display. */
412 SDL_SCANCODE_SOFTRIGHT = 288, /**< Usually situated below the display on phones and
413 used as a multi-function feature key for selecting
414 a software defined function shown on the bottom right
415 of the display. */
416 SDL_SCANCODE_CALL = 289, /**< Used for accepting phone calls. */
417 SDL_SCANCODE_ENDCALL = 290, /**< Used for rejecting phone calls. */
418
419 /* @} *//* Mobile keys */
420
421 /* Add any other keys here. */
422
423 SDL_SCANCODE_RESERVED = 400, /**< 400-500 reserved for dynamic keycodes */
424
425 SDL_SCANCODE_COUNT = 512 /**< not a key, just marks the number of scancodes for array bounds */
426
428
429#endif /* SDL_scancode_h_ */
SDL_Scancode
@ SDL_SCANCODE_E
@ SDL_SCANCODE_END
@ SDL_SCANCODE_OUT
@ SDL_SCANCODE_AC_NEW
@ SDL_SCANCODE_BACKSLASH
@ SDL_SCANCODE_MEDIA_PREVIOUS_TRACK
@ SDL_SCANCODE_ESCAPE
@ SDL_SCANCODE_KP_OCTAL
@ SDL_SCANCODE_KP_CLEARENTRY
@ SDL_SCANCODE_KP_EXCLAM
@ SDL_SCANCODE_KP_DECIMAL
@ SDL_SCANCODE_F15
@ SDL_SCANCODE_M
@ SDL_SCANCODE_F12
@ SDL_SCANCODE_X
@ SDL_SCANCODE_W
@ SDL_SCANCODE_KP_E
@ SDL_SCANCODE_INTERNATIONAL4
@ SDL_SCANCODE_KP_PLUS
@ SDL_SCANCODE_MEDIA_REWIND
@ SDL_SCANCODE_F4
@ SDL_SCANCODE_LANG8
@ SDL_SCANCODE_RIGHTBRACKET
@ SDL_SCANCODE_MEDIA_PLAY
@ SDL_SCANCODE_INTERNATIONAL1
@ SDL_SCANCODE_INTERNATIONAL7
@ SDL_SCANCODE_KP_GREATER
@ SDL_SCANCODE_LANG2
@ SDL_SCANCODE_CAPSLOCK
@ SDL_SCANCODE_B
@ SDL_SCANCODE_F2
@ SDL_SCANCODE_KP_MINUS
@ SDL_SCANCODE_KP_00
@ SDL_SCANCODE_F6
@ SDL_SCANCODE_NONUSBACKSLASH
@ SDL_SCANCODE_KP_0
@ SDL_SCANCODE_KP_B
@ SDL_SCANCODE_F11
@ SDL_SCANCODE_CANCEL
@ SDL_SCANCODE_COMMA
@ SDL_SCANCODE_KP_PERIOD
@ SDL_SCANCODE_KP_F
@ SDL_SCANCODE_KP_LEFTPAREN
@ SDL_SCANCODE_F24
@ SDL_SCANCODE_AC_SAVE
@ SDL_SCANCODE_CUT
@ SDL_SCANCODE_Y
@ SDL_SCANCODE_KP_VERTICALBAR
@ SDL_SCANCODE_APOSTROPHE
@ SDL_SCANCODE_KP_HEXADECIMAL
@ SDL_SCANCODE_KP_COMMA
@ SDL_SCANCODE_KP_SPACE
@ SDL_SCANCODE_2
@ SDL_SCANCODE_KP_BACKSPACE
@ SDL_SCANCODE_AC_EXIT
@ SDL_SCANCODE_O
@ SDL_SCANCODE_CLEARAGAIN
@ SDL_SCANCODE_RGUI
@ SDL_SCANCODE_K
@ SDL_SCANCODE_F
@ SDL_SCANCODE_DELETE
@ SDL_SCANCODE_F10
@ SDL_SCANCODE_F3
@ SDL_SCANCODE_KP_AMPERSAND
@ SDL_SCANCODE_CHANNEL_INCREMENT
@ SDL_SCANCODE_KP_COLON
@ SDL_SCANCODE_CHANNEL_DECREMENT
@ SDL_SCANCODE_5
@ SDL_SCANCODE_KP_RIGHTPAREN
@ SDL_SCANCODE_H
@ SDL_SCANCODE_KP_D
@ SDL_SCANCODE_SLASH
@ SDL_SCANCODE_F1
@ SDL_SCANCODE_KP_EQUALS
@ SDL_SCANCODE_F21
@ SDL_SCANCODE_KP_6
@ SDL_SCANCODE_KP_HASH
@ SDL_SCANCODE_7
@ SDL_SCANCODE_9
@ SDL_SCANCODE_KP_TAB
@ SDL_SCANCODE_KP_7
@ SDL_SCANCODE_AC_REFRESH
@ SDL_SCANCODE_INTERNATIONAL9
@ SDL_SCANCODE_KP_9
@ SDL_SCANCODE_EXSEL
@ SDL_SCANCODE_MEDIA_FAST_FORWARD
@ SDL_SCANCODE_MEDIA_RECORD
@ SDL_SCANCODE_VOLUMEUP
@ SDL_SCANCODE_INTERNATIONAL8
@ SDL_SCANCODE_CRSEL
@ SDL_SCANCODE_ENDCALL
@ SDL_SCANCODE_NUMLOCKCLEAR
@ SDL_SCANCODE_MEDIA_PLAY_PAUSE
@ SDL_SCANCODE_PRINTSCREEN
@ SDL_SCANCODE_KP_XOR
@ SDL_SCANCODE_POWER
@ SDL_SCANCODE_KP_3
@ SDL_SCANCODE_SCROLLLOCK
@ SDL_SCANCODE_PAUSE
@ SDL_SCANCODE_RETURN
@ SDL_SCANCODE_KP_000
@ SDL_SCANCODE_HELP
@ SDL_SCANCODE_PAGEDOWN
@ SDL_SCANCODE_INTERNATIONAL3
@ SDL_SCANCODE_LSHIFT
@ SDL_SCANCODE_TAB
@ SDL_SCANCODE_STOP
@ SDL_SCANCODE_CURRENCYSUBUNIT
@ SDL_SCANCODE_LANG1
@ SDL_SCANCODE_3
@ SDL_SCANCODE_LCTRL
@ SDL_SCANCODE_SEMICOLON
@ SDL_SCANCODE_F16
@ SDL_SCANCODE_F22
@ SDL_SCANCODE_UNKNOWN
@ SDL_SCANCODE_KP_MEMCLEAR
@ SDL_SCANCODE_LGUI
@ SDL_SCANCODE_0
@ SDL_SCANCODE_KP_LESS
@ SDL_SCANCODE_AC_STOP
@ SDL_SCANCODE_OPER
@ SDL_SCANCODE_LEFTBRACKET
@ SDL_SCANCODE_KP_MEMSUBTRACT
@ SDL_SCANCODE_KP_A
@ SDL_SCANCODE_AC_SEARCH
@ SDL_SCANCODE_INTERNATIONAL2
@ SDL_SCANCODE_DECIMALSEPARATOR
@ SDL_SCANCODE_F19
@ SDL_SCANCODE_V
@ SDL_SCANCODE_EXECUTE
@ SDL_SCANCODE_GRAVE
@ SDL_SCANCODE_KP_LEFTBRACE
@ SDL_SCANCODE_MENU
@ SDL_SCANCODE_RALT
@ SDL_SCANCODE_MUTE
@ SDL_SCANCODE_SYSREQ
@ SDL_SCANCODE_8
@ SDL_SCANCODE_MEDIA_STOP
@ SDL_SCANCODE_I
@ SDL_SCANCODE_LANG4
@ SDL_SCANCODE_KP_PERCENT
@ SDL_SCANCODE_F17
@ SDL_SCANCODE_RETURN2
@ SDL_SCANCODE_LANG3
@ SDL_SCANCODE_KP_MEMADD
@ SDL_SCANCODE_KP_PLUSMINUS
@ SDL_SCANCODE_INTERNATIONAL5
@ SDL_SCANCODE_AC_OPEN
@ SDL_SCANCODE_THOUSANDSSEPARATOR
@ SDL_SCANCODE_6
@ SDL_SCANCODE_S
@ SDL_SCANCODE_KP_ENTER
@ SDL_SCANCODE_AC_BACK
@ SDL_SCANCODE_FIND
@ SDL_SCANCODE_KP_MEMSTORE
@ SDL_SCANCODE_PAGEUP
@ SDL_SCANCODE_Z
@ SDL_SCANCODE_P
@ SDL_SCANCODE_D
@ SDL_SCANCODE_F23
@ SDL_SCANCODE_PERIOD
@ SDL_SCANCODE_CALL
@ SDL_SCANCODE_KP_MEMRECALL
@ SDL_SCANCODE_MEDIA_NEXT_TRACK
@ SDL_SCANCODE_R
@ SDL_SCANCODE_KP_AT
@ SDL_SCANCODE_KP_1
@ SDL_SCANCODE_AC_BOOKMARKS
@ SDL_SCANCODE_KP_MEMMULTIPLY
@ SDL_SCANCODE_DOWN
@ SDL_SCANCODE_COPY
@ SDL_SCANCODE_RIGHT
@ SDL_SCANCODE_F7
@ SDL_SCANCODE_INTERNATIONAL6
@ SDL_SCANCODE_MINUS
@ SDL_SCANCODE_MEDIA_SELECT
@ SDL_SCANCODE_A
@ SDL_SCANCODE_MODE
@ SDL_SCANCODE_NONUSHASH
@ SDL_SCANCODE_WAKE
@ SDL_SCANCODE_LANG7
@ SDL_SCANCODE_ALTERASE
@ SDL_SCANCODE_G
@ SDL_SCANCODE_KP_2
@ SDL_SCANCODE_KP_RIGHTBRACE
@ SDL_SCANCODE_U
@ SDL_SCANCODE_AGAIN
@ SDL_SCANCODE_MEDIA_EJECT
@ SDL_SCANCODE_KP_EQUALSAS400
@ SDL_SCANCODE_KP_MULTIPLY
@ SDL_SCANCODE_KP_C
@ SDL_SCANCODE_KP_POWER
@ SDL_SCANCODE_4
@ SDL_SCANCODE_KP_DBLVERTICALBAR
@ SDL_SCANCODE_F9
@ SDL_SCANCODE_AC_PRINT
@ SDL_SCANCODE_F5
@ SDL_SCANCODE_AC_CLOSE
@ SDL_SCANCODE_UP
@ SDL_SCANCODE_LEFT
@ SDL_SCANCODE_KP_BINARY
@ SDL_SCANCODE_SELECT
@ SDL_SCANCODE_APPLICATION
@ SDL_SCANCODE_LANG5
@ SDL_SCANCODE_KP_4
@ SDL_SCANCODE_C
@ SDL_SCANCODE_HOME
@ SDL_SCANCODE_F14
@ SDL_SCANCODE_T
@ SDL_SCANCODE_KP_CLEAR
@ SDL_SCANCODE_F8
@ SDL_SCANCODE_LALT
@ SDL_SCANCODE_KP_8
@ SDL_SCANCODE_MEDIA_PAUSE
@ SDL_SCANCODE_PASTE
@ SDL_SCANCODE_RCTRL
@ SDL_SCANCODE_F20
@ SDL_SCANCODE_KP_5
@ SDL_SCANCODE_L
@ SDL_SCANCODE_UNDO
@ SDL_SCANCODE_KP_DBLAMPERSAND
@ SDL_SCANCODE_CLEAR
@ SDL_SCANCODE_LANG6
@ SDL_SCANCODE_AC_HOME
@ SDL_SCANCODE_VOLUMEDOWN
@ SDL_SCANCODE_SOFTRIGHT
@ SDL_SCANCODE_SLEEP
@ SDL_SCANCODE_KP_DIVIDE
@ SDL_SCANCODE_PRIOR
@ SDL_SCANCODE_F18
@ SDL_SCANCODE_F13
@ SDL_SCANCODE_RESERVED
@ SDL_SCANCODE_CURRENCYUNIT
@ SDL_SCANCODE_N
@ SDL_SCANCODE_SOFTLEFT
@ SDL_SCANCODE_BACKSPACE
@ SDL_SCANCODE_LANG9
@ SDL_SCANCODE_EQUALS
@ SDL_SCANCODE_SPACE
@ SDL_SCANCODE_COUNT
@ SDL_SCANCODE_SEPARATOR
@ SDL_SCANCODE_RSHIFT
@ SDL_SCANCODE_INSERT
@ SDL_SCANCODE_AC_FORWARD
@ SDL_SCANCODE_KP_MEMDIVIDE
@ SDL_SCANCODE_J
@ SDL_SCANCODE_AC_PROPERTIES
@ SDL_SCANCODE_1
@ SDL_SCANCODE_Q