ИнформАрхив QSP

Справка по 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":

Здесь:

width — указывает ширину экрана игры в пикселях

height — указывает высоту экрана игры в пикселях

title — название игры (отображается в заголовке окна)

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

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

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

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