Product: Mingcedar Studio DESIGNER
Blink Color | Mingcedar Studio
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.
<div class="manual-doc-article manual-doc-article-section"><h2 id="blink-color">Colors: Blink Color</h2>
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.
<div class="doc-card-list">
<article class="doc-card">
<h3 id="blink-color-item-1">Overview</h3>
<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 class="doc-card">
<h3 id="blink-color-item-2">Field configuration</h3>
<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("PLC_LINE01.PUMP01.ALARM", 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>
<div class="manual-code" data-code-language="javascript"><div class="manual-code-toolbar"><span>JavaScript</span><span class="manual-code-tools"><small>JavaScript</small><button type="button" data-copy-code data-copied="Copied" data-failed="Select and copy the code" aria-label="Copy code: JavaScript">Copy code</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span style="color:#6A737D">// Setup Script</span></span>
<span class="line"><span style="color:#D73A49">var</span><span style="color:#24292E"> alarm </span><span style="color:#D73A49">=</span><span style="color:#6F42C1"> ReadTagBoolean</span><span style="color:#24292E">(</span><span style="color:#032F62">"PLC_LINE01.PUMP01.ALARM"</span><span style="color:#24292E">, </span><span style="color:#005CC5">false</span><span style="color:#24292E">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A737D">// Condition</span></span>
<span class="line"><span style="color:#24292E">alarm;</span></span></code></pre></div>
</article>
<article class="doc-card doc-card-warn">
<h3 id="blink-color-item-3">When to use it</h3>
<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 class="doc-card">
<h3 id="blink-color-item-4">Limitations and troubleshooting</h3>
<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 manual-doc-image-grid">
<figure class="docs-note-card manual-doc-image-card" id="blink-color-image-1">
<img src="/WEB_img/HQPPT/current/color/blink.png" alt="Blink Color behavior editor" loading="lazy" decoding="async" />
<figcaption>
<strong>Figure 1: 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>
</div>