Перейти к основному содержимому

Справка по AeroQSP (в дополнение к основной справке QSP)

Для всех элементов оформления рекомендуется использовать формат картинок PNG, с поддержкой альфа-канала (регулируемая прозрачность). Кроме этого, HTML-движок и оператор VIEW поддерживают анимированные GIF-файлы.

Общие параметры​

Здесь даётся список системных переменных для AeroQSP, которые отвечают за различные общие настройки.

  • SCROLL_SPEED — скорость скроллирования. Значение по-умолчанию: 20.
  • $UP_ARROW_IMAGE — путь к изображению со стрелкой вверх (для скроллируемых элементов). Значение по-умолчанию: "".
  • $DOWN_ARROW_IMAGE — путь к изображению со стрелкой вниз (для скроллируемых элементов). Значение по-умолчанию: "".
  • HIDE_SCROLL_ARROWS — флаг, скрывать стрелки для скроллирования. Значение по-умолчанию: 0.
  • LCOLOR — цвет ссылок по-умолчанию. Значение по-умолчанию: RGB(0,0,255).
  • FCOLOR — цвет шрифта по-умолчанию. Значение по-умолчанию: RGB(0,0,0).
  • $FNAME — название шрифта по-умолчанию. Значение по-умолчанию: "_sans".
  • FSIZE — размер шрифта по-умолчанию. Значение по-умолчанию: 18.
  • $STYLESHEET — набор CSS-стилей. Значение по-умолчанию: "".
  • BCOLOR — цвет фона. Значение по-умолчанию: RGB(229,229,229,204).
  • USEHTML — флаг, использовать HTML для текста. Значение по-умолчанию: 0.
  • DISABLESHADE — флаг, отключить затенение для WAIT и модальных окошек (INPUT, MSG, MENU). Значение по-умолчанию: 0.
  • DISABLESCROLL — флаг, отключить автоскроллирование для основного / доп. описания. Значение по-умолчанию: 0.
  • DISABLEAUTOREF — флаг, отключить автообновление экрана при показе модальных окошек (INPUT, MSG, MENU). Значение по-умолчанию: 0.
  • $NEWLOC_EFFECT — название эффекта для перехода между локациями. Значение по-умолчанию: "".
  • NEWLOC_EFFECT_TIME — время эффекта для перехода между локациями (в миллисекундах). Значение по-умолчанию: 500.
  • NEWLOC_EFFECT_SEQ — флаг, использовать последовательное наложение эффектов для перехода между локациями. Значение по-умолчанию: 0.

Параметры основного экрана​

Здесь даётся список системных переменных для AeroQSP, которые отвечают за различные настройки основного экрана.

  • $BACKIMAGE — фоновая картинка для главного экрана. Значение по-умолчанию: "".
  • $TOPIMAGE — картинка, накладываемая поверх главного экрана. Значение по-умолчанию: "".
  • INTEGRATED_ACTIONS — флаг, использовать совмещенный с основным описанием список действий. Значение по-умолчанию: 0.

Основное описание​

  • MAINDESC_X — X-позиция основного описания. Значение по-умолчанию: 4.
  • MAINDESC_Y — Y-позиция основного описания. Значение по-умолчанию: 4.
  • MAINDESC_W — ширина основного описания. Значение по-умолчанию: 589.
  • MAINDESC_H — высота основного описания. Значение по-умолчанию: 389.
  • $MAIN_FORMAT — формат основного описания. служебное поле %TEXT%. Значение по-умолчанию: "%TEXT%".
  • $MAINDESC_BACKIMAGE — фоновая картинка для основного описания. Значение по-умолчанию: "".

Дополнительное описание​

  • STATDESC_X — X-позиция дополнительного описания. Значение по-умолчанию: 596.
  • STATDESC_Y — Y-позиция дополнительного описания. Значение по-умолчанию: 396.
  • STATDESC_W — ширина дополнительного описания. Значение по-умолчанию: 200.
  • STATDESC_H — высота дополнительного описания. Значение по-умолчанию: 200.
  • $STAT_FORMAT — формат дополнительного описания. служебное поле %TEXT%. Значение по-умолчанию: "%TEXT%".
  • $STATDESC_BACKIMAGE — фоновая картинка для дополнительного описания. Значение по-умолчанию: "".

Список действий​

  • ACTIONS_X — X-позиция списка действий. Значение по-умолчанию: 4.
  • ACTIONS_Y — Y-позиция списка действий. Значение по-умолчанию: 396.
  • ACTIONS_W — ширина списка действий. Значение по-умолчанию: 589.
  • ACTIONS_H — высота списка действий. Значение по-умолчанию: 169.
  • $ACTION_FORMAT — формат действия. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;'>%TEXT%</td></tr></table>".
  • $SEL_ACTION_FORMAT — формат выделенного действия. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;color:#0000FF;'>%TEXT%</td></tr></table>".
  • $ACTIONS_BACKIMAGE — фоновая картинка для списка действий. Значение по-умолчанию: "".

Список предметов​

  • OBJECTS_X — X-позиция списка предметов. Значение по-умолчанию: 596.
  • OBJECTS_Y — Y-позиция списка предметов. Значение по-умолчанию: 4.
  • OBJECTS_W — ширина списка предметов. Значение по-умолчанию: 200.
  • OBJECTS_H — высота списка предметов. Значение по-умолчанию: 389.
  • $OBJECT_FORMAT — формат предмета. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;'>%TEXT%</td></tr></table>".
  • $SEL_OBJECT_FORMAT — формат выделенного предмета. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;color:#0000FF;'>%TEXT%</td></tr></table>".
  • $OBJECTS_BACKIMAGE — фоновая картинка для списка предметов. Значение по-умолчанию: "".

Строка ввода​

  • USERINPUT_X — X-позиция строки ввода. Значение по-умолчанию: 4.
  • USERINPUT_Y — Y-позиция строки ввода. Значение по-умолчанию: 568.
  • USERINPUT_W — ширина строки ввода. Значение по-умолчанию: 589.
  • USERINPUT_H — высота строки ввода. Значение по-умолчанию: 28.

Окно изображения VIEW​

  • VIEW_X — X-позиция области картинки для оператора VIEW. Значение по-умолчанию: 250.
  • VIEW_Y — Y-позиция области картинки для оператора VIEW. Значение по-умолчанию: 150.
  • VIEW_W — ширина области картинки для VIEW. Значение по-умолчанию: 300.
  • VIEW_H — ширина области картинки для VIEW. Значение по-умолчанию: 300.
  • $VIEW_EFFECT — название эффекта для показа/скрытия картинок через VIEW. Значение по-умолчанию: "".
  • VIEW_EFFECT_TIME — время эффекта для VIEW (в миллисекундах). Значение по-умолчанию: 500.
  • ALWAYS_SHOW_VIEW — флаг, не скрывать картинку при клике на ней. Значение по-умолчанию: 0.
  • $INPUT_BACKIMAGE — путь к фоновой картинке для диалога INPUT (задает размеры диалога). Значение по-умолчанию: "".

Параметры диалога ввода INPUT​

Здесь даётся список системных переменных для AeroQSP, которые отвечают за различные настройки диалогового окна, вызываемого функцией $INPUT.

  • INPUT_X — X-позиция диалога INPUT (если X или Y меньше 0, то показывает диалог в позиции курсора мыши). Значение по-умолчанию: 200.
  • INPUT_Y — Y-позиция диалога INPUT (если X или Y меньше 0, то показывает диалог в позиции курсора мыши). Значение по-умолчанию: 165.
  • $INPUT_FORMAT — формат описания в диалоге INPUT. служебное поле %TEXT%. Значение по-умолчанию: "%TEXT%".
  • INPUT_TEXT_X — X-позиция описания в диалоге INPUT. Значение по-умолчанию: 4.
  • INPUT_TEXT_Y — Y-позиция описания в диалоге INPUT. Значение по-умолчанию: 4.
  • INPUT_TEXT_W — ширина описания в диалоге INPUT. Значение по-умолчанию: 392.
  • INPUT_TEXT_H — высота описания в диалоге INPUT. Значение по-умолчанию: 231.
  • INPUT_BAR_X — X-позиция строки ввода в диалоге INPUT. Значение по-умолчанию: 4.
  • INPUT_BAR_Y — Y-позиция строки ввода в диалоге INPUT. Значение по-умолчанию: 238.
  • INPUT_BAR_W — ширина строки ввода в диалоге INPUT. Значение по-умолчанию: 312.
  • INPUT_BAR_H — высота строки ввода в диалоге INPUT. Значение по-умолчанию: 28.
  • $INPUT_OK_IMAGE — путь к картинке для кнопки OK в диалоге INPUT. Значение по-умолчанию: "".
  • INPUT_OK_X — X-позиция кнопки OK в диалоге INPUT. Значение по-умолчанию: 324.
  • INPUT_OK_Y — Y-позиция кнопки OK в диалоге INPUT. Значение по-умолчанию: 239.
  • $INPUT_CANCEL_IMAGE — путь к картинке для кнопки CANCEL в диалоге INPUT. Значение по-умолчанию: "".
  • INPUT_CANCEL_X — X-позиция кнопки CANCEL в диалоге INPUT. Значение по-умолчанию: 362.
  • INPUT_CANCEL_Y — Y-позиция кнопки CANCEL в диалоге INPUT. Значение по-умолчанию: 239.
  • $INPUT_EFFECT — название эффекта для показа/скрытия диалога INPUT. Значение по-умолчанию: "".
  • INPUT_EFFECT_TIME — время эффекта для INPUT (в миллисекундах). Значение по-умолчанию: 500.

Параметры диалога сообщения MSG​

Здесь даётся список системных переменных для AeroQSP, которые отвечают за различные настройки диалогового окна, вызываемого оператором MSG.

  • $MSG_BACKIMAGE — путь к фоновой картинке для диалога MSG (задает размеры диалога). Значение по-умолчанию: "".
  • MSG_X — X-позиция диалога MSG (если X или Y меньше 0, то показывает диалог в позиции курсора мыши). Значение по-умолчанию: 200.
  • MSG_Y — Y-позиция диалога MSG (если X или Y меньше 0, то показывает диалог в позиции курсора мыши). Значение по-умолчанию: 165.
  • $MSG_FORMAT — формат описания в диалоге MSG. служебное поле %TEXT%. Значение по-умолчанию: "%TEXT%".
  • MSG_TEXT_X — X-позиция описания в диалоге MSG. Значение по-умолчанию: 4.
  • MSG_TEXT_Y — Y-позиция описания в диалоге MSG. Значение по-умолчанию: 4.
  • MSG_TEXT_W — ширина описания в диалоге MSG. Значение по-умолчанию: 392.
  • MSG_TEXT_H — высота описания в диалоге MSG. Значение по-умолчанию: 231.
  • $MSG_OK_IMAGE — путь к картинке для кнопки OK в диалоге MSG. Значение по-умолчанию: "".
  • MSG_OK_X — X-позиция кнопки OK в диалоге MSG. Значение по-умолчанию: 186.
  • MSG_OK_Y — Y-позиция кнопки OK в диалоге MSG. Значение по-умолчанию: 239.
  • $MSG_EFFECT — название эффекта для показа/скрытия диалога MSG. Значение по-умолчанию: "".
  • MSG_EFFECT_TIME — время эффекта для MSG (в миллисекундах). Значение по-умолчанию: 500.

Параметры меню MENU​

Здесь даётся список системных переменных для AeroQSP, которые отвечают за различные настройки всплывающего меню, которое появляется при использовании оператором MENU.

  • FIXED_SIZE_MENU — флаг, использовать фиксированную высоту всплывающего меню. Значение по-умолчанию: 0.
  • MENU_PADDING — отступ списка меню. Значение по-умолчанию: 4.
  • MENU_BORDER — толщина границы меню. Значение по-умолчанию: 1.
  • MENU_BORDER_COLOR — цвет границы меню. Значение по-умолчанию: RGB(64,64,64,150).
  • $MENU_BACKIMAGE — путь к фоновой картинке для всплывающего меню (задает размеры меню при FIXED_SIZE_MENU). Значение по-умолчанию: "".
  • MENU_X — X-позиция всплывающего меню (если X или Y меньше 0, то показывает меню в позиции курсора мыши). Значение по-умолчанию: -1.
  • MENU_Y — Y-позиция всплывающего меню (если X или Y меньше 0, то показывает меню в позиции курсора мыши). Значение по-умолчанию: -1.
  • $MENU_FORMAT — формат пункта всплывающего меню. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;'>%TEXT%</td></tr></table>".
  • $SEL_MENU_FORMAT — формат выделенного пункта всплывающего меню. служебные поля %TEXT%, %IMAGE% (путь к файлу картинки). Значение по-умолчанию: "<table><tr><td><img src='%IMAGE%'/></td><td style='width:100%;color:#0000FF;'>%TEXT%</td></tr></table>".
  • MENU_LIST_X — X-позиция элементов списка меню (при FIXED_SIZE_MENU). Значение по-умолчанию: 4.
  • MENU_LIST_Y — Y-позиция элементов списка меню (при FIXED_SIZE_MENU). Значение по-умолчанию: 4.
  • MENU_LIST_W — ширина списка меню. Значение по-умолчанию: 153.
  • MENU_LIST_H — высота списка меню (при FIXED_SIZE_MENU). Значение по-умолчанию: 123.
  • $MENU_EFFECT — название эффекта для показа/скрытия всплывающего меню. Значение по-умолчанию: "".
  • MENU_EFFECT_TIME — время эффекта для MENU (в миллисекундах). Значение по-умолчанию: 500.

Список эффектов (для $NEWLOC_EFFECT, $VIEW_EFFECT, $INPUT_EFFECT, $MSG_EFFECT, $MENU_EFFECT)​

  • fade
  • quake
  • blur
  • h_blinds
  • v_blinds
  • l_slide
  • r_slide
  • u_slide
  • d_slide
  • iris
  • photo
  • pixels
  • rotate
  • v_squeeze
  • h_squeeze
  • zoom
  • wipe1
  • wipe2
  • wipe3
  • wipe4

Поддержка HTML​

Текущая версия HTML-движка ориентирована на использование стилей, а не простых аттрибутов элементов.

Поддерживаемые теги:

  • DIV
  • TABLE
  • TR
  • TD
  • TH
  • CENTER
  • A
  • IMG
  • BR
  • P
  • B
  • I
  • U
  • FONT
  • SPAN
  • LI
  • OL
  • UL

Поддерживаемые свойства:

  • width (проценты, пиксели)
  • height (только пиксели)
  • position ("absolute")
  • left (пиксели)
  • top (пиксели)
  • border
  • border-width
  • border-style
  • border-color
  • display ("inline")
  • float ("left")
  • text-align ("left", "right", "center")
  • vertical-align ("top", "middle", "bottom")
  • font-family
  • font-size
  • font-style
  • font-weight
  • leading
  • letter-spacing
  • margin-left
  • margin-right
  • text-decoration
  • text-indent
  • color
  • padding
  • padding-left
  • padding-top
  • padding-right
  • padding-bottom
  • background-color
  • background-image

Встраиваемые шрифты​

AeroQSP поддерживает встраивание шрифтов в игру. Для этого необходимо swf-файл со встроенным шрифтом положить в zip-архив игры (в любую папку). Использование встроенного шрифта аналогично использованию обычного системного шрифта - там, где необходимо, указывается его имя. При наличии в архиве игры хотя бы одного встроенного шрифта, использование системных шрифтов запрещено.

Звуки и музыка​

Поддерживается воспроизведение MP3-файлов.

Файл конфигурации​

Конфигурация игры дополнительно настраивается в файле "config.xml", который необходимо разместить в архиве рядом с qsp-файлом. Пример файла "config.xml":

<game width="504" height="680" title="Чашка кофе"/>

Здесь:

  • width — указывает ширину экрана игры в пикселях
  • height — указывает высоту экрана игры в пикселях
  • title — название игры (отображается в заголовке окна)

Кодировка файла - UTF-8.

PS: По умолчанию размер экрана игры 800x600 пикселей.

Примечание Aleks Versus:

AeroQSP — плеер, работающий на устаревшей и отжившей своё технологии Flash. Adobe прекратила поддержку данной технологии, что означает, что AeroQSP стало невозможно использовать. Игры AeroQSP можно пробовать запустить на qSpider, но это так же потребует танцев с бубнами. Лучше писать игры сразу для qSpider, не уповая на то, что он поддерживает AeroQSP.