Документация QSP

СайтФорум

Это старая версия документа.

---

Переменные, задающие обработчики событий

Top Previous Next

$COUNTER - содержит название локации-счётчика. Локация-счётчик полезна для проверки выделенных предметов, введённого текста…

SETTIMER [#выражение] - задает интервал таймера для локации-счётчика (по умолчанию 500мс, т.е. локация-счётчик обрабатывается 2 раза в секунду). Также влияет на частоту автоматического обновления интерфейса.

$ONGLOAD - содержит название локации-обработчика загрузки состояния. Данная локация полезна для выполнения каких-либо действий после загрузки состояния игры.

$ONGSAVE - содержит название локации-обработчика сохранения состояния. Данная локация полезна для выполнения каких-либо действий перед сохранением состояния игры.

$ONNEWLOC - содержит название локации-обработчика перехода на новую локацию (аналог локации "common" в URQ). Может заменить часть функций локации-счётчика. Получить название локации, на которую был осуществлён переход, можно с помощью функции "CURLOC". ??(при серии "GOTO / XGOTO" - переходов, событие возникает только один раз для последней локации переходов).??

$ONACTSEL - содержит название локации-обработчика выбора действия. Данная локация полезна, к примеру, для вывода изображений или проигрывания звуков при выборе действий. Получить название выбранного действия можно через функцию"SELACT".

SELACT - возвращает название выделенного действия.

$ONOBJSEL - содержит название локации-обработчика выбора предмета. Данная локация полезна, к примеру, для вывода меню предметов. Получить название выбранного предмета можно через функцию "SELOBJ".

UNSELECT или UNSEL - отмена выбора предмета. При выборе играющим какого- либо предмета, он остаётся выделенным. Данная команда снимает выделение.

SELOBJ - возвращает название выделенного предмета.

$ONOBJADD - содержит название локации-обработчика добавления предмета. При добавлении предмета локация вызывается с аргументом ($ARGS[0]) - названием добавленного предмета. Данная локация полезна, к примеру, для ограничения вместительности рюкзака.

$ONOBJDEL - содержит название локации-обработчика удаления предмета. При удалении предмета локация вызывается с аргументом ($ARGS[0]) - названием удалённого предмета. Данная локация полезна, к примеру, для проверки возможности удаления предмета.

$USERCOM - содержит название локации-обработчика строки ввода. Полезна при организации парсера (управление игрой с помощью строки ввода). Текущий текст строки ввода возвращает функция "USER_TEXT".

PS:

При обработке локаций по GOSUB, а также локаций, на которые указывают пункты пользовательского меню и системные переменные ($COUNTER, $USERCOM, $ONGLOAD, $ONGSAVE, $ONNEWLOC, $ONACTSEL, $ONOBJSEL, $ONOBJADD, $ONOBJDEL), учитываются базовые описания и действия на локациях (при отсутствии действий с такими же названиями - к текущим действиям добавляются базовые действия обрабатываемой локации, базовое описание локации добавляется к текущему основному описанию). Аналогично, при вызовах XGOTO, к текущему основному описанию добавляется базовое описание локации, на которую произошёл переход.

PS:

Очистить строку ввода можно в любом месте игры с помощью оператора "CMDCLEAR".