aboutsummaryrefslogtreecommitdiff
path: root/docs/ja/keymap.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ja/keymap.md')
-rw-r--r--docs/ja/keymap.md187
1 files changed, 187 insertions, 0 deletions
diff --git a/docs/ja/keymap.md b/docs/ja/keymap.md
new file mode 100644
index 000000000..7614e5243
--- /dev/null
+++ b/docs/ja/keymap.md
@@ -0,0 +1,187 @@
1# キーマップの概要
2
3<!---
4 original document: 0.9.44:docs/keymap.md
5 git diff 0.9.44 HEAD -- docs/keymap.md | cat
6-->
7
8QMK のキーマップは C のソースファイルの中で定義されます。そのデータ構造は配列の配列です。外側はレイヤーを要素とする配列で、レイヤーはキーを要素とする配列。ほとんどのキーボードは `LAYOUT()` マクロを定義して、この配列の配列を作成しやすくしています。
9
10
11## キーマップとレイヤー :id=keymap-and-layers
12QMKでは、**`const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS]`**は、**アクションコード**を保持している **16 bit** データの中でキーマップ情報の複数の**レイヤー**を保持します。最大で**32個のレイヤー**を定義することができます。
13
14普通のキー定義の場合、**アクションコード**の上位8ビットは全て0で、下位8ビットは**キーコード**としてキーによって生成された USB HID usage コードを保持します。
15
16各レイヤーは同時に有効にできます。レイヤーには 0 から 31 までのインデックスが付けられ、上位のレイヤーが優先されます。
17
18 Keymap: 32 Layers Layer: action code matrix
19 ----------------- ---------------------
20 stack of layers array_of_action_code[row][column]
21 ____________ precedence _______________________
22 / / | high / ESC / F1 / F2 / F3 ....
23 31 /___________// | /-----/-----/-----/-----
24 30 /___________// | / TAB / Q / W / E ....
25 29 /___________/ | /-----/-----/-----/-----
26 : _:_:_:_:_:__ | : /LCtrl/ A / S / D ....
27 : / : : : : : / | : / : : : :
28 2 /___________// | 2 `--------------------------
29 1 /___________// | 1 `--------------------------
30 0 /___________/ V low 0 `--------------------------
31
32
33TMK の歴史的経緯から、キーマップに保存されたアクションコードは、一部のドキュメントではキーコードと呼ばれる場合があります。
34
35### キーマップレイヤーステータス :id=keymap-layer-status
36
37キーマップレイヤーの状態は、2つの32ビットパラメータによって決定されます。
38
39* **`default_layer_state`** は、常に有効で参照される基本キーマップレイヤー (0-31) を示します (デフォルトレイヤー)。
40* **`layer_state`** は現在の各レイヤーのオン/オフの状態をビットで持ちます。
41
42キーマップレイヤー '0' は通常 `default_layer` で、他のレイヤーはファームウェアの起動後に最初はオフになっていますが、これは `config.h` で異なる設定にすることが可能です。例えば Qwerty ではなく Colemak に切り替えるなど、キーレイアウトを完全に切り替える場合、`default_layer` を変更すると便利です。
43
44 Initial state of Keymap Change base layout
45 ----------------------- ------------------
46
47 31 31
48 30 30
49 29 29
50 : :
51 : : ____________
52 2 ____________ 2 / /
53 1 / / ,->1 /___________/
54 ,->0 /___________/ | 0
55 | |
56 `--- default_layer = 0 `--- default_layer = 1
57 layer_state = 0x00000001 layer_state = 0x00000002
58
59一方、`layer_state` を変更して、基本レイヤーをナビゲーションキー、ファンクションキー (F1-F12)、メディアキー、特別なアクションなどの機能を持つ他のレイヤーでオーバーレイすることができます。
60
61 Overlay feature layer
62 --------------------- bit|status
63 ____________ ---+------
64 31 / / 31 | 0
65 30 /___________// -----> 30 | 1
66 29 /___________/ -----> 29 | 1
67 : : | :
68 : ____________ : | :
69 2 / / 2 | 0
70 ,->1 /___________/ -----> 1 | 1
71 | 0 0 | 0
72 | +
73 `--- default_layer = 1 |
74 layer_state = 0x60000002 <-'
75
76
77
78### レイヤーの優先順位と透過性
79***上位のレイヤーはレイヤーのスタックでより高い優先順位を持つ***ことに注意してください。ファームウェアは最上位のアクティブレイヤーから下に向かってキーコードを検索します。ファームウェアがアクティブなレイヤーで `KC_TRNS` (透過)以外のキーコードを見つけると、検索を停止し、下位レイヤーは参照されません。
80
81 ____________
82 / / <--- Higher layer
83 / KC_TRNS //
84 /___________// <--- Lower layer (KC_A)
85 /___________/
86
87 上記シナリオでは、上位レイヤーに非透過のキーが定義されているとそのキーが使われますが、`KC_TRNS` (または同等のキーコード)が定義されている場合は常に下位レベルのキーコード(`KC_A`)が使われます。
88
89**メモ:** 特定のレイヤーの透過性を示す有効な方法:
90* `KC_TRANSPARENT`
91* `KC_TRNS` (別名)
92* `_______` (別名)
93
94これらのキーコードは、処理する非透過のキーコードを探すときに、下位レイヤーを検索させることができます。
95
96## `keymap.c` の分析
97
98この例では、[デフォルトの Clueboard 66% キーマップの古いバージョン](https://github.com/qmk/qmk_firmware/blob/ca01d94005f67ec4fa9528353481faa622d949ae/keyboards/clueboard/keymaps/default/keymap.c)を見ていきます。そのファイルを別のブラウザウィンドウで開くとコンテキスト内のすべてを見ることができるので便利です。
99
100`keymap.c` ファイルには、あなたが関心があるであろう以下の2つの主要なセクションがあります:
101
102* [定義](#definitions)
103* [レイヤー/キーマップデータ構造](#layers-and-keymaps)
104
105### 定義 :id=definitions
106
107ファイルの上部に以下のものがあります:
108
109 #include QMK_KEYBOARD_H
110
111 // 便利な定義
112 #define GRAVE_MODS (MOD_BIT(KC_LSHIFT)|MOD_BIT(KC_RSHIFT)|MOD_BIT(KC_LGUI)|MOD_BIT(KC_RGUI)|MOD_BIT(KC_LALT)|MOD_BIT(KC_RALT))
113
114 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
115 * KC_TRNS (透過) の代わりに _______ を使うことができます *
116 * あるいは、KC_NO (NOOP) として XXXXXXX を使うことができます *
117 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
118
119 // 各レイヤーは読みやすいように名前を持ちます。
120 // アンダースコアは何も意味を持ちません
121 // STUFF あるいは他の名前のレイヤーを持つことができます。
122 // レイヤー名は全て同じ長さである必要はなく、
123 // また名前を完全に省略して単に数字を使うことができます。
124 #define _BL 0
125 #define _FL 1
126 #define _CL 2
127
128これらはキーマップとカスタム関数を作成するときに使うことができる便利な定義です。`GRAVE_MODS` 定義は後でカスタム関数で使われ、その下の `_BL`、`_FL`、`_CL` 定義は各レイヤーを参照しやすくします。
129
130注意: 古いキーマップファイルに `_______` および `XXXXXXX` の定義が含まれているかもしれません。これらはそれぞれ `KC_TRNS` および `KC_NO` の代わりに使うことができ、レイヤーがどのキーを上書きしているかを簡単に確認することができます。これらの定義はデフォルトで含まれるため、今では不要になりました。
131
132### レイヤーとキーマップ :id=layers-and-keymaps
133
134このファイルの主要部分は `keymaps[]` 定義です。ここで、レイヤーとそれらの内容を列挙します。ファイルのこの部分は、以下の定義から始まります:
135
136 const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
137
138この後で、LAYOUT() マクロのリストがあります。LAYOUT() は単一のレイヤーを定義するためのキーのリストです。通常、1つ以上の"基本レイヤー" (QWERTY、Dvorak、Colemak など)があり、その上に1つ以上の"機能"レイヤーを重ねます。レイヤーの処理方法により、"より上位"のレイヤーの上に"より下位"のレイヤーを重ねることはできません。
139
140QMK の `keymaps[][MATRIX_ROWS][MATRIX_COLS]` は、16ビットのアクションコード( quantum キーコードとも呼ばれる)を保持します。一般的なキーを表すキーコードの場合、その上位バイトは0で、その下位バイトはキーボードの USB HID usage ID です。
141
142> QMK のフォーク元の TMK は、代わりに `const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS]` を使い、8ビットキーコードを保持します。一部のキーコード値は、`fn_actions[]` 配列を介して特定のアクションコードの実行を引き起こすために予約されています。
143
144#### 基本レイヤー
145
146Clueboard の基本レイヤーの例です:
147
148 /* Keymap _BL: Base Layer (Default Layer)
149 */
150 [_BL] = LAYOUT(
151 F(0), KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_GRV, KC_BSPC, KC_PGUP, \
152 KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS, KC_PGDN, \
153 KC_CAPS, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_NUHS, KC_ENT, \
154 KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RO, KC_RSFT, KC_UP, \
155 KC_LCTL, KC_LGUI, KC_LALT, KC_MHEN, KC_SPC,KC_SPC, KC_HENK, KC_RALT, KC_RCTL, MO(_FL), KC_LEFT, KC_DOWN, KC_RGHT),
156
157これについて注意すべきいくつかの興味深いこと:
158
159* C ソースの観点からは、これは単一の配列に過ぎませんが、物理デバイス上の各キーがどこにあるかをより簡単に可視化するために、空白が埋め込まれています。
160* 単純なキーボードスキャンコードの先頭には KC_ が付いていますが、"特別な"キーには付いていません。
161* 左上のキーはカスタム機能 0 (`F(0)`) をアクティブにします。
162* "Fn" キーは `MO(_FL)` で定義され、そのキーが押されている間は `_FL` レイヤーに移動します。
163
164#### 機能オーバーレイレイヤー
165
166機能レイヤーはコードの観点から基本レイヤーと違いはありません。ただし概念的には、置き換えの代わりにオーバーレイとしてそのレイヤーを構築します。多くの人にとってはこの区別は重要ではありませんが、より複雑なレイヤー設定を構築するにつれて、ますます重要になります。
167
168 [_FL] = LAYOUT(
169 KC_GRV, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, KC_DEL, BL_STEP, \
170 _______, _______, _______,_______,_______,_______,_______,_______,KC_PSCR,KC_SLCK, KC_PAUS, _______, _______, _______, _______, \
171 _______, _______, MO(_CL),_______,_______,_______,_______,_______,_______,_______, _______, _______, _______, _______, \
172 _______, _______, _______,_______,_______,_______,_______,_______,_______,_______, _______, _______, _______, _______, KC_PGUP, \
173 _______, _______, _______, _______, _______,_______, _______, _______, _______, MO(_FL), KC_HOME, KC_PGDN, KC_END),
174
175注意すべきいくつかの興味深いこと:
176
177* `_______` 定義を使って、`KC_TRNS` を `_______` に変換しました。これによりこのレイヤーで変更されたキーを簡単に見つけることができます。
178* このレイヤーで `_______` キーのいずれかを押すと、次の下位のアクティブなレイヤーのキーがアクティブになります。
179
180# 核心となる詳細
181
182これで独自のキーマップを作成するための基本的な概要が得られました。詳細は以下のリソースを見てください:
183
184* [キーコード](ja/keycodes.md)
185* [キーマップ FAQ](ja/faq_keymap.md)
186
187これらのドキュメントの改善に積極的に取り組んでいます。それらを改善する方法について提案がある場合は、[issue を報告](https://github.com/qmk/qmk_firmware/issues/new)してください！
generated by cgit v1.2.3 (git 2.25.1) at 2025-08-29 08:43:30 +0100