This commit is contained in:
2026-09-09 17:35:23 +08:00
parent 2a98ae7556
commit 161af68fe3
1271 changed files with 58251 additions and 98639 deletions
@@ -96,7 +96,11 @@ Classes
</h3>
<dl class="jumplist">
<dt><a class="xref" href="Hi.Machining.MachiningEquipmentUtils.MachiningEquipment.html">MachiningEquipment</a></dt>
<dd><p>Machining Equipment. Include the machining chain, workpiece, tool and fixture, etc..</p>
<dd><p>The runtime (execution) face of the machining equipment: the topology
instance the runner drives — tool-change graph surgery, collision
detection, live axis poses. Materialised from the authored face
(<a class="xref" href="Hi.Machining.MachiningEquipmentUtils.SetupEquipment.html#Hi_Machining_MachiningEquipmentUtils_SetupEquipment_MaterialiseMachiningEquipment_System_String_System_IProgress_Hi_Common_Messages_IMessage__">MaterialiseMachiningEquipment(string, IProgress&lt;IMessage&gt;)</a>) and NEVER
serialized: runtime data cannot reach the project file by construction.</p>
</dd>
</dl>
<dl class="jumplist">
@@ -114,6 +118,20 @@ The adjacent solids will not be added to the <a class="xref" href="Hi.Collision.
<dl class="jumplist">
<dt><a class="xref" href="Hi.Machining.MachiningEquipmentUtils.MachiningEquipmentUtil.html">MachiningEquipmentUtil</a></dt>
<dd><p>Utility methods for working with machining equipment.</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.Machining.MachiningEquipmentUtils.SetupEquipment.html">SetupEquipment</a></dt>
<dd><p>The authored (setup) face of the machining equipment: the machine chain,
workpiece, fixture, environment data and the Setup-page tool selection,
with the project XML IO. This is the ONLY face that persists — the runtime
face (<a class="xref" href="Hi.Machining.MachiningEquipmentUtils.MachiningEquipment.html">MachiningEquipment</a>) is materialised from it and never
serialized, so a mid-run save can no longer write live poses or the
runner-equipped tool into the project file.</p>
<p>
The XML wire name stays <code>"MachiningEquipment"</code> (see <a class="xref" href="Hi.Machining.MachiningEquipmentUtils.SetupEquipment.html#Hi_Machining_MachiningEquipmentUtils_SetupEquipment_XName">XName</a>):
shipped project files keep their layout, only the deserialized object changed.
</p>
</dd>
</dl>
<h3 id="interfaces">
@@ -126,7 +144,10 @@ Interfaces
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.Machining.MachiningEquipmentUtils.IMachiningEquipment.html">IMachiningEquipment</a></dt>
<dd><p>Machining equipment.</p>
<dd><p>Machining equipment — implemented by both topology faces of the equipment
split: the authored <a class="xref" href="Hi.Machining.MachiningEquipmentUtils.SetupEquipment.html">SetupEquipment</a> and the runtime
<a class="xref" href="Hi.Machining.MachiningEquipmentUtils.MachiningEquipment.html">MachiningEquipment</a>. XML IO is NOT part of this contract —
only the authored face serializes.</p>
</dd>
</dl>
<h3 id="enums">