Описание подсистемы ввода

Подсистема ввода отвечает засчитывание ввода пользователя со всевозможных устройств (клавиатура, мышь, джойстик и пр.) и формирование на их основе событий ввода, которые затем передаются различным модулям. Подсистема предоставляет полную абстракцию от устройств ввода: в модули-обработчики передаются уже готовые события, связанные с конкретными действиями.

Схема обработки ввода пользователя

Обработка пользовательского ввода состоит из следующих этапов.

1. Устройство ввода (клавиатура, мышь и пр.) фиксирует действие пользователя (нажатие кнопки, движение мышью и т.д.) и передает сообщение об этом в движок ввода. В таком сообщении содержится тип события и всевозможные параметры. Например, когда пользователь нажимает кнопку на клавиатуре, передается событие key_press с двумя параметрами - идентификатор нажатой кнопки и unicode-символ, который ей соответствует. Когда пользователь отпускает кнопку, передается событие key_release с теми же параметрами.

2. Движок ввода передает это событие всем активным контекстам ввода.

Контекст ввода - это таблица преобразования низкоуровневых событий в пользовательские. Контекст ввода определяет правила, по которым события будут передаваться пользователю. Таких контекстов может быть несколько: например, для управления аватаром используется один контекст, а для работы с GUI - другой.

Каждый из контекстов ввода обрабатывает низкоуровневые события независимо. Делает он это при помощи таблицы обработки событий. В этой таблице, каждому низкоуровневому событию, удовлетворяющему определенным критериям, или же последовательности таких событий, соответствует вызов одного или нескольких обработчиков ввода.

В качестве критерия могут использоваться различные условия на параметры события. Например, в качестве условия может выступать:

• нажатие любой клавиши (никакого критерия нет);
• нажатие любой клавиши при нажатой клавише shift (критерий модификатора);
• нажатие любой клавиши при отпущенной клавише ctrl (критерий модификатора);
• нажатие клавиши A (критерий параметра события);
• нажатие клавиши A при нажатой левой клавиши мыши (смешанный критерий).
• и т.д.

3. Контекст ввода передает результат обработки события обработчикам ввода. Обработчик - это небольшой модуль, который выполняет с полученным событием какие-либо действия и отправляет результат пользователю.

Конфигурация ввода

Файл конфигурации движка ввода находится по адресу /etc/world/input.conf в DISS.

Формат этого файла следующий.

Пустые строки и строки, начинающиеся с #, игнорируются.

В начале файла перечислены устройства ввода, которые необходимо подключить. Устройство подключается директивой device, за которой следует URL устройства - его тип и, возможно, какие-то параметры после двоеточия. У стандартных устройств никаких параметров нет. Так, клавиатура и мышь подключается директивами

device keyboard
device mouse

Далее идут описания контекстов.

Описание контекста начинается с директивы context, параметр которой - имя контекста. После этой директивы идет заполнение таблицы ввода директивой on.

Рассмотрим пример привязки нажатия клавиши A к отправке события объекту:

device keyboard
device mouse

context local_control

on key_press check(key=A) do send_event:power_on

Контекст local_control - используется для управления объектом на локальной сцене, т.е. для тестирования.

Директива on создает в этом контексте обработчик события key_press (нажатие на клавишу клавиатуры) с критерием нажатия клавиши A. После ключевого слова do следуют URL-ы обработчиков этого события - в данном случае, это обработчик send_event, который отправит событие power_on объекту, которым управляет пользователь.