2024-05-30 02:02:10 +00:00
<!DOCTYPE html>
< html lang = "en-US" dir = "ltr" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
< title > Supporting Your Keyboard in QMK Configurator | QMK Firmware< / title >
< meta name = "description" content = "Documentation for QMK Firmware" >
< meta name = "generator" content = "VitePress v1.1.3" >
2024-05-31 00:38:24 +00:00
< link rel = "preload stylesheet" href = "/assets/style.No8zk9aC.css" as = "style" >
2024-05-30 02:02:10 +00:00
2024-11-12 02:20:09 +00:00
< script type = "module" src = "/assets/app.lJkKpnnX.js" > < / script >
2024-05-30 02:02:10 +00:00
< link rel = "preload" href = "/assets/inter-roman-latin.Di8DUHzh.woff2" as = "font" type = "font/woff2" crossorigin = "" >
2024-11-12 02:20:09 +00:00
< link rel = "modulepreload" href = "/assets/chunks/theme.Onz3p0tR.js" >
2024-09-24 08:56:37 +00:00
< link rel = "modulepreload" href = "/assets/chunks/framework.B9AX-CPi.js" >
< link rel = "modulepreload" href = "/assets/reference_configurator_support.md.X0J2tW_B.lean.js" >
2024-05-30 02:02:10 +00:00
< script id = "check-dark-mode" > ( ( ) => { const e = localStorage . getItem ( "vitepress-theme-appearance" ) || "auto" , a = window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ; ( ! e || e === "auto" ? a : e === "dark" ) && document . documentElement . classList . add ( "dark" ) } ) ( ) ; < / script >
< script id = "check-mac-os" > document . documentElement . classList . toggle ( "mac" , /Mac|iPhone|iPod|iPad/i . test ( navigator . platform ) ) ; < / script >
< / head >
< body >
2024-11-09 19:05:30 +00:00
< div id = "app" > < div class = "Layout" data-v-5d98c3a5 > <!-- [ --> <!-- ] --> <!-- [ --> < span tabindex = "-1" data-v-0f60ec36 > < / span > < a href = "#VPContent" class = "VPSkipLink visually-hidden" data-v-0f60ec36 > Skip to content < / a > <!-- ] --> <!-- --> < header class = "VPNav" data-v-5d98c3a5 data-v-ae24b3ad > < div class = "VPNavBar has-sidebar top" data-v-ae24b3ad data-v-ccf7ddec > < div class = "wrapper" data-v-ccf7ddec > < div class = "container" data-v-ccf7ddec > < div class = "title" data-v-ccf7ddec > < div class = "VPNavBarTitle has-sidebar" data-v-ccf7ddec data-v-ab179fa1 > < a class = "title" href = "/" data-v-ab179fa1 > <!-- [ --> <!-- ] --> <!-- [ --> <!-- [ --> <!-- [ --> < img class = "VPImage dark logo" src = "/qmk-logo-dark.svg" alt data-v-8426fc1a > <!-- ] --> <!-- [ --> < img class = "VPImage light logo" src = "/qmk-logo-light.svg" alt data-v-8426fc1a > <!-- ] --> <!-- ] --> <!-- ] --> < span data-v-ab179fa1 > QMK Firmware< / span > <!-- [ --> <!-- ] --> < / a > < / div > < / div > < div class = "content" data-v-ccf7ddec > < div class = "content-body" data-v-ccf7ddec > <!-- [ --> <!-- ] --> < div class = "VPNavBarSearch search" data-v-ccf7ddec > <!-- [ --> <!-- --> < div id = "local-search" > < button type = "button" class = "DocSearch DocSearch-Button" aria-label = "Search" > < span class = "DocSearch-Button-Container" > < span class = "vp-icon DocSearch-Search-Icon" > < / span > < span class = "DocSearch-Button-Placeholder" > Search< / span > < / span > < span class = "DocSearch-Button-Keys" > < kbd class = "DocSearch-Button-Key" > < / kbd > < kbd class = "DocSearch-Button-Key" > K< / kbd > < / span > < / button > < / div > <!-- ] --> < / div > < nav aria-labelledby = "main-nav-aria-label" class = "VPNavBarMenu menu" data-v-ccf7ddec data-v-7f418b0f > < span id = "main-nav-aria-label" class = "visually-hidden" data-v-7f418b0f > Main Navigation< / span > <!-- [ --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "/" tabindex = "0" data-v-7f418b0f data-v-9c663999 > <!-- [ --> < span data-v-9c663999 > Home< / span > <!-- ] --> < / a > <!-- ] --> <!-- ] --> < / nav > <!-- --> < div class = "VPNavBarAppearance appearance" data-v-ccf7ddec data-v-e6aabb21 > < button class = "VPSwitch VPSwitchAppearance" type = "button" role = "switch" title = "Switch to dark theme" aria-checked = "false" data-v-e6aabb21 data-v-d1f28634 data-v-1d5665e3 > < span class = "check" data-v-1d5665e3 > < span class = "icon" data-v-1d5665e3 > <!-- [ --> < span class = "vpi-sun sun" data-v-d1f28634 > < / span > < span class = "vpi-moon moon" data-v-d1f28634 > < / span > <!-- ] --> < / span > < / span > < / button > < / div > < div class = "VPSocialLinks VPNavBarSocialLinks social-links" data-v-ccf7ddec data-v-0394ad82 data-v-7bc22406 > <!-- [ --> < a class = "VPSocialLink no-icon" href = "https://reddit.com/r/olkb" aria-label target = "_blank" rel = "noopener" data-v-7bc22406 data-v-eee4e7cb > < svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 50 50" width = "50px" height = "50px" > < path d = "M 29 3 C 28 . 0625 3 27 . 164063 3 . 382813 26 . 5 4 C 25 . 835938 4 . 617188 25 . 363281 5 . 433594 25 6 . 40625 C 24 . 355469 8 . 140625 24 . 085938 10 . 394531 24 . 03125 13 . 03125 C 19 . 234375 13 . 179688 14 . 820313 14 . 421875 11 . 28125 16 . 46875 C 10 . 214844 15 . 46875 8 . 855469 14 . 96875 7 . 5 14 . 96875 C 6 . 089844 14 . 96875 4 . 675781 15 . 511719 3 . 59375 16 . 59375 C 1 . 425781 18 . 761719 1 . 425781 22 . 238281 3 . 59375 24 . 40625 L 3 . 84375 24 . 65625 C 3 . 3125 26 . 035156 3 27 . 488281 3 29 C 3 33 . 527344 5 . 566406 37 . 585938 9 . 5625 40 . 4375 C 13 . 558594 43 . 289063 19 . 007813 45 25 45 C 30 . 992188 45 36 . 441406 43 . 289063 40 . 4375 40 . 4375 C 44 . 433594 37 . 585938 47 33 . 527344 47 29 C 47 27 . 488281 46 . 6875 26 . 035156 46 . 15625 24 . 65625 L 46 . 40625 24 . 40625 C 48 . 574219 22 . 238281 48 . 574219 18 . 761719 46 . 40625 16 . 59375 C 45 . 324219 15 . 511719 43 . 910156 14 . 96875 42 . 5 14 . 96875 C 41 . 144531 14 . 96875 39 . 785156 15 . 46875 38 . 71875 16 . 46875 C 35 . 195313 14 . 433594 30 . 800781 13 . 191406 26 . 03125 13 . 03125 C 26 . 09375 10 . 546875 26 . 363281 8 . 46875 26 . 875 7 . 09375 C 27 . 164063 6 . 316406 27 . 527344 5 . 757813 27 . 875 5 . 4375 C 28 . 222656 5 . 117188 28 . 539063 5 29 5 C 29 . 460938 5 29 . 683594 5 . 125 30 . 03125 5 . 40625 C 30 . 378906 5 . 6875 30 . 785156 6 . 148438 31 . 3125 6 . 6875 C 32 . 253906 7 . 652344 33 . 695313 8 . 714844 36 . 09375 8 . 9375 C 36 . 539063 11 . 238281 38 . 574219 13 41 13 C 43 . 75 13 46 10 . 75 46 8 C 46 5 . 25 43 . 75 3 41 3 C 38 . 605469 3 36 . 574219 4 . 710938 36 . 09375 6 . 96875 C 34 . 3125 6 . 796875 33 . 527344 6 . 109375 32 . 75 5 . 3125 C 32 . 300781 4 . 851563 31 . 886719 4
2024-05-30 02:02:10 +00:00
< span class = "line" > < span > |NLk| / | * | - |< / span > < / span >
< span class = "line" > < span > |---+---+---+---|< / span > < / span >
< span class = "line" > < span > |7 |8 |9 | + |< / span > < / span >
< span class = "line" > < span > |---+---+---| |< / span > < / span >
< span class = "line" > < span > |4 |5 |6 | |< / span > < / span >
< span class = "line" > < span > |---+---+---+---|< / span > < / span >
< span class = "line" > < span > |1 |2 |3 |Ent|< / span > < / span >
< span class = "line" > < span > |-------+---| |< / span > < / span >
< span class = "line" > < span > |0 | . | |< / span > < / span >
< span class = "line" > < span > |---------------|< / span > < / span > < / code > < / pre > < / div > < div class = "tip custom-block" > < p class = "custom-block-title" > TIP< / p > < p > For more on layout macros, see < a href = "./understanding_qmk#matrix-scanning" > Understanding QMK: Matrix Scanning< / a > and < a href = "./understanding_qmk#matrix-to-physical-layout-map" > Understanding QMK: Matrix to Physical Layout Map< / a > .< / p > < / div > < p > The Configurator' s API reads the keyboard' s < code > .h< / code > file from < code > qmk_firmware/keyboards/< keyboard> /< keyboard> .h< / code > . For our numpad, this file would be < code > qmk_firmware/keyboards/numpad/numpad.h< / code > :< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #pragma< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > once< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > LAYOUT< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ( < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k00, k01, k02, k03, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k10, k11, k12, k13, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k20, k21, k22, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k30, k31, k32, k33, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k40, k42 < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) { < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k00, k01, k02, k03 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k10, k11, k12, k13 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k20, k21, k22, KC_NO }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k30, k31, k32, k33 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k40, KC_NO, k42, KC_NO } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < p > QMK uses < code > KC_NO< / code > to designate places in the switch matrix where there is no switch. Sometimes, < code > XXX< / code > , < code > ___< / code > or < code > ____< / code > are used as shorthand to make this section easier to read if it needs to be debugged. This is usually defined near the beginning of the < code > .h< / code > file:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #pragma< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > once< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > XXX< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > KC_NO< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > LAYOUT< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ( < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k00, k01, k02, k03, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k10, k11, k12, k13, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k20, k21, k22, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k30, k31, k32, k33, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > k40, k42 < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) { < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k00, k01, k02, k03 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k10, k11, k12, k13 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k20, k21, k22, XXX }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k30, k31, k32, k33 }, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { k40, XXX, k42, XXX } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < div class = "warning custom-block" > < p class = "custom-block-title" > WARNING< / p > < p > This usage differs from that of keymap macros, which almost always use < code > XXXXXXX< / code > (seven capital X' s) for < code > KC_NO< / code > and < code > _______< / code > (seven underscores) for < code > KC_TRNS< / code > .< / p > < / div > < div class = "warning custom-block" > < p class = "custom-block-title" > WARNING< / p > < p > To prevent user confusion, using < code > KC_NO< / code > is preferred.< / p > < / div > < p > The layout macro tells the Configurator that our keyboard has 17 keys, arranged in five rows of four columns each. Our switch positions are named < code > k< row> < column> < / code > , counting from 0. The names themselves actually don' t matter, as long as they match between the top section, which receives the keycodes from the keymap, and the bottom half which designates where each key is in the matrix.< / p > < p > To display our keyboard in a way that resembles the physical keyboard, we need to build a JSON file that tells the Configurator how to tie the physical locations and sizes of our keys to our switch matrix.< / p > < h2 id = "building-the-json-file" tabindex = "-1" > Building the JSON file < a class = "header-anchor" href = "#building-the-json-file" aria-label = "Permalink to "Building the JSON file"" > < / a > < / h2 > < p > To build the JSON file, the easiest way is to build the layout in < a href = "https://www.keyboard-layout-editor.com/" target = "_blank" rel = "noreferrer" > Keyboard Layout Editor< / a > (" KLE" ), from which we' ll feed the Raw Data into a QMK tool that converts this data into a JSON the Configurator will read and use. Since KLE opens by default with a numpad layout, we' re just going to remove the Getting Started instructions, and use what' s left.< / p > < p > Once the layout is as desired, move to the Raw Data tab in KLE, and copy the contents:< / p > < div class = "language- vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > < / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span > [" Num Lock" ," /" ," *" ," -" ],< / span > < / span >
< span class = "line" > < span > [" 7\nHome" ," 8\n↑" ," 9\nPgUp" ,{h:2}," +" ],< / span > < / span >
< span class = "line" > < span > [" 4\n←" ," 5" ," 6\n→" ],< / span > < / span >
< span class = "line" > < span > [" 1\nEnd" ," 2\n↓" ," 3\nPgDn" ,{h:2}," Enter" ],< / span > < / span >
< span class = "line" > < span > [{w:2}," 0\nIns" ," .\nDel" ]< / span > < / span > < / code > < / pre > < / div > < p > To convert this data into our JSON, go to the < a href = "https://qmk.fm/converter/" target = "_blank" rel = "noreferrer" > QMK KLE-JSON Converter< / a > , paste the Raw Data into the Input field, and click the Convert button. After a moment, our JSON data will appear in the Output field. Copy the contents to a new text document, and name the document < code > info.json< / code > , saving it in the same folder that contains < code > numpad.h< / code > .< / p > < p > Use the < code > keyboard_name< / code > object to set the name of the keyboard. For instruction purposes, we will put each key' s object on its own line. This is only to make the file more human-readable, and does not affect the Configurator' s functionality.< / p > < div class = "language-json vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > json< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " keyboard_name" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Numpad" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " url" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " maintainer" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " qmk" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " tags" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " form_factor" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " numpad" < / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " layouts" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " LAYOUT" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " layout" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : [< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Num Lock" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " /" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " *" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " -" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 7" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 8" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 9" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " +" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " h" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 4" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 5" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 6" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 1" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 2" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 3" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Enter" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " h" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " 0" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " w" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > },< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " label" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " ." < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " x" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > " y" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ]< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < p > The < code > layouts< / code > object contains the data that represents the physical layout of the keyboard. It has an object < code > LAYOUT< / code > , which needs to match the name of our layout macro from < code > numpad.h< / code > . The < code > LAYOUT< / code > object itself has an object named < code > layout< / code > , which contains one JSON object for each physical key on our keyboard, formatted as follows:< / p > < div class = "language- vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > < / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span > The name of the key. Not displayed in the Configurator.< / span > < / span >
< span class = "line" > < span > |< / span > < / span >
< span class = "line" > < span > | The key' s X-axis location, in key units from the< / span > < / span >
< span class = "line" > < span > | | keyboard' s left edge.< / span > < / span >
< span class = "line" > < span > | |< / span > < / span >
< span class = "line" > < span > | | The key' s Y-axis location, in key units from< / span > < / span >
< span class = "line" > < span > | | | the keyboard' s top (rear-facing) edge.< / span > < / span >
< span class = "line" > < span > ↓ ↓ ↓< / span > < / span >
< span class = "line" > < span > {" label" :" Num Lock" , " x" :0, " y" :0},< / span > < / span > < / code > < / pre > < / div > < p > Some objects will also have < code > " w" < / code > and < code > " h" < / code > keys, which represent a key' s width and height, respectively.< / p > < div class = "tip custom-block" > < p class = "custom-block-title" > TIP< / p > < p > For more on the < code > info.json< / code > files, see < a href = "./reference_info_json" > < code > info.json< / code > Format< / a > .< / p > < / div > < h2 id = "how-the-configurator-programs-keys" tabindex = "-1" > How the Configurator Programs Keys < a class = "header-anchor" href = "#how-the-configurator-programs-keys" aria-label = "Permalink to "How the Configurator Programs Keys"" > < / a > < / h2 > < p > The Configurator' s API uses the layout macro and the JSON file we' ve given it to create a visual representation of the keyboard that has each visual object tied to a specific key, in sequence:< / p > < table label: . , = " " x:2 , = " " y:4 = "" > < thead > < tr > < th style = "text-align:center;" > key in layout macro< / th > < th style = "text-align:left;" > JSON object used< / th > < / tr > < / thead > < tbody > < tr label:NumLock , = " " x:0 , = " " y:0 = "" > < td style = "text-align:center;" > k00< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label: , = " " x:1 , = " " y:0 = "" > < td style = "text-align:center;" > k01< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label: * , = " " x:2 , = " " y:0 = "" > < td style = "text-align:center;" > k02< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:- , = " " x:3 , = " " y:0 = "" > < td style = "text-align:center;" > k03< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:7 , = " " x:0 , = " " y:1 = "" > < td style = "text-align:center;" > k10< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:8 , = " " x:1 , = " " y:1 = "" > < td style = "text-align:center;" > k11< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:9 , = " " x:2 , = " " y:1 = "" > < td style = "text-align:center;" > k12< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label: + , = " " x:3 , = " " y:1 , = " " h:2 = "" > < td style = "text-align:center;" > k13< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:4 , = " " x:0 , = " " y:2 = "" > < td style = "text-align:center;" > k20< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:5 , = " " x:1 , = " " y:2 = "" > < td style = "text-align:center;" > k21< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:6 , = " " x:2 , = " " y:2 = "" > < td style = "text-align:center;" > k22< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:1 , = " " x:0 , = " " y:3 = "" > < td style = "text-align:center;" > k30< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:2 , = " " x:1 , = " " y:3 = "" > < td style = "text-align:center;" > k31< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:3 , = " " x:2 , = " " y:3 = "" > < td style = "text-align:center;" > k32< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:Enter , = " " x:3 , = " " y:3 , = " " h:2 = "" > < td style = "text-align:center;" > k33< / td > < td style = "text-align:left;" > < / td > < / tr > < tr label:0 , = " " x:0 , = " " y:4 , = " " w:2 = "" > < td style = "text-align:center;" > k40< / td > < td style = "text-align:left;" > < / td > < / tr > < tr > < td style = "text-align:center;" > k42< / td > < td style = "text-align:left;" > < / td > < / tr > < / tbody > < / table > < p > When a user selects the top-left key in the Configurator, and assigns Num Lock to it, the Configurator builds a keymap file with < code > KC_NUM< / code > as the first key, and so on as the keymap is built. The < code > label< / code > keys are not used; they are only for the user' s reference in identifying specific keys when debugging the < code > info.json< / code > file.< / p > < h2 id = "issues-and-hazards" tabindex = "-1" > Issues and Hazards < a class = "header-anchor" href = "#issues-and-hazards" aria-label = "Permalink to "Issues and Hazards"" > < / a > < / h2 > < p > Currently, the Configurator does not support key rotation or non-rectangular key shapes like ISO Enter. Additionally, keys that are vertically-offset from their " row" — the arrow keys on 1800-layouts like the < a href = "https://github.com/qmk/qmk_firmware/tree/4ac48a61a66206beaf2fdd5f2939d8bbedd0004c/keyboards/tkc1800/" target = "_blank" rel = "noreferrer" > TKC1800< / a > being a prominent example — confuse the KLE-to-JSON Converter, if not adjusted for by the contributor of the < code > info.json< / code > file.< / p > < h3 id = "workarounds" tabindex = "-1" > W
2024-11-09 19:05:30 +00:00
< script > w i n d o w . _ _ V P _ H A S H _ M A P _ _ = J S O N . p a r s e ( " { \ " c h a n g e l o g _ 2 0 1 9 0 8 3 0 . m d \ " : \ " 6 X i x y P 8 L \ " , \ " c h a n g e l o g _ 2 0 2 0 0 2 2 9 . m d \ " : \ " B m e R J e n e \ " , \ " c h a n g e l o g _ 2 0 2 0 0 5 3 0 . m d \ " : \ " q 1 N x 4 B s f \ " , \ " c h a n g e l o g _ 2 0 2 0 0 8 2 9 . m d \ " : \ " D P w M x U V b \ " , \ " c h a n g e l o g _ 2 0 2 0 1 1 2 8 . m d \ " : \ " c y E K i 6 m d \ " , \ " c h a n g e l o g _ 2 0 2 1 0 2 2 7 . m d \ " : \ " D - q Z N A t E \ " , \ " c h a n g e l o g _ 2 0 2 1 0 5 2 9 . m d \ " : \ " C M C D B s S T \ " , \ " c h a n g e l o g _ 2 0 2 1 0 8 2 8 . m d \ " : \ " B z _ C q h k z \ " , \ " c h a n g e l o g _ 2 0 2 1 1 1 2 7 . m d \ " : \ " C K q Q n O 6 y \ " , \ " c h a n g e l o g _ 2 0 2 2 0 2 2 6 . m d \ " : \ " C y V o L O N s \ " , \ " c h a n g e l o g _ 2 0 2 2 0 5 2 8 . m d \ " : \ " C i h U A 7 f i \ " , \ " c h a n g e l o g _ 2 0 2 2 0 8 2 7 . m d \ " : \ " D f 1 n z x 8 O \ " , \ " c h a n g e l o g _ 2 0 2 2 1 1 2 6 . m d \ " : \ " C o q j 0 Y N T \ " , \ " c h a n g e l o g _ 2 0 2 3 0 2 2 6 . m d \ " : \ " k W J u s v X j \ " , \ " c h a n g e l o g _ 2 0 2 3 0 5 2 8 . m d \ " : \ " B Q O X A 7 r R \ " , \ " c h a n g e l o g _ 2 0 2 3 0 8 2 7 . m d \ " : \ " C y s q T d A P \ " , \ " c h a n g e l o g _ 2 0 2 3 1 1 2 6 . m d \ " : \ " D 6 J l a C S H \ " , \ " c h a n g e l o g _ 2 0 2 4 0 2 2 5 . m d \ " : \ " D m b H o - a A \ " , \ " c h a n g e l o g _ 2 0 2 4 0 5 2 6 . m d \ " : \ " C h e v S 3 S M \ " , \ " c h a n g e l o g _ 2 0 2 4 0 8 2 5 . m d \ " : \ " B i m 1 x I 0 9 \ " , \ " c a p a b i l i t i e s . m d \ " : \ " C 8 e G a s T O \ " , \ " c a p a b i l i t i e s _ i n c . m d \ " : \ " P t 7 2 L 4 b 9 \ " , \ " a p i _ d e v e l o p m e n t _ e n v i r o n m e n t . m d \ " : \ " C o 1 L k u h l \ " , \ " a p i _ d e v e l o p m e n t _ o v e r v i e w . m d \ " : \ " i U K 6 G G b G \ " , \ " a p i _ d o c s . m d \ " : \ " D r P e v C - R \ " , \ " a p i _ o v e r v i e w . m d \ " : \ " B 3 s D K D J g \ " , \ " a r m _ d e b u g g i n g . m d \ " : \ " B i R X U 6 n l \ " , \ " b r e a k i n g _ c h a n g e s . m d \ " : \ " B I p M 1 J D F \ " , \ " b r e a k i n g _ c h a n g e s _ h i s t o r y . m d \ " : \ " B _ y w 4 m v F \ " , \ " b r e a k i n g _ c h a n g e s _ i n s t r u c t i o n s . m d \ " : \ " D U u 8 T d u 8 \ " , \ " c h i b i o s _ u p g r a d e _ i n s t r u c t i o n s . m d \ " : \ " B k S - x C Q h \ " , \ " c l i . m d \ " : \ " C t 8 - g h 6 7 \ " , \ " c l i _ c o m m a n d s . m d \ " : \ " C i j N W 8 - t \ " , \ " c l i _ c o n f i g u r a t i o n . m d \ " : \ " D T 4 O 5 Q r b \ " , \ " c l i _ d e v e l o p m e n t . m d \ " : \ " C 1 R M b r q W \ " , \ " c l i _ t a b _ c o m p l e t e . m d \ " : \ " C T 9 N B E M 3 \ " , \ " c o d i n g _ c o n v e n t i o n s _ c . m d \ " : \ " B i 7 E H 0 Z k \ " , \ " c o d i n g _ c o n v e n t i o n s _ p y t h o n . m d \ " : \ " C 4 5 w o Q X 8 \ " , \ " c o m p a t i b l e _ m i c r o c o n t r o l l e r s . m d \ " : \ " C 3 R S s s e l \ " , \ " c o n f i g _ o p t i o n s . m d \ " : \ " B r o S R r l f \ " , \ " c o n f i g u r a t o r _ a r c h i t e c t u r e . m d \ " : \ " C l R U n O l V \ " , \ " c o n f i g u r a t o r _ d e f a u l t _ k e y m a p s . m d \ " : \ " B t b 4 Y _ - z \ " , \ " c o n f i g u r a t o r _ s t e p _ b y _ s t e p . m d \ " : \ " B h h r r - K Z \ " , \ " c o n f i g u r a t o r _ t r o u b l e s h o o t i n g . m d \ " : \ " C y T H _ M O _ \ " , \ " c o n t r i b u t i n g . m d \ " : \ " Z 2 K a w Z J M \ " , \ " c u s t o m _ m a t r i x . m d \ " : \ " C 5 W x x s 1 8 \ " , \ " c u s t o m _ q u a n t u m _ f u n c t i o n s . m d \ " : \ " C c h H k Q 2 j \ " , \ " d a t a _ d r i v e n _ c o n f i g . m d \ " : \ " C e m h r D n h \ " , \ " d o c u m e n t a t i o n _ b e s t _ p r a c t i c e s . m d \ " : \ " D _ 2 t 5 S C y \ " , \ " d o c u m e n t a t i o n _ t e m p l a t e s . m d \ " : \ " D N S T M F Q T \ " , \ " d r i v e r _ i n s t a l l a t i o n _ z a d i g . m d \ " : \ " C z M M y I t w \ " , \ " d r i v e r s _ a d c . m d \ " : \ " C d K 8 A t n R \ " , \ " d r i v e r s _ a p a 1 0 2 . m d \ " : \ " D 1 i 8 N 4 Y l \ " , \ " d r i v e r s _ a u d i o . m d \ " : \ " F G a a r c o q \ " , \ " d r i v e r s _ a w 2 0 2 1 6 s . m d \ " : \ " D F O 5 q a X Q \ " , \ " d r i v e r s _ e e p r o m . m d \ " : \ " D j b S p Q A l \ " , \ " d r i v e r s _ f l a s h . m d \ " : \ " T p T o e b Z V \ " , \ " d r i v e r s _ g p i o . m d \ " : \ " _ T - X R 1 i 8 \ " , \ " d r i v e r s _ i 2 c . m d \ " : \ " C Z 3 y U q U c \ " , \ " d r i v e r s _ i s 3 1 f l 3 2 1 8 . m d \ " : \ " B w 4 Q Y v x z \ " , \ " d r i v e r s _ i s 3 1 f l 3 2 3 6 . m d \ " : \ " k w _ 4 W o m B \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 2 9 . m d \ " : \ " B 0 5 F Y a E a \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 1 . m d \ " : \ " E b a J G c w l \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 3 . m d \ " : \ " C x i W N 3 q f \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 6 . m d \ " : \ " C N s B 3 5 B n \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 7 . m d \ " : \ " d F r K n s K N \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 1 . m d \ " : \ " D C b d J x E 4 \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 2 a . m d \ " : \ " B h 9 Q 6 Z t 4 \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 3 a . m d \ " : \ " W _ E O D x f i \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 5 . m d \ " : \ " D d _ r i P p V \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 6 a . m d \ " : \ " D a W S 0 7 R z \ " , \ " d r i v e r s _ s e r i a l . m d \ " : \ " B 9 c d h v Z Y \ " , \ " d r i v e r s _ s n l e d 2 7 3 5 1 . m d \ " : \ " C 2 0 2 O T O _ \ " , \ " d r i v e r s _ s p i . m d \ " : \ " K J w J 1 b D T \ " , \ " d r i v e r s _ u a r t . m d \ " : \ " D 5 b f 2 E z 7 \ " , \ " d r i v e r s _ w s 2 8 1 2 . m d \ " : \ " _ c n U p P J K \ " , \ " e a s y _ m a k e r . m d \ " : \ " B 1 e 0 p _ K P \ " , \ " f a q _ b u i l d . m d \ " : \ " C d M V - b m r \ " , \ " f a q _ d e b u g . m d \ " : \ " f a g c c K f w \ " , \ " f a q _ g e n e r a l . m d \ " : \ " B S 8 d I C f T \ " , \ " f a q _ k e y m a p . m d \ " : \ " C m J j c 7 A B \ " , \ " f a q _ m i s c . m d \ " : \ " p u g C g T 2 3 \ " , \ " f e a t u r e _ a d v a n c e d _ k e y c o d e s . m d \ " : \ " D c 4 4 p i 1 G \ " , \ " f e a t u r e _ c o n v e r t e r s . m d \ " : \ " n b s y 9 v m L \ " , \ " f e a t u r e _ d e b o u n c e _ t y p e . m d \ " : \ " B c X 3 f a C S \ " , \ " f e a t u r e _ e e p r o m . m d \ " : \ " C r K I b 9 b y \ " , \ " f e a t u r e _ l a y e r s . m d \ " : \ " m Z M m A I 4 u \ " , \ " f e a t u r e _ l a y o u t s . m d \ " : \ " C C 3 G U G 9 e \ " , \ " f e a t u r e _ m a c r o s . m d \ " : \ " b o 5 m 0 5 v P \ " , \ " f e a t u r e _ u s e r s p a c e . m d \ " : \ " D z g y E Z m 9 \ " , \ " f e a t u r e s _ a u d i o . m d \ " : \ " B 4 y w w 0 J U \ " , \ " f e a t u r e s _ a u t o _ s h i f t . m d \ " : \ " g b N 4 U b G 7 \ " , \ " f e a t u r e s _ a u t o c o r r e c t . m d \ " : \ " B g q t S x c - \ " , \ " f e a t u r e s _ b a c k l i g h t . m d \ " : \ " B t Y u f 8 h b \ " , \ " f e a t u r e s _ b l u e t o o t h . m d \ " : \ " D B 3 P F l c y \ " , \ " f e a t u r e s _ b o o t m a g i c . m d \ " : \ " D B d R U 1 3 9 \ " , \ " f e a t u r e s _ c a p s _ w o r d . m d \ " : \ " C z 8 - U a 5 R \ " , \ " f e a t u r e s _ c o m b o . m d \ " : \ " n Q w t f Y K J \ " , \ " f e a t u r e s _ c o m m a n d . m d \ " : \ " D D U 6 f J S P \ " , \ " f e a t u r e s _ d i g i t i z e r . m d \ " : \ " q N C 7 c D m j \ " , \ " f e a t u r e s _ d i p _ s w i t c h . m d \ " : \ " D Q 7 j E i p z \ " , \ " f e a t u r e s _ d y n a m i c _ m a c r o s . m d \ " : \ " C m Y 3 E Y f K \ " , \ " f e a t u r e s _ e n c o d e r s . m d \ " : \ " C w 1 N 3 h G V \ " , \ " f e a t u r e s _ g r a v e _ e s c . m d \ " : \ " R G W i Z P w 2 \ " , \ " f e a t u r e s _ h a p t i c _ f e e d b a c k . m d \ " : \ " g C Z C x Z p h \ " , \ " f e a t u r e s _ h d 4
2024-05-30 02:02:10 +00:00
< / body >
< / html >
