Конфигурационный файл Infopanel¶
Внешний вид панели, ее конфигурация, описывается при помощи XML файла. Для обычно файл называется PanelDemoConfig.xml.
XML файл должен иметь структуру:
<code class="xml">
<root>
<FLASH_CONFIG>
...
</FLASH_CONFIG>
<FLASH_PROPERTY>
...
</FLASH_PROPERTY>
<FLASH_METHOD>
...
</FLASH_METHOD>
</root>
Этот тег должен быть обязательно и только один. В нем описывается создание и расположение объектов. Далее приведены вложенные теги, в порядке их указания в файле.
Эта секция описывает основные параметры панели и ее подключение к системе событий Digidpot II, если панель работает в связке с ПО Digispot. Пример:
<code class="xml">
<main>
<DigispotHostName>LeftFlash</DigispotHostName>
<DigispotServer>127.0.0.1</DigispotServer>
<DigispotPort>7602</DigispotPort>
<scaleMode>noScale</scaleMode>
<quality>high</quality>
<OpenLogOnError>true</OpenLogOnError>
<MaxLogRecords>200</MaxLogRecords>
<LogOk>true</LogOk>
</main>
В данном случае в системе событий хост панели имеет имя LeftFlash и подключается к серверной точке Digispot (с протоколом XML), доступной по адресу 127.0.0.1 порт 7602.
Плеер не масштабирует ролик и воспроизводит его с высоким качеством.
Описание параметров:
- Параметры лога, также смотрите описание модуля Main.
- MaxLogRecords - количество записей в логе. По умолчанию 1000
- LogOk - нужно ли включать в лог успешные записи. По умолчанию true.
-
OpenLogOnError - открывать автоматически окно сообщений при первой ошибке. По умолчанию - false = не открывать.
При ошибке станет красным индикатор ошибки в верхнем левом углу.
- DigispotHostName - имя хоста Digispot II, к которому клип подключается.
Тег создает графический "слой" с расположенными на нем объектами. Таких тегов может быть много. Более поздние слои накладываются на более ранние. Содержит теги:
Создает один из графических объектов:
- Клип из файла
- Картинку из файла
- Объект из библиотеки классов Flash
- Прямоугольник
и размещает объект в указанных координатах, указанных в точках, относительно верхнего левого угла. Позволяет указать размеры объекта. Если их не указывать - объект отображается "как есть", иначе - масштабируется таким образом, чтобы вписаться в указанные размеры.
Более поздние клипы накладываются поверх более ранних в пределах слоя.
Вложенные теги:
Создает из файла картинку или клип, в зависимости от типа файла. Файл может быть картинкой:.JPG, .PNG, .GIF или клипом .SWF.
Нельзя использовать вместе с class
Создает объект класса из библиотеки классов Flash. Класс необходимо указывать полностью, с указанием package (чувствительно к регистру). Создаваемый объект должен быть экранным объектом. Типовой пример - окно отображения текста - flash.text.TextField.
Нельзя использовать вместе с file
¶
Необязательные теги расположения и размеров создаваемого объекта. При указании размера объект масштабируется.
Необязательный тег - ид данного объекта для: вызова методов, установки свойств, посылки событий.
Нельзя использовать Main в качестве идентификатора - это id главного клипа.
Id чувствителен к регистру.
Необязательный тег - тип отображения данного объекта. Еще тут. Можно использовать для различных графических эффектов при наложении нескольких объектов друг на друга.
Необязательный тег - прозрачность объекта. 1.0 - полностью непрозрачный. 0 - полностью прозрачный.
Необязательный тег - цвет фона объекта. Ели не указывать, то, обычно, прозрачный. Меняет свойство объекта opaqueBackground.
прямоугольник¶
Если не указывать ни class ни file, то будет создан прямоугольник указанных размеров, цвета и прозрачности.
Этот тег позволяет установить именованные свойства для указанного объекта. Свойства могут быть стандартные, вот пример свойств, которые есть у любых объектов.
Кроме этого, у загружаемых клипов могут быть свои уникальные свойства, приведенные в описании данных клипов.
В данном теге создаются теги с идентификаторами объектов, свойства которых устанавливаются, внутри них - теги с именами свойств (чувствительны к регистру), внутри которых значения. Значения должны совпадать с типами свойств.
Пример установки цвета фона главному клипу (id=Main). Цвет фона задается числом RGB, в данном случае - черный.
Содержимое данного тега обрабатывается после завершения загрузки всех клипов.
<code class="xml">
<FLASH_PROPERTY>
<Main>
<opaqueBackground>0</opaqueBackground>
</Main>
</FLASH_PROPERTY>
Этот тег позволяет вызвать методы (функции) у указанных объектов. Методы зависят от типа объекта и узнать их названия и параметры можно из их описания.
В данном теге создаются теги с идентификаторами объектов, методы которых вызываются, внутри них - теги с именами методов (чувствительны к регистру), внутри которых теги с любыми названиями, содержащие аргументы в порядке, указанном в описании метода. Значения аргументов должны совпадать с типами свойств.
Содержимое данного тега обрабатывается после завершения загрузки всех клипов.
Пример вызова метода Init у объекта с id=Obj и двумя параметрами
<code class="xml">
<FLASH_METHOD>
<Obj>
<Init>
<a1>0<a1>
<a2>true</a2>
</Init>
</Obj>
</FLASH_METHOD>