Blink: highlight a state | Mingcedar Studio

<section id="blink-detail" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Colors</span> <h2>Blink: highlight a state</h2> <p>Use a boolean condition to alternate between Blink ON and Blink OFF appearances for alarm or warning indication. Enable FALSE to apply the static Condition FALSE appearance when the condition is false.</p> <div class="docs-detail-list"> <article id="blink-detail-item-1" class="docs-detail-row"> <strong>Overview</strong> <p>Blink Color is a Visual States behavior for fill, border, and visibility. With TRUE enabled, a true condition alternates Blink ON and Blink OFF. With FALSE enabled, a false condition applies Condition FALSE. Blink Color has no blink-interval setting. Use State Color for ordinary running/stopped indication and Range Color for numeric bands.</p> </article><article id="blink-detail-item-2" class="docs-detail-row"> <strong>Field configuration</strong> <p>Bind Blink Color and configure the fields below. The example Condition blinks when the alarm bit is true.</p> <ul> <li>Behavior Name: a recognizable name for this behavior (Component Name is read-only and filled in for you).</li><li>Setup Script: optional. Read tags, define variables, and compute intermediate values here for the Condition to use.</li><li>Condition: an expression returning true / false. Enter ReadTagBoolean(&quot;PLC_LINE01.PUMP01.ALARM&quot;, false) directly, or reference a boolean from Setup Script.</li><li>Action / Apply result: TRUE is enabled by default and FALSE is disabled. Enable FALSE and configure Condition FALSE for a static appearance after the alarm clears.</li><li>Output Channels: independently enable Fill Color, Border Color, and Visibility, in any combination.</li><li>Each enabled channel is configured across three columns: Blink ON, Blink OFF, and Condition FALSE - pick colors for fill/border, or visible/hidden for Visibility.</li><li>Quality Override: enable Follow data quality (border / hide) and configure Good and Bad. Enable Hide when quality is bad when the shape should be hidden on invalid data.</li> </ul> <pre class="docs-code-block"><code>// Setup Script

var alarm = ReadTagBoolean(&quot;PLC_LINE01.PUMP01.ALARM&quot;, false);

// Condition

alarm;</code></pre> </article><article id="blink-detail-item-3" class="docs-detail-row"> <strong>When to use it</strong> <p>Use it for binary states that need a prominent warning.</p> <ul> <li>Alarm lamp: blink the fill between red and dark red while the alarm bit is true; rest on a static gray after reset.</li><li>Run/warning block: blink the block while a device is faulted or needs action; keep a steady static color when normal.</li> </ul> </article><article id="blink-detail-item-4" class="docs-detail-row"> <strong>Limitations and troubleshooting</strong> <p>Check these configuration boundaries:</p> <ul> <li>Condition must return a boolean. Pass a literal Tag name to ReadTagBoolean; the name string itself is not an alarm state.</li><li>Blink Color has no Blink Interval or speed field.</li><li>Condition FALSE takes effect only with FALSE enabled. To show gray after an alarm clears, enable FALSE and Fill color and set the static color.</li><li>Quality Override represents data quality. On good quality, an explicit Border color takes precedence over Good. Bad quality restores the base appearance and applies the configured Bad border or visibility.</li> </ul> </article> </div> <div class="docs-note-grid"> <figure id="blink-detail-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current/color/blink.png" alt="Blink Color behavior editor" loading="lazy" decoding="async"> <figcaption> <strong>Blink Color editor</strong> <p>When the condition is true it toggles between Blink ON and Blink OFF; when false it rests on a static look, across fill, border, and visibility.</p> </figcaption> </figure> </div> </section>