====== Инструменты для работы с таблицей матрицы клавиатуры MSX ======

**Общая информация описана в [[msx:russification:russification#matrix|этом разделе]]**

====== Скрипты ======
Скрипты работают в [[python:python|]] 2 и 3.
===== table-to-text.py =====

{{:msx:russification:keyboard:table-to-text.py|}}

Чтение файла [[msx:bios|]] и сохранение таблицы матрицы клавиатуры в файл.

Параметры:
  - Исходный файл
  - Файл для сохранения таблицы
  - Для файла [[msx:msx_2_plus|]], укажите ''2+''

Пример запуска: 
<code python>
./table-to-text.py file.bin table.txt [2+]
</code>

Каждая строка выходного файла ''table.txt'' содержит № клавиши и коды закреплённые за ней в различных режимах:
^Режим^Описание^
|1|без модификаторов|
|2|с нажатой клавишей <key>SHIFT</key>|
|3|с нажатой клавишей <key>GRAPH</key>|
|4|с нажатыми клавишами <key>GRAPH+SHIFT</key>|
|5|с нажатой клавишей <key>РУС</key>|
|6|с нажатыми клавишами <key>РУС+SHIFT</key>|

Формат:
^№ Клавиши^Код символа в режиме 1^Код символа в режиме 2^Код символа в режиме 3^Код символа в режиме 4^Код символа в режиме 5^Код символа в режиме 6^
|0x00|30|29|09|0A|29|30|
|…|…|…|…|…|…|…|
|0x57|2E|

Для таблицы, часть 1 для каждой из 48 клавиш выводятся коды для каждого из 6 режимов, а для таблицы, часть 2 для её 16 клавиш по одному коду.

===== text-to-table.py =====

{{:msx:russification:keyboard:text-to-table.py|}}

Вывод значений таблицы из тестового файла в тестовую программу на [[msx:basic:]] и в готовые файлы таблиц.

Параметры:
  - Исходный файл
  - Имя файл (без расширения)
  - Для файла MSX 2+ укажите 2+

Пример запуска:
<code python>
./text-to-table.py table.txt table [2+]
</code>

В результате для файла ''table.txt'' будут сформированы следующие файлы:
  * ''table.bas'' — тестовая программа на [[msx:basic:]]
  * ''table_0DA5-288.bin'' — файл с первой частью таблицей
  * ''table_1033-40.bin'' — файл с второй частью таблицей

Для изменения исходного файла используйте команды:
  * <code python>../tools/fragment-to-binary-file.py file.bin table_0DA5-288.bin 0DA5 288</code>
  * <code python>../tools/fragment-to-binary-file.py file.bin table_1033-40.bin 1033 40</code>

====== Таблицы ======

===== USSR =====
Оригинальная таблица компьютеров стандарта [[msx:yamaha_kuvt:yamaha_kuvt#kuvt2|Ямаха КУВТ 2]] которые поставлялись в СССР.

Примеры таблиц, сформированные программой на [[msx:basic:]] для {{:msx:russification:keyboard:ussr.txt|}}:

  * **Таблица, часть 1**  <WRAP>На экране в две колонки отображаются значения всех 48 символьных клавиш клавиатуры, они нумеруются по порядку их описания в матрице клавиатуры (для экономии места на экране префикс 0x отсутствует). Для каждой клавиши указаны символы которые отображаются при её нажатии в каждом из 6 режимов.

{{:msx:russification:keyboard:ussr_1.png|}}
</WRAP>

  * **Таблица, часть 2** <WRAP>На экране в две колонки отображаются значения клавиш, номер клавиши с префикса 0x

{{:msx:russification:keyboard:ussr_2.png|}}
</WRAP>

Файлы:
  * {{:msx:russification:keyboard:ussr-msx2.txt|}}
  * {{:msx:russification:keyboard:ussr-msx2.bin|}}
  * {{:msx:russification:keyboard:ussr-msx2_1033-40.bin|}}
  * {{:msx:russification:keyboard:ussr-msx2_da5-288.bin|}}

===== JCUKEN =====
Исправленная таблица.

Цифры, точка и запятая нажимаются в нижнем регистре — без <key>SHIFT</key>.

За основу взята таблица [[#USSR]], и в ней изменены значения для 12–ти клавиш с следующими номерами:
  * 0x00
  * 0x02
  * 0x03
  * 0x04
  * 0x05
  * 0x06
  * 0x07
  * 0x08
  * 0x09
  * 0x0A
  * 0x11
  * 0x14

Рекомендована для использования на "железных" компьютерах.

{{:msx:russification:keyboard:jcuken.txt|}}

Таблица, часть 1:
\\ {{:msx:russification:keyboard:jcuken_1.png|}}
\\ {{:msx:russification:keyboard:jcuken_da5-288.bin|}}
===== QWERTY =====

Исправленная латиница с [[#JCUKEN]] на QWERTY. Изменения сделаны для использования с текущей версией [[webmsx:webmsx|]].

{{:msx:russification:keyboard:qwerty.txt|}}

Таблица, часть 1:
\\ {{:msx:russification:keyboard:qwerty_1.png|}}

Таблица, часть 2:
\\ {{:msx:russification:keyboard:qwerty_2.png|}}

===== International =====

Оригинальная интернациональная таблица.

{{:msx:russification:keyboard:international.txt|}}

Таблица, часть 1:
\\ {{:msx:russification:keyboard:international_1.png|}}

Таблица, часть 2:
\\ {{:msx:russification:keyboard:international_2.png|}}


===== openMSX =====

Изменения сделаны для использования с текущей версией [[openmsx:openmsx|]].

Файлы:
  * {{:msx:russification:keyboard:openmsx-msx2.txt |}}
  * {{:msx:russification:keyboard:openmsx-msx2_1033-40.bin|}}
  * {{:msx:russification:keyboard:openmsx-msx2_da5-288.bin|}}


{{tag>MSX Russification Python}}