Measures

Measure - объект, извлекающий информацию, которая в последствии будет использована. Вместе с meter являются двумя составляющими скина.

Использование

В отличии от meters, сами по себе measure ничего не отображают. Вы не сможете «увидеть» measure в скине. Measures лишь предоставляет информацию, которая может быть использована следующими способами:

  • Meter может быть связан с measure. Таким образом meter будет отображать значения measure, в зависимости от своего типа. Это также затрагивает диапазон и размеры measure (если применимо)
  • Можно ссылаться на значения measure как раздел переменных. Это значит, что значение может быть использована почти в любом meter или параметре measure. Здесь значения используются «буквально», это значит, что оно не учитывает автоматически диапазон и размеры.
  • Measure может вызвать действие, когда значение переходит в определённый диапазон.

Некоторые типы measure могут иметь свои особые правила.

Формат

Measure записывается в скине как раздел. Все measures имеют параметр Measure, для определения определённого типа measure. Большинство параметров зависят от типа measure, но также есть общие параметры, коттрые действительны для всех типов measures.

Ниже приведён пример полностью рабочего measure:

1
2
3
4
[MeasureSectionName]
Measure=Clac
Formula=2+2
UpdateDivider=-1

Значения

Фактически measure принимает два вида значения: строковое (или «необработанный текст») и числовое (из можно использовать в формулах расчёта). В зависимости от типа measure, эти значения могут быть одинаковыми (или взаимозаменяемые) или абсолютно разными. В статьях по типам measure объясняется, что предусмотрено для числовых, а что для строковых значений.

  • Когда meter привязан к measure, тот автоматически использует правильное значение для своего типа.
  • Когда используется Раздел Переменных, используется другой синтаксис для ссылки на строковое или числовое значение measure.
  • Параметр Substitute (замена) влияет только на строковое значение данной measure.
  • Параметры IfAction используют только числовое значение данной measure.
  • Параметр Formula в measure Calc использует только числовые значения других measures, только если раздел переменных не используется.

Не смотря на то, что строковое значение не является «настоящим» числом, его можно использовать как число в формулах и параметрах, если она [строка] имеет только числовые символы и допустимые операторы. (Иначе она будет рассмотрена как «ноль») Аналогично, числовое значение может быть отображено и сохранено в переменной, как строка текста, хотя при этом может потеряться точность значения.

Проценты

Некоторые meters требуют от measure значение, которое можно использовать в виде процентах. Например, meters Bar, Histogram, Line, Rotator и Roundline. Для того, что бы meters знали, что текущее значение measure составляет, например, 27%, им нужно знать значение, которое определяеться как 100%. Кроме того, возможно, вы захотите отобразить процент от общего значения measure, принадлежащее meter String, или использовать процентное значение measure в формуле.

Процент от общей суммы, что отражает текущее значение measure, которое основано на «диапазоне» и может являться measure. Это определяется MinValue и MaxValue (минимальное и максимальное значения measure).