<meta charset="UTF-8">

<link href="style.css" rel="stylesheet" type="text/css">

<title>Клавиатура и мышь - Helianthus</title>

  
Helianthus

  
Запуск и общие функции

  
Клавиатура и мышь

  
Рисование

  
Спрайты

  
Группы спрайтов

  
Камера

  
Звук

  
Все функции

Клавиатура и мышь

Во время работы программы вы можете узнавать положение мыши и состояние клавиш. Координаты указателя мыши можно получить функциями mouseX и mouseY. Узнать состояние клавиш клавиатуры и кнопок мыши можно функциями keyDown и mouseDown соответственно.

Для указания клавиши нужно написать её текстовое наименование, например: "a", "1", "left", "right", "up", "down", "return" (для Enter), "escape" и и.д.

Названия клавиш взяты из библиотеки GTK, их полный список вы можете посмотреть в файле (для Linux), список очень большой:

    file:///usr/include/gtk-3.0/gdk/gdkkeysyms.h

или в интернете:

    https://gitlab.gnome.org/GNOME/gtk/-/blob/master/gdk/gdkkeysyms.h

Обратите внимание, что наименование нужно писать маленькими (строчными) буквами и приставку GTK_KEY_ нужно убрать. Например, если вы нашли в большом списке клавишу GDK_KEY_BackSpace — значит в вашей программе вам нужно написать "backspace".

Наименований для кнопок мыши всего три: "left", "middle" и "right".

Кроме этого существуют функции для определения момента нажатия и отпускания клавиш и кнопок. На тот случай когда некоторые действия нужно выполнить только один раз в момент нажатия (или отпускания) клавиши. Смотрите функции keyWentDown, keyWentUp, mouseWentDown, mouseWentUp.

Также вы можете получить полный список нажатых, отпущенных или удерживаемых клавиш и кнопок при помощи функций keyEventGetCount и keyEventGet.

Например, если вы не знаете наименования какой-либо клавиши, вы можете выводить имена нажимаемых клавиш в терминал при помощи такой программы:

void draw() {

    …

    int count = keyEventCount(KEYEVENT_KEY_WENTDOWN);

    for(int i = 0; i < count; ++i) {

        printf( "pressed key: %s",

            keyEventGet(KEYEVENT_KEY_WENTDOWN, i) );

    }

    …

}

Функции:

int keyDown(const char *code);

Функция возвращает TRUE (число 1) если указанная клавиша в нажата (и удерживается) в данный момент и FALSE (число 0) если клавиша отпущена.

Параметры:

code — текстовое наименование клавиши.

int keyWentDown(const char *code);

Функция возвращает TRUE (число 1) если указанная клавиша стала нажатой в момент времени между предыдущим и текущим кадром. В последующих кадрах, даже если клавиша остаётся нажатой, функция возвращает FALSE (число 0).

Важно: Примерно через секунду после нажатия и удержания клавиши, keyWentDown всё таки сработает ещё раз — так будто клавиша была повторно нажата. Другими словами поведение функции такое же как и у текстового редактора: если удерживать клавишу некоторое время редактор повторяет печать символа несколько раз.

Параметры:

code — текстовое наименование клавиши.

int keyWentUp(const char *code);

Функция возвращает TRUE (число 1) если указанная клавиша перестала быть нажатой в момент времени между предыдущим и текущим кадром. Во всех других случаях возвращает FALSE (число 0).

Параметры:

code — текстовое наименование клавиши.

int mouseDown(const char *code);

Функция возвращает TRUE (число 1) если указанная кнопка мыши в нажата (и удерживается) в данный момент и FALSE (число 0) если кнопка отпущена.

Параметры:

code — текстовое наименование кнопки мыши.

int mouseWentDown(const char *code);

Функция возвращает TRUE (число 1) если указанная кнопка мыши стала нажатой в момент времени между предыдущим и текущим кадром. Во всех последующих кадрах, даже если кнопка остаётся нажатой, функция возвращает FALSE (число 0).

Параметры:

code — текстовое наименование кнопки мыши.

int mouseWentUp(const char *code);

Функция возвращает TRUE (число 1) если указанная кнопка мыши перестала быть нажатой в момент времени между предыдущим и текущим кадром. Во всех других случаях возвращает FALSE (число 0).

Параметры:

code — текстовое наименование кнопки мыши.

int mouseDidMove();

Функция возвращает TRUE (число 1) если с момента отрисовки предыдущего кадра положение мыши изменилось, и возвращает FALSE (число 0) ели мышь оставалась неподвижной.

double mouseX();

Возвращает координату X указателя мыши.

double mouseY();

Возвращает координату Y указателя мыши.

int keyEventGetCount(KeyEvent mode);

Возвращает количество зарегистрированных на данном кадре клавиш (или кнопок мыши), соответствующих одному из перечисленных ниже типу событий:

    Тип

    Описание

    KEYEVENT_KEY_DOWN

    удерживаемые в данный момент клавиши, см. keyDown

    KEYEVENT_KEY_WENTDOWN

    клавиши, которые только что стали нажатыми, см. keyWentDown

    KEYEVENT_KEY_WENTUP

    клавиши, которые были только что отпущены, см. keyWentUp

    KEYEVENT_MOUSE_DOWN

    кнопки мыши, которые в данный момент нажаты, см. mouseDown

    KEYEVENT_MOUSE_WENTDOWN

    кнопки мыши, которые только что стали нажатыми, см. mouseWentDown

    KEYEVENT_MOUSE_WENTUP

    кнопки мыши, которые были только что отпущены, см. mouseWentUp

Параметры:

mode — тип событий, см. выше.

const char* keyEventGet(KeyEvent mode, int i);

Возвращает наименования клавиши или кнопки мыши из списка событий указанного типа, по указанному номеру. Элементы в списке событий отсортированы по времени возникновения события. То есть клавиши идут в том порядке в котором они были нажаты (или отпущены). См. также keyEventGetCount.

Параметры:

mode — тип событий, список типов смотрите в описании функции keyEventGetCount;

i — порядковой номер клавиши или кнопки в списке для указанного типа, элементы