AeroQSP help

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

Переменная	Комментарий	Значение по умолчанию
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

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

Переменная	Комментарий	Значение по умолчанию
$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

Переменная	Комментарий	Значение по умолчанию
$INPUT_BACKIMAGE	путь к фоновой картинке для диалога 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

Переменная	Комментарий	Значение по умолчанию
$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

Переменная	Комментарий	Значение по умолчанию
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

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

Список эффектов (для $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 пикселей.

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