Mingcedar Studio 使用手册

<div class="manual-doc-article"><h1 id="mingcedar-studio-使用手册">Mingcedar Studio 使用手册</h1>

<p>在 PowerPoint 中完成画面绘制、模板复用、实时数据绑定和交互配置，并导出给 Mingcedar 加载的 HTML / SVG / JS 画面包。</p>

<blockquote>

<p>Mingcedar Studio 操作手册：安装、页面设计、Tag 与变量、模板参数、行为配置及发布。</p>

</blockquote>

<h2 id="手册概览">手册概览</h2>

<ul>

<li>PowerPoint 组态插件</li>

<li>页面 / 模板 / 交互 / 导出</li>

<li>工程实施详细手册</li>

</ul>

<h2 id="关键信息">关键信息</h2>

<ul>

<li><strong>颜色 · 几何 · 交互 · 文本:</strong> 一套画面行为</li>

<li><strong>画面包格式:</strong> HTML / SVG / JS</li>

<li><strong>数据来源:</strong> Mingcedar 实时 Tag</li>

</ul>

<h2 id="按目标选择功能">按目标选择功能</h2>

<p>选择当前目标，查看对应功能和关键配置项。</p>

<div class="doc-goal-grid">

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 5a7 7 0 1 0 7 7h-3a4 4 0 1 1-4-4V5Z"></path><path d="M12 2v10h10"></path></svg></span>

<h3>根据水泵运行状态配置颜色</h3>

<span class="doc-goal-cat">颜色</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>State Color 状态颜色</dd></div>

<div><dt>为什么</dt><dd>用于运行和停止等两种状态的显示。</dd></div>

<div><dt>操作方式</dt><dd>Condition 填 ReadTagBoolean("PLC_LINE01.PUMP01.RUN", false)，再配置运行和停止颜色。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 7h16v10H4z"></path><path d="M8 7V4h8v3M8 20h8"></path></svg></span>

<h3>报警时让对象闪烁提示</h3>

<span class="doc-goal-cat">颜色</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Blink Color 闪烁</dd></div>

<div><dt>为什么</dt><dd>闪烁适合用于需要明显提示的报警状态。</dd></div>

<div><dt>操作方式</dt><dd>填写布尔条件，配置 Blink ON、Blink OFF；需要静止外观时启用 FALSE 并配置 Condition FALSE。Blink Color 不提供闪烁间隔配置。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M5 18V7l7-4 7 4v11l-7 4-7-4Z"></path><path d="M9 12h6M12 9v6"></path></svg></span>

<h3>按数值区间显示颜色</h3>

<span class="doc-goal-cat">颜色</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Range Color 区间颜色</dd></div>

<div><dt>为什么</dt><dd>数值连续变化时，用区间映射比多段条件更清晰。</dd></div>

<div><dt>操作方式</dt><dd>填写数值区间，并为每个区间配置颜色。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 17h16"></path><path d="m6 14 4-4 3 3 5-7"></path></svg></span>

<h3>显示实时数值或文字</h3>

<span class="doc-goal-cat">文本</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Tag Text 数值文本</dd></div>

<div><dt>为什么</dt><dd>显示单个 Tag 的当前值，并按需要配置前缀和单位。</dd></div>

<div><dt>操作方式</dt><dd>Target tag 可直接填完整 Tag 名称；动态名称和 = 写法见“变量、Tag 与模板参数”。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 5h16v12H4z"></path><path d="M9 21h6M12 17v4"></path></svg></span>

<h3>通过按钮向 PLC 写值</h3>

<span class="doc-goal-cat">交互</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Write Tag 写值</dd></div>

<div><dt>为什么</dt><dd>点击组件后将指定值写回 PLC，适用于按钮类操作。</dd></div>

<div><dt>操作方式</dt><dd>选择目标 Tag 和要写入的值；只写某一位时使用 Write Tag Bit。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M8 12h8M12 8v8"></path><path d="M4 12a4 4 0 0 1 4-4h1M20 12a4 4 0 0 1-4 4h-1"></path></svg></span>

<h3>制作弹窗或数字键盘</h3>

<span class="doc-goal-cat">功能</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>模板 Template</dd></div>

<div><dt>为什么</dt><dd>弹窗、键盘和表格适合通过模板复用。</dd></div>

<div><dt>操作方式</dt><dd>先制作带占位符的模板，再为每个实例填写模板参数。</dd></div>

</dl>

</article>

</div>

<h2 id="使用前说明">使用前说明</h2>

<p>本手册介绍在 PowerPoint 中制作工业画面、配置数据与交互，以及导出和发布的方法。初次使用请从“制作第一个画面”开始。</p>

<div class="doc-card-list">

<article class="doc-card">

<h3 id="preface-item-1">适用范围</h3>

<p>适用于画面设计人员、实施工程师和开发者。基础操作需要 Windows PowerPoint；运行验证需要 Mingcedar。高级脚本章节以具备基本 JavaScript 知识为前提。</p>

</article>

<article class="doc-card">

<h3 id="preface-item-2">示例约定</h3>

<p>菜单和字段保留界面的英文名称，路径中的 → 表示操作层级。代码区标明填写位置；英文引号、括号和变量大小写须保留。项目 Tag 名称应按实际配置替换。界面图可点击放大。</p>

</article>

</div>

<h2 id="tutorial">入门与进阶</h2>

先完成页面制作与发布，再配置真实数据和复用组件。各阶段的操作与验证见对应教程。

<div class="doc-card-list">

<article class="doc-card">

<h3>1. 安装与授权</h3>

<p>安装插件，确认 MX Design 菜单和授权状态，并准备 Mingcedar 运行环境。</p>

<ul class="doc-related-links">

<li><a href="/ppt/manual/windows-install/">安装说明</a></li>

</ul>

</article>

<article class="doc-card">

<h3>2. 制作并发布首个画面</h3>

<p>使用页面变量连接按钮、状态灯和文本；完成导出、文件发布、菜单配置与运行验证。无需 PLC。</p>

<ul class="doc-related-links">

<li><a href="/ppt/manual/first-screen/">首屏教程</a></li>

</ul>

</article>

<article class="doc-card">

<h3>3. 配置真实数据</h3>

<p>确认 Tag 的名称、类型、读取权限及质量，配置显示后对照平台数据验证。</p>

<ul class="doc-related-links">

<li><a href="/ppt/manual/text-tag-text/">Tag 文本显示</a></li>

</ul>

</article>

<article class="doc-card">

<h3>4. 复用组件与传递参数</h3>

<p>区分模板参数、页面变量和页面参数，继续学习输入框、表格、位写入和弹窗。</p>

<ul class="doc-related-links">

<li><a href="/ppt/manual/design-reuse-guide/">复用方式与参数类型</a></li>

</ul>

</article>

</div></div>