Примеры отображения значений¶

• Table of contents
• Примеры отображения значений
  • Отображение текста значения/времени
  • Отображение заполняющегося индикатора
  • Отображение Вкл/Выкл

Отображение текста значения/времени¶

Для отображения текста некоторого значения ValueServer необходимо в конфигурации клипа в теге добавить тег вызова метода VSString клипа Main. Приведен пример настройки отображения названия и артиста из первого эл-та очереди, разделенных тремя пробелами. Артист указывается в скобках.
Второй пример - отсчет времени воспроизведения.

Порядок указания параметров важен!

<Main>
    <VSString>
        <Clip>E1</Clip>     
        <Value>XA.queue</Value>
        <Pattern><![CDATA[{name}   {art}]]></Pattern>       
        <Var>name=ELEM_0/Elem/FONO_INFO/FONO_STRING_INFO/Name</Var>
        <Var>art=ELEM_0/Elem/FONO_INFO/FONO_STRING_INFO/Artist,,,(%s)</Var>
    </VSString> 

    <VSString>
        <Clip>TimeText1</Clip> 
        <Value>XA.progress.0</Value>
        <Pattern>{runt}</Pattern>       
        <Var>runt=Position,sec_float,MM:SS.f</Var>
    </VSString> 
</Main>

• Clip - ID клипа, в котором собственно все это будет отображаться. Он должен быть создано ранее в теге . Клип должен поддерживать установку текста. Это может быть клип типа (class):
  • flash.text.TextField
  • TextBox
  • или любой клип из файла, у которого есть публичный метод SetHtmlText или член htmlText.
• Value - значение из ValueServer, которое служит источником информации. Его название зависит от настройки источника, и должно быть известно.
• Pattern - формат строчки, собирающий ее из нескольких именованных переменных, описанных ниже. В тексте шаблона {xxx} заменяется на фактическое значение переменной. Тег CDATA позволяет использовать символы, запрещенные для XML.
• Var - одно или более именованное значение, формируемое из узлов значения Сервера значений. строка состоит из нескольких частей, разделенных запятыми. Обязательной является только первая часть, до первой запятой.
  1. name=XPath - описывает путь к части значения в его XML структуре. Его надо знать. Если других параметров нет - то значение тега будет просто подставлено, как есть.
  2. тип значения, может быть:
     • пустой - строка, как есть
     • sec_float - число с плавающей запятой, представляющее собой время в секундах
     • sec1000 - целое число, миллисекунды
     • sec100 - целое число, сотые
     • sec10 - целое число, десятые
  3. шаблон формата значения. Он зависит от предыдущего типа. Сейчас есть возможность для любого времени указать шаблон вида
     HH:MM:SS.f. Для других типов - пустой.
  4. декоратор. Применим к любым значениям. Содержит произвольный текст, в котором %s заменяется на отформатированное значение. Но, только если оно не является пустой строкой. Пустая строка всегда остается пустой, на нее декоратор не влияет.

Отображение заполняющегося индикатора¶

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

Порядок указания параметров важен!

    <VSTimer>
        <Clip>Prog1</Clip>  
        <Value>XA.progress.0</Value>
    </VSTimer>

• Clip - ID клипа, в котором собственно все это будет отображаться. Он должен быть создан ранее в теге . Клип должен поддерживать отображение прогресса. Стандартно - это клип типа BarProgress. Обычно, находится под другими клипами, играя роль заполняющегося фона.
• Value - значение из ValueServer, которое служит источником информации. Его название зависит от настройки источника, и должно быть известно. В данном случае это значение отображает таймер.

Отображение Вкл/Выкл¶

Позволяет графически отобразить факт наступления некоего события подсветкой надписи или других клипов. Реагирует на смену значения на сервере значений. Настройка очень похожа на отображение значений VSString, т.к. логика работы состоит в сравнении строки, формируемой из некоего значения, с образцом или на соответствие регулярному выражению. Возможно инвертирование результата проверки.
Следующий пример отображается с подсветкой, если артист, указанный во втором эл-те очереди плеера не является Пламя.

Порядок указания параметров важен!

<Main>
    <VSLamp>
        <Clip>E2</Clip>     
        <Value>XA.queue</Value>
        <Pattern>{art}</Pattern>        
        <Test>!Пламя</Test>             
        <Var>art=ELEM_1/Elem/FONO_INFO/FONO_STRING_INFO/Artist</Var>
    </VSLamp>   
</Main>

За исключением четвертого параметра Test назначение остальных соответствует настройке отображаемого значения VSString.

• Clip - ID клипа, в котором собственно все это будет отображаться. Он должен быть создан ранее в теге . Клип должен поддерживать отображение состояния включен/выключен. Стандартно - это клип типа TextBox. Обычно, находится под другими клипами, играя роль заполняющегося фона.
• Value - значение из ValueServer, которое служит источником информации. Его название зависит от настройки источника, и должно быть известно.
• Pattern - формат строчки, см. описание VSString
• Test - тестовая строка. Если сформированное по шпблону значение совпадает с ней - клип переходит в состояние Включено. Возможны варианты:
  • просто строка
    <Test>Пламя</Test>
  • регулярное выражение flash. В этой ситуации значение ограничено косыми чертами /. Синтаксис тут
    <Test>/[abc]+/</Test>
  • отрицание строки или выражения - указание первым символом восклицательного знака !. В этой ситуации клип перейдет в состояние Включено, если строка не соответствует указанному условию.
    <Test>!Пламя</Test>
<Test>!/[abc]+/</Test>
• Var - формат строчки, см. описание VSString

Клип не отображает на себе текст, формируемый указанным шаблоном, а просто сравнивает его с тестом.