Конфигурационный файл Infopanel¶

• Table of contents
• Конфигурационный файл Infopanel

Внешний вид панели, ее конфигурация, описывается при помощи XML файла. Файл называется PanelDemoConfig.xml.

XML файл должен иметь структуру:

<code class="xml">
<root>
  <FLASH_CONFIG>
    ...
  </FLASH_CONFIG>

  <FLASH_PROPERTY>
    ...
  </FLASH_PROPERTY>

  <FLASH_METHOD>
   ...
  </FLASH_METHOD>
</root>

Этот тег должен быть обязательно и только один. В нем описывается создание и расположение объектов. Тег иметь такую структуру:

<code class="xml">
<FLASH_CONFIG>
  <main>
   ...
  </main>
  <layer>
   ...
  </layer>
</FLASH_CONFIG>
</root>

Эта секция описывает основные параметры панели и ее подключение к системе событий Digidpot II, если панель работает в связке с ПО Digispot. Пример:

<code class="xml">
<main>
 <DigispotHostName>LeftFlash</DigispotHostName>
 <DigispotServer>127.0.0.1</DigispotServer>
 <DigispotPort>7602</DigispotPort>
 <quality>high</quality>          
 <LogOk>true</LogOk>
 <stageWidth>true</stageWidth>
 <stageHeight>true</stageHeight>
</main>

Описание параметров:

• DigispotHostName - имя хоста Digispot II, к которому клип подключается.
• DigispotServer – адрес сервера
• DigispotPort – порт
• quality – качество воспроизведения ролика (low/medium/high)
• LogOk - нужно ли включать в лог успешные записи. По умолчанию true.
• stageWidth – ширина экрана
• stageHeight – высота экрана

Тег создает графический "слой" с расположенными на нем объектами. Таких тегов может быть много. Более поздние слои накладываются на более ранние. Содержит множество тегов , каждый из которых соответствует одному объекту.
Первый клип должен представлять собой описание фона:

<code class="xml">
<clip>
   <id>Background</id>
   <x>0</x>
   <y>0</y>
   <width>600</width>
   <height>400</height>
   <color>0x000000</color>
</clip>

Для остальных клипов в тег могут входить теги (), , , , , . Например:

<code class="xml">
<clip>
   <class>CircleProgress</class>
   <id>CircleProgress-1</id>
   <x>430</x>
   <y>10</y>
</clip>

В теге создается один из графических объектов:

1. Клип из файла
2. Картинка из файла
3. Клип из списка доступных виджетов

Клип размещается в указанных координатах, относительно верхнего левого угла. Более поздние клипы накладываются поверх более ранних в пределах слоя.

file>
Создает из файла картинку или клип, в зависимости от типа файла. Файл может быть картинкой:.JPG, .PNG, .GIF или клипом .SWF.
Нельзя использовать вместе с class

class>
Создает клип из указанного класса. Например, чтобы добавить клип TextBox необходимо написать TextBox
Нельзя использовать вместе с file

x>
Теги расположения и размеров создаваемого объекта. При указании размера объект масштабируется.

Для клипа, созданного из класса, теги и писать не надо. Для клипа, созданного из файла, эти теги являются обязательными. При этом стоит учитывать размер клипа по-умолчанию, и менять размеры пропорционально.

id>
идентификатор данного объекта для: вызова методов, установки свойств, посылки событий.
Нельзя использовать Main в качестве идентификатора - это id главного клипа.
Id чувствителен к регистру.

Этот тег позволяет установить именованные свойства для указанного объекта.
У загружаемых клипов есть свои уникальные свойства, приведенные в описании данных клипов.
В данном теге создаются теги с идентификаторами объектов, свойства которых устанавливаются, внутри них - теги с именами свойств (чувствительны к регистру), внутри которых значения. Значения должны совпадать с типами свойств.
Пример установки свойств клипу кругового прогрессбара (id=CircleProgress-1).
Содержимое данного тега обрабатывается после завершения загрузки всех клипов.

<code class="xml">
<CircleProgress-1>
      <StageColor>16724787</StageColor>
      <CircleColor>0</CircleColor>
      <InnerRadius>20</InnerRadius>
      <OuterRadius>70</OuterRadius>
      <StartStateEmpty>true</StartStateEmpty>
      <FillLeftToRight>true</FillLeftToRight>
</CircleProgress-1>

Этот тег позволяет вызвать методы (функции) у указанных объектов. Методы зависят от типа объекта и узнать их названия и параметры можно из их описания.
В данном теге создаются теги с идентификаторами объектов, методы которых вызываются, внутри них - теги с именами методов (чувствительны к регистру), внутри которых теги с любыми названиями, содержащие аргументы в порядке, указанном в описании метода. Значения аргументов должны совпадать с типами свойств.
Содержимое данного тега обрабатывается после завершения загрузки всех клипов.
Пример вызова метода Init у объекта с id=Obj и двумя параметрами

<code class="xml">
<FLASH_METHOD>
 <Obj>
   <Init>
     <a1>0<a1>
     <a2>true</a2>
   </Init>
 </Obj>
</FLASH_METHOD>