Rotate: show direction through angles | Mingcedar Studio

<section id="rotate-detail" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Geometry</span> <h2>Rotate: show direction through angles</h2> <p>Rotate a component around a chosen pivot by an input angle, for pointers, valve plates and fan blades.</p> <div class="docs-detail-list"> <article id="rotate-detail-item-1" class="docs-detail-row"> <strong>Overview</strong> <p>Drag Geometry → Rotate onto the component. It applies the supplied angle directly without percentage mapping.</p> </article><article id="rotate-detail-item-2" class="docs-detail-row"> <strong>How to use it: every control in the editor</strong> <p>Rotation input returns an angle in degrees. Maximum angle defines a symmetric allowed range and PIVOT POINT sets the pivot. Rotate does not perform source-range percentage mapping.</p> <ul> <li>Behavior name is editable; Component name is read-only.</li><li>Override border by quality configures Good / Bad borders for data quality.</li><li>JS functions... inserts a method into the focused expression field.</li><li>Rotation input: an angle expression, such as ReadTagDouble(&quot;PLC_LINE01.VALVE01.ANGLE&quot;, 0).</li><li>Condition: a boolean; false skips rotation and does not hide the component.</li><li>Maximum angle defaults to 360. A value of 90 permits -90° to +90°. Preset buttons enter 45, 90, 180, 270, or 360.</li><li>PIVOT POINT: Center, Top, Bottom, Left, or Right, according to the mechanical pivot.</li><li>Hide outside angle range hides an out-of-range angle; otherwise the angle is clamped to the boundary.</li><li>Save / Ctrl+S validates and saves; Cancel / Esc discards the edit.</li> </ul> <pre class="docs-code-block"><code>// Rotation input

ReadTagDouble(&quot;PLC_LINE01.VALVE01.ANGLE&quot;, 0)

// Maximum angle: 90

// PIVOT POINT: Center</code></pre> </article><article id="rotate-detail-item-3" class="docs-detail-row"> <strong>When to use it</strong> <p>Use it for angle-driven motion, for example:</p> <ul> <li>Gauge pointer: read the angle for the pressure/temperature value and turn the needle around its center</li><li>Valve angle: rotate the valve icon by its opening angle, with the pivot on the real stem center</li><li>Fan / mixer blade: rotate the blade by its running angle to show motion</li> </ul> </article><article id="rotate-detail-item-4" class="docs-detail-row"> <strong>Limitations and troubleshooting</strong> <p>Check these limits:</p> <ul> <li>Rotation input uses degrees. Convert an opening percentage explicitly when the Tag is not an angle.</li><li>Match the pivot to the mechanical axis. Use Bottom for a bottom-hinged pointer and Center for a center-mounted component.</li><li>Angle presets only update Maximum angle, not Rotation input.</li><li>A false Condition only skips rotation. Use the hide option or a separate visibility behavior to control visibility.</li> </ul> </article> </div> <div class="docs-note-grid"> <figure id="rotate-detail-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/current/geometry/rotate.png" alt="Rotate behavior editor" loading="lazy" decoding="async"> <figcaption> <strong>Rotate editor</strong> <p>Apply an angle value to the component so it turns around the chosen pivot, with a max-rotation limit.</p> </figcaption> </figure> </div> </section>