Проектирование интерфейса управления комнатой
Установка фона комнаты
В Queen Studio предусмотрена возможность установки, смены и удаления фонового изображения. Это изображение сделает интерфейс наглядным и удобным, фоном, например, может быть выбран настоящий план помещений, на котором очень удобно будет размещать объекты, с которыми будет работать Гейммастер.
По умолчанию фонового изображения нет и фон серый. Для того, чтобы установить фоновое изображение, разместите выбранное изображение в папке проекта, room\guide\media\img Изображение должно быть формата *.png, не содержать пробелов, спецсимволов и содержать только латиницу. Затем, на панели properties кликаем на поле image в разделе canvas и выбираем нужный файл. Изображение подложки расположится в верхнем левом углу в натуральный размер. Все остальное поле будет заполнено цветом, выбранным в поле bgcolor.
Если Вы не хотите устанавливать изображение на фон, можно просто выбрать цвет фона, кликом в поле bgcolor в окне properties в подразделе canvas.
Если у Вас уже был установлен фон до этого, но Вы хотите его убрать, то кликните правой кнопкой мыши на свободном от объектов поле и выберите пункт Remove Background Image.
Создание объекта платы управления
Для создания Платы (board) необходимо правой кнопкой мыши кликнуть в окне редактирования комнаты в свободное от компонентов место, в результате выскочит контекстное меню, в котором нужно выбрать Create → board.
При выделении объекта типа board на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для out возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textalign | параметры прилегания текста внутри прямоугольника | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
board | в этом блоке указываются параметры платы | |
type | ||
stream | ||
own | ||
rem |
если мы используем картинку вместо прямоугольника, меню изменяется:
Блок | Параметр | Описание |
|---|---|---|
ui | ||
picset | выбор объекта типа picset для отображения в качестве элемента | |
rotate | угол поворота изображения |
Создание объектов электроники
Для создания объектов электроники необходимо кликнуть правой кнопкой мыши в окне редактирования комнаты в свободное от компонентов место, в результате чего появится контекстное меню, в котором необходимо выбрать тип создаваемого компонента.
Далее приведено описание каждого типа элементов.
Объекты ШИМ - Широтно-Импульсной Модуляции (pwm)
При помощи объектов pwm Гейммастер может имитировать изменение напряжения - управлять элементами освещения, двигателями, например, светодиодными лентами. Яркость и цвет регулируются посредством комбинирования данных (от 0 до 255), приходящих на три канала - red (красный), green зеленый), blue (синий). Также можно перевести элемент в один из режимов стробирования при помощи двойного клика на элементе во время запущенной игры, либо при помощи макроэффектов. В таком случае рядом с числами, обозначающими уровень, будет отображаться одна или две звездочки, в зависимости от режима стробирования.
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для pwm возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет элемента (только если render содержит bgcolor) | |
bgscolor | цвет заполнения элемента (при возрастании уровня сигнала) (только если render содержит bgcolor) | |
orient | ориентация элемента и направление заполнения (горизонтальное/вертикальное) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
index | номер реле на плате queen_board (только для board типа queen_board) | |
inverted | признак инверсии, то есть включено и выключено меняются местами | |
hwtype |
Объекты дискретного вывода (out)
Объекты дискретного вывода (далее по тексту просто out) нужны для простейшего управления, то есть включить / выключить, таким образом out имеет только два состояния. В системе QUEEN гейммастер имеет возможность воздействовать на этот объект, меняя его состояние при помощи мыши. Как правило к объекту типа out физически привязано реле, которое в действительности управляет силовой цепью, может включать выключать: свет, электромагнитные и электромеханические замки, дым-машины, да и вообще все, что работает по принципу включить/выключить.
При выделении объекта типа out на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для pwm возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет элемента (только если render содержит bgcolor) | |
bgscolor | цвет заполнения элемента (при возрастании уровня сигнала) (только если render содержит bgcolor) | |
orient | ориентация элемента и направление заполнения (горизонтальное/вертикальное) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
index | номер реле на плате queen_board (только для board типа queen_board) | |
inverted | признак инверсии, то есть включено и выключено меняются местами | |
hwtype |
Объекты аналогового ввода (ain)
Объекты аналогового ввода (далее по тексту просто ain) нужны для считывания информации с аналоговых входов в диапазоне от 0 до 1023. Такими аналоговыми элементами могут быть датчики света, потенциометры и т.п. В системе QUEEN Гейммастер имеет возможность сымитировать воздействие на этот объект, меняя его состояние при помощи мыши (от 0 до 1023).
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для pwm возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет элемента (только если render содержит bgcolor) | |
bgscolor | цвет заполнения элемента (при возрастании уровня сигнала) (только если render содержит bgcolor) | |
orient | ориентация элемента и направление заполнения (горизонтальное/вертикальное) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
index | номер реле на плате queen_board (только для board типа queen_board) | |
inverted | признак инверсии, то есть включено и выключено меняются местами | |
hwtype |
Объекты дискретного ввода (din)
Объекты дискретного ввода (далее по тексту просто din) нужны для простейшего считывания информации о состоянии объекта (нажата/отпущена кнопка, включены/выключены замки и т.п.), таким образом din имеет только два состояния. В системе QUEEN гейммастер имеет возможность сымитировать воздействие на этот объект, меняя его состояние при помощи мыши.
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для pwm возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет элемента (только если render содержит bgcolor) | |
bgscolor | цвет заполнения элемента (при возрастании уровня сигнала) (только если render содержит bgcolor) | |
orient | ориентация элемента и направление заполнения (горизонтальное/вертикальное) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
index | номер реле на плате queen_board (только для board типа queen_board) | |
inverted | признак инверсии, то есть включено и выключено меняются местами | |
hwtype |
Объекты (uni)
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для pwm возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет элемента (только если render содержит bgcolor) | |
bgscolor | цвет заполнения элемента (при возрастании уровня сигнала) (только если render содержит bgcolor) | |
orient | ориентация элемента и направление заполнения (горизонтальное/вертикальное) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
index | номер реле на плате queen_board (только для board типа queen_board) | |
inverted | признак инверсии, то есть включено и выключено меняются местами | |
hwtype |
Создание элемента управления звуками (audio)
Элементы типа audio позволяют работать со звуками, а именно показывать уровни громкости воспроизводимых аудиофайлов. У элемента есть 3 канала: B - background - фоновые звуковые эффекты, F - foreground - звуковые эффекты переднего плана, V - voice - звуки речи. Гейммастер может управлять уровнями громкости с помощью мыши - значения от 0 до 100.
Файлы для работы следует располагать по адресу: …location\name-of-the-quest\soft\room\media\snd... [background или foreground или voice] соответственно
Чтобы работать со звуками и их уровнями, необходимо правой кнопкой мыши кликнуть в окне редактирования комнаты в свободное от компонентов место, после чего выбрать create → audio
После добавления элемента, разместите его в требуемое место.
При выделении объекта типа audio на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для out возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет компонента в состоянии выключено (только если render содержит bgcolor) | |
bgscolor | цвет компонента в состоянии включено (только если render содержит bgcolor) | |
textalign | параметры прилегания текста внутри прямоугольника | |
audio | в этом блоке указываются параметры | |
own |
Создание элемента типа "Адаптер" (adapter)
При выделении объекта типа adapter на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселаях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для adapter возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет компонента в состоянии выключено (только если render содержит bgcolor) | |
bgscolor | цвет компонента в состоянии включено (только если render содержит bgcolor) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
server | Указывается адрес, к которому будет обращаться программа, чтобы повлиять на устройство | |
ip:port | Указывается адрес в формате [ ip :порт ] |
Создание элементов типа "Метка" (label)
Метки создаются исключительно для Гейммастера, для выполнения следующих функций:
отображения статической (неизменяемой) надписи (statictext)
- отсчет времени (время идёт вперёд) (time)
- выбор сценария (scenario)
- отображение выбранного языка и возможность смены (language)
- отображение режима работы (play/stop) (чтобы видеть, запущена ли игра) (mode) можно видеть режим и название запущенной стадии
- отображение названия объекта и его состояния (status)
- отображения список подключённых абонентов к room серверу (abonents)
- отображение всех переменных из глобальной и текущей стадии (variables)
- отображение списка всех запущенных макроэффектов (macroeffects)
- отображения навигационной панели с базовым набором кнопок (стоп, режим отладки, старт, шаг назад, пауза, шаг вперёд, безусловный переход на следующий этап (по сценарию), безусловная победа, безусловное поражение), выбором лимита времени и таймером обратного отсчёта, отображением названия этапа и режима. Если на холсте уже есть навигационная панель (navigator), то второй поставить невозможно - пропадает пункт navigator из выпадающего меню) (navigator)
Чтобы выбрать тип метки, необходимо кликнуть на объекте-метке, и на панели properties выбрать тип метки в поле bind. При выделении объекта типа label на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для label возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
textalign | параметры прилегания текста внутри прямоугольника | |
label | в этом блоке выбирается тип Ярлыка | |
bind | Выбор типа ярлыка (statictext/time/scenario/language/mode/status/mode/abonents/variables/macroeffects) |
Создание элемента "Журнал" (logger)
Элемент “Журнал” вербально описывает процессы, происходящие в квесте (начало стадии, комментарии к происходящему, выполняемые макроэффекты).
При выделении объекта типа logger на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для logger возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, text only - только текст | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет компонента в состоянии выключено (только если render содержит bgcolor) | |
bgscolor | цвет компонента в состоянии включено (только если render содержит bgcolor) |
Создание Кнопки (button)
Кнопка требуется Гейммастеру для запуска каких-либо процессов во время игры. К кнопке “привязывается” конкретное действие, т.е. созданный макроэффект или стандартные функции (например, +1 минута или безусловная победа)
При выделении объекта типа button на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для button возможно только bgcolor and text - фон + текст | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет компонента в состоянии выключено (только если render содержит bgcolor) | |
bgscolor | цвет компонента в состоянии включено (только если render содержит bgcolor) | |
textalign | параметры прилегания текста внутри прямоугольника |
Создание элементов-помощников (helpers)
Создание "диммера" (dimmer)
Диммер даёт возможность Гейммастеру наглядно понять, какого цвета/яркости в данный момент освещение/визуализация.
При выделении объекта типа dimmer на панели properties появляются следующие свойства:
Блок | Параметр | Описание |
|---|---|---|
name | уникальное имя объекта | |
ui | в этом блоке указываются параметры отображения объекта на холсте | |
rect | область расположения объекта в пикселях относительно окна room, этот параметр не редактируется | |
name | имя, которое отображается на форме | |
render | способ отображения компонента, для dimmer возможны следующие варианты: bgcolor and text - фон + текст, bgcolor only - только фон, text only - только текст, picset and text - картинка + текст, picset only - только картинка | |
font | параметры шрифта текста (только если render содержит text) | |
textcolor | цвет текста (только если render содержит text) | |
bgcolor | цвет компонента в состоянии выключено (только если render содержит bgcolor) | |
bgscolor | цвет компонента в состоянии включено (только если render содержит bgcolor) | |
picset | выбор объекта типа picset для определения состояний выключено и включено при помощи картинок (только если render содержит picset) | |
rotate | угол поворота картинки в градусах (только если render содержит picset) | |
pin | в этом блоке указываются параметры привязки к аппаратуре | |
board | тип оборудования; возможные варианты на текущий момент: queen_board, queen_bus | |
dimmer | **Группа, для привязки уровней цветов и яркости диммера к устройствам | |
red | выбор устройства, отвечающего за уровень красного канала | |
green | выбор устройства, отвечающего за уровень зелёного канала | |
blue | выбор устройства, отвечающего за уровень синего канала |
Дважды кликнув на диммере на холсте, можно, при желании, изменить форму обозначившегося четырехугольника, потянув за кружки в углах.