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.md174
1 files changed, 174 insertions, 0 deletions
diff --git a/docs/ja/keymap.md b/docs/ja/keymap.md
new file mode 100644
index 000000000..29eb1adc0
--- /dev/null
+++ b/docs/ja/keymap.md
@@ -0,0 +1,174 @@
1# キーマップの概要
2
3<!---
4 original document: 7494490d6:docs/keymap.md
5 git diff 7494490d6 HEAD -- docs/keymap.md | cat
6-->
7
8QMK のキーマップは C のソースファイルの中で定義されます。そのデータ構造は配列の配列です。外側はレイヤーを要素とする配列で、レイヤーはキーを要素とする配列。ほとんどのキーボードは `LAYOUT()` マクロを定義して、この配列の配列を作成しやすくしています。
9
10
11## キーマップとレイヤー
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### キーマップレイヤーステータス
36キーマップレイヤーの状態は、2つの32ビットパラメータによって決定されます。
37
38* **`default_layer_state`** は、常に有効で参照される基本キーマップレイヤー (0-31) を示します (デフォルトレイヤー)。
39* **`layer_state`** は現在の各レイヤーのオン/オフの状態をビットで持ちます。
40
41キーマップレイヤー '0' は通常 `default_layer` で、他のレイヤーはファームウェアの起動後に最初はオフになっていますが、これは `config.h` で異なる設定にすることが可能です。例えば Qwerty ではなく Colemak に切り替えるなど、キーレイアウトを完全に切り替える場合、`default_layer` を変更すると便利です。
42
43 Initial state of Keymap Change base layout
44 ----------------------- ------------------
45
46 31 31
47 30 30
48 29 29
49 : :
50 : : ____________
51 2 ____________ 2 / /
52 1 / / ,->1 /___________/
53 ,->0 /___________/ | 0
54 | |
55 `--- default_layer = 0 `--- default_layer = 1
56 layer_state = 0x00000001 layer_state = 0x00000002
57
58一方、`layer_state` を変更して、基本レイヤーをナビゲーションキー、ファンクションキー (F1-F12)、メディアキー、特別なアクションなどの機能を持つ他のレイヤーでオーバーレイすることができます。
59
60 Overlay feature layer
61 --------------------- bit|status
62 ____________ ---+------
63 31 / / 31 | 0
64 30 /___________// -----> 30 | 1
65 29 /___________/ -----> 29 | 1
66 : : | :
67 : ____________ : | :
68 2 / / 2 | 0
69 ,->1 /___________/ -----> 1 | 1
70 | 0 0 | 0
71 | +
72 `--- default_layer = 1 |
73 layer_state = 0x60000002 <-'
74
75
76
77### レイヤーの優先順位と透過性
78***上位のレイヤーはレイヤーのスタックでより高い優先順位を持つ***ことに注意してください。つまり、ファームウェアはキーコードを最上位から最下位まで検索します。レイヤーで **`KC_TRNS`**(透過)以外のキーコードを見つけると、検索を中止し、下位レイヤーは参照されません。
79
80オーバーレイレイヤーに `KC_TRANS` を配置して、レイアウトの一部だけを変更して下位レイヤーまたは基本レイヤーにフォールバックすることができます。
81`KC_TRANS` (`KC_TRNS` と `_______` はエイリアス) のキーには独自のキーコードがなく、キーコードの有効な下位レイヤーを参照します。
82
83## `keymap.c` の分析
84
85この例では、[デフォルトの Clueboard 66% キーマップの古いバージョン](https://github.com/qmk/qmk_firmware/blob/ca01d94005f67ec4fa9528353481faa622d949ae/keyboards/clueboard/keymaps/default/keymap.c)を見ていきます。そのファイルを別のブラウザウィンドウで開くとコンテキスト内のすべてを見ることができるので便利です。
86
87`keymap.c` ファイルには、あなたが関心があるであろう以下の2つの主要なセクションがあります:
88
89* [定義](#definitions)
90* [レイヤー/キーマップデータ構造](#layers-and-keymaps)
91
92### 定義 :id=definitions
93
94ファイルの上部に以下のものがあります:
95
96 #include QMK_KEYBOARD_H
97
98 // 便利な定義
99 #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))
100
101 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
102 * KC_TRNS (透過) の代わりに _______ を使うことができます *
103 * あるいは、KC_NO (NOOP) として XXXXXXX を使うことができます *
104 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
105
106 // 各レイヤーは読みやすいように名前を持ちます。
107 // アンダースコアは何も意味を持ちません
108 // STUFF あるいは他の名前のレイヤーを持つことができます。
109 // レイヤー名は全て同じ長さである必要はなく、
110 // また名前を完全に省略して単に数字を使うことができます。
111 #define _BL 0
112 #define _FL 1
113 #define _CL 2
114
115これらはキーマップとカスタム関数を作成するときに使うことができる便利な定義です。`GRAVE_MODS` 定義は後でカスタム関数で使われ、その下の `_BL`、`_FL`、`_CL` 定義は各レイヤーを参照しやすくします。
116
117注意: 古いキーマップファイルに `_______` および `XXXXXXX` の定義が含まれているかもしれません。これらはそれぞれ `KC_TRNS` および `KC_NO` の代わりに使うことができ、レイヤーがどのキーを上書きしているかを簡単に確認することができます。これらの定義はデフォルトで含まれるため、今では不要になりました。
118
119### レイヤーとキーマップ :id=layers-and-keymaps
120
121このファイルの主要部分は `keymaps[]` 定義です。ここで、レイヤーとそれらの内容を列挙します。ファイルのこの部分は、以下の定義から始まります:
122
123 const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
124
125この後で、LAYOUT() マクロのリストがあります。LAYOUT() は単一のレイヤーを定義するためのキーのリストです。通常、1つ以上の"基本レイヤー" (QWERTY、Dvorak、Colemak など)があり、その上に1つ以上の"機能"レイヤーを重ねます。レイヤーの処理方法により、"より上位"のレイヤーの上に"より下位"のレイヤーを重ねることはできません。
126
127QMK の `keymaps[][MATRIX_ROWS][MATRIX_COLS]` は、16ビットのアクションコード( quantum キーコードとも呼ばれる)を保持します。一般的なキーを表すキーコードの場合、その上位バイトは0で、その下位バイトはキーボードの USB HID usage ID です。
128
129> QMK のフォーク元の TMK は、代わりに `const uint8_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS]` を使い、8ビットキーコードを保持します。一部のキーコード値は、`fn_actions[]` 配列を介して特定のアクションコードの実行を引き起こすために予約されています。
130
131#### 基本レイヤー
132
133Clueboard の基本レイヤーの例です:
134
135 /* Keymap _BL: Base Layer (Default Layer)
136 */
137 [_BL] = LAYOUT(
138 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, \
139 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, \
140 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, \
141 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, \
142 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),
143
144これについて注意すべきいくつかの興味深いこと:
145
146* C ソースの観点からは、これは単一の配列に過ぎませんが、物理デバイス上の各キーがどこにあるかをより簡単に可視化するために、空白が埋め込まれています。
147* 単純なキーボードスキャンコードの先頭には KC_ が付いていますが、"特別な"キーには付いていません。
148* 左上のキーはカスタム機能 0 (`F(0)`) をアクティブにします。
149* "Fn" キーは `MO(_FL)` で定義され、そのキーが押されている間は `_FL` レイヤーに移動します。
150
151#### 機能オーバーレイレイヤー
152
153機能レイヤーはコードの観点から基本レイヤーと違いはありません。ただし概念的には、置き換えの代わりにオーバーレイとしてそのレイヤーを構築します。多くの人にとってはこの区別は重要ではありませんが、より複雑なレイヤー設定を構築するにつれて、ますます重要になります。
154
155 [_FL] = LAYOUT(
156 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, \
157 _______, _______, _______,_______,_______,_______,_______,_______,KC_PSCR,KC_SLCK, KC_PAUS, _______, _______, _______, _______, \
158 _______, _______, MO(_CL),_______,_______,_______,_______,_______,_______,_______, _______, _______, _______, _______, \
159 _______, _______, _______,_______,_______,_______,_______,_______,_______,_______, _______, _______, _______, _______, KC_PGUP, \
160 _______, _______, _______, _______, _______,_______, _______, _______, _______, MO(_FL), KC_HOME, KC_PGDN, KC_END),
161
162注意すべきいくつかの興味深いこと:
163
164* `_______` 定義を使って、`KC_TRNS` を `_______` に変換しました。これによりこのレイヤーで変更されたキーを簡単に見つけることができます。
165* このレイヤーで `_______` キーのいずれかを押すと、次の下位のアクティブなレイヤーのキーがアクティブになります。
166
167# 核心となる詳細
168
169これで独自のキーマップを作成するための基本的な概要が得られました。詳細は以下のリソースを見てください:
170
171* [キーコード](ja/keycodes.md)
172* [キーマップ FAQ](ja/faq_keymap.md)
173
174これらのドキュメントの改善に積極的に取り組んでいます。それらを改善する方法について提案がある場合は、[issue を報告](https://github.com/qmk/qmk_firmware/issues/new)してください！
generated by cgit v1.2.3 (git 2.25.1) at 2025-12-03 14:55:48 +0000