Джойстик

в палитре на схеме

Описание

Блок позволяет получать данные с подключенного к системе джойстика.

Джойстик должен быть подключен через USB и доступен в списке игровых устройств Windows. Перед запуском модели SimInTech происходит поиск USB-джойстика с заданным именем среди подключенных к компьютеру устройств ввода. Если такой джойстик обнаружен, он активируется, и его настройки устанавливаются в соответствии со свойствами блока.

Для выбора устройства необходимо дважды кликнуть мышью по значку блока Рис. 1.
Прим.:
окно выбора устройства позволяет получить список имен подключенных устройств типа "джойстик"; инициировать устройство с заданным именем; получить список объектов устройства типа "ось"; получить строки имен и смещений объектов устройства типа "ось", "POV", "кнопка"; получить данные о состоянии объектов устройства; освободить устройство.


Рис. 1. Окно выбора устройства

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

Количество выходных портов блока определяется из свойств блока и равно сумме количества осей "AXISsNumber", количества переключателей POV "POVsNumber" + 1 векторный порт для кнопок джойстика (количество элементов вектора равно числу кнопок джойстика "ButtonsNumber").

Порядок расположения портов сверху вниз соответствует описанию выше: сначала идут порты для осей и движков, затем переключатели вида, и порт для кнопок. Сигналы на портах имеют вещественный тип и изменяются следующим образом:
  • на портах, соответствующих осям и движкам, значения непрерывно изменяются в заданных диапазонах, указанных в свойствах блока "Оси и движки мин. значение" и "Оси и движки макс. значение";
  • на портах, соответствующих переключателям вида, значения изменяются дискретно и условно соответствуют выбранным направления движения (градусам) (Рис. 2):


    Рис. 2. Переключатель вида
    Табл. 1. Соответствие направления переключателя вида и сигнала на его порту
    Направление Сигнал на порту
    вперед 0
    вперед-вправо 4500
    вправо 9000
    назад-вправо 13500
    назад 18000
    назад-влево 22500
    влево 27000
    влево-вперед 31500
  • на порту, соответствующему значению кнопок, имеется векторный сигнал размерностью равной количеству кнопок (в свойствах блока), каждый элемент которого соответствует состоянию кнопки (1 - нажата, 0 - не нажата).

Видеоурок по настройке блока доступен по ссылке.

Входные порты

Блок не имеет входных портов.

Выходные порты

Количество выходов блока зависит от конфигурации свойств блока.

Свойства

Название Имя Описание По умолчанию Тип данных
Наименование устройства joyname Имя текущего устройства VKB KingCobra MkII(Pro) #049 Строка
Тип данных (для генерации кода) src_type Тип данных вещественного числа double Перечисление
Название txt Название текущего устройства Microsoft SideWinder Precision Pro (USB) игровой планшет Строка
Использовать эксклюзивно Exclusive Приложение обладает эксклюзивным доступом к устройству, что означает, что другие приложения не имеют доступа к данным устройства. Однако, если это свойство установлено в значении "Нет", то другие приложения также имеют возможность получить доступ к устройству и установить свой эксклюзивный статус. Из-за чего возможно отключение SimInTech от устройства Да Двоичное
Использовать при активности Foreground Приложение получает доступ к устройству только в том случае, когда его окно активно. Если это свойство установлено в значении "Да", то данные с устройства не будут поступать, если окно приложения не активно Нет Двоичное
Оси и движки значение мин. PropMin Значение, соответствующее минимальному положению оси или движка -10000 Строка
Оси и движки значение макс. PropMax Значение, соответствующее максимальному положению оси или движка 10000 Строка
Количество осей и движков AXISsNumber Суммарное количество аналоговых осей и движков выбранного джойстика (например вверх-вниз, влево-вправо, газ и руль направления образуют 4 оси). Значение свойства заполняется автоматически при выборе джойстика. Максимальное значение "32" 4 Целое
Количество POV POVsNumber Количество переключателей вида (хаток или точек обзора). Значение свойства заполняется автоматически при выборе джойстика 4 Целое
Количество кнопок ButtonsNumber Количество кнопок выбранного джойстика. Значение свойства заполняется автоматически при выборе джойстика 32 Целое
Наименование осей и движков AXISsName Названия осей и движков джойстика. Значение свойства заполняется автоматически при выборе джойстика "Ось X","Ось Y","Ось Z","Вращение вокруг оси X" Строка

Параметры

Блок не имеет параметров.

Примеры

Блок не имеет примеров.