fix SoftNcRunner GM code normalization.

2026-05-08 22:17:04 +08:00
parent 2f57932000
commit e026da61b3
197 changed files with 3482 additions and 958 deletions
@@ -154,11 +154,21 @@ Heidenhain: CYCL DEF 247 (Datum Preset) / CYCL DEF 7 (Datum Shift).
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.CsScript.html">CsScript</a></dt>
-      <dd></dd>
+      <dd><p>Section-key holder for inline C# scripts attached to an NC block. Carries
+<a class="xref" href="Hi.NcParsers.Keywords.CsScript.html#Hi_NcParsers_Keywords_CsScript_BeginScript">BeginScript</a> (run before the block's acts) and
+<a class="xref" href="Hi.NcParsers.Keywords.CsScript.html#Hi_NcParsers_Keywords_CsScript_EndScript">EndScript</a> (run after). Resolved by
+<a class="xref" href="Hi.NcParsers.Semantics.CsScriptBeginSemantic.html">CsScriptBeginSemantic</a> and
+<a class="xref" href="Hi.NcParsers.Semantics.CsScriptEndSemantic.html">CsScriptEndSemantic</a>.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.Dwell.html">Dwell</a></dt>
      <dd><p>Section key holder + concrete implementation for <a class="xref" href="Hi.NcParsers.Keywords.IDwellDef.html">IDwellDef</a>.</p>
+</dd>
+    </dl>
+    <dl class="jumplist">
+      <dt><a class="xref" href="Hi.NcParsers.Keywords.FanucPathSmoothing.html">FanucPathSmoothing</a></dt>
+      <dd><p>Section data holder for <a class="xref" href="Hi.NcParsers.Keywords.IFanucPathSmoothingDef.html">IFanucPathSmoothingDef</a>.</p>
 </dd>
    </dl>
    <dl class="jumplist">
@@ -168,7 +178,10 @@ Heidenhain: CYCL DEF 247 (Datum Preset) / CYCL DEF 7 (Datum Shift).
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IndexNote.html">IndexNote</a></dt>
-      <dd></dd>
+      <dd><p>JSON-section data shape pairing a single-character address symbol
+(e.g. <code>&lsquo;O&rsquo;</code>, <code>&lsquo;N&rsquo;</code>) with its numeric index, used to annotate
+program/sequence numbers on an NC block.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IsoLocalCoordinateOffset.html">IsoLocalCoordinateOffset</a></dt>
@@ -265,7 +278,8 @@ Not a comment — the controller uses it as a tape/file boundary marker.</p>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.ToolHeightCompensation.html">ToolHeightCompensation</a></dt>
-      <dd></dd>
+      <dd><p>Section key holder for <a class="xref" href="Hi.NcParsers.Keywords.IToolHeightCompensationDef.html">IToolHeightCompensationDef</a>.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.Unit.html">Unit</a></dt>
@@ -334,6 +348,25 @@ flood vs mist.
      <dd><p>Dwell/pause section definition for use inside Sequence items.
 Resolved by <span class="xref">Hi.NcParsers.Semantics.CompoundMotionSemanticUtil</span> into
 <a class="xref" href="Hi.Numerical.Acts.ActDelay.html">ActDelay</a>.</p>
+</dd>
+    </dl>
+    <dl class="jumplist">
+      <dt><a class="xref" href="Hi.NcParsers.Keywords.IFanucPathSmoothingDef.html">IFanucPathSmoothingDef</a></dt>
+      <dd><p>Fanuc-specific path smoothing state written by
+<a class="xref" href="Hi.NcParsers.LogicSyntaxs.FanucPathSmoothingSyntax.html">FanucPathSmoothingSyntax</a>.</p>
+<p>
+Extends <a class="xref" href="Hi.NcParsers.Keywords.IPathSmoothingDef.html">IPathSmoothingDef</a> with the Fanuc G05.1 R argument
+(precision / smoothness level number, R1..R10 mapping to controller-internal
+tuning macro variables). Q is binary in current Fanuc firmware (Q0 disable /
+Q1 enable), so <a class="xref" href="Hi.NcParsers.Keywords.IPathSmoothingDef.html#Hi_NcParsers_Keywords_IPathSmoothingDef_IsEnabled">IsEnabled</a> covers it directly
+— no raw Q field is stored.
+</p>
+<p>
+JSON section key remains <code>nameof(PathSmoothing)</code> so generic readers
+(cache dumps, modal carry, UI) can cast to <a class="xref" href="Hi.NcParsers.Keywords.IPathSmoothingDef.html">IPathSmoothingDef</a>
+across all controller brands; brand-specific readers cast to
+<a class="xref" href="Hi.NcParsers.Keywords.IFanucPathSmoothingDef.html">IFanucPathSmoothingDef</a> for the extra fields.
+</p>
 </dd>
    </dl>
    <dl class="jumplist">
@@ -348,7 +381,10 @@ Supported by all major CNC brands.
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IFlagsDef.html">IFlagsDef</a></dt>
-      <dd></dd>
+      <dd><p>JSON section schema describing the modal/non-modal flags that take effect
+on an NC block. Each entry in <a class="xref" href="Hi.NcParsers.Keywords.IFlagsDef.html#Hi_NcParsers_Keywords_IFlagsDef_Flags">Flags</a> is a brand-specific
+keyword recognized by the soft-NC runtime.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IMachineCoordinateStateDef.html">IMachineCoordinateStateDef</a></dt>
@@ -399,12 +435,18 @@ downstream <code>FindPrevious*</code> can resume motion-mode bookkeeping.
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html">IParsingDef</a></dt>
-      <dd></dd>
+      <dd><p>JSON section schema carrying the raw, brand-specific parsing trace for an
+NC block. The <a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers_Keywords_IParsingDef_Parsing">Parsing</a> node holds intermediate parser output
+used by downstream syntaxes and diagnostics.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IPathSmoothingDef.html">IPathSmoothingDef</a></dt>
-      <dd><p>Path smoothing state written by
-<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PathSmoothingSyntax.html">PathSmoothingSyntax</a>.</p>
+      <dd><p>Path smoothing state. The base interface is brand-agnostic; controller
+brands extend it with their own argument fields (e.g.
+<a class="xref" href="Hi.NcParsers.Keywords.IFanucPathSmoothingDef.html">IFanucPathSmoothingDef</a> for Fanuc G05.1 R precision-level).
+Fanuc-flavour writes are produced by
+<a class="xref" href="Hi.NcParsers.LogicSyntaxs.FanucPathSmoothingSyntax.html">FanucPathSmoothingSyntax</a>.</p>
 <p>
 ISO/Fanuc G05.1 Q1 (enable) / G05.1 Q0 (disable):
 high-precision contour control / AICC / Nano Smoothing.
@@ -467,7 +509,11 @@ semantic layers decide whether to actually pause.
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IProgramXyzDef.html">IProgramXyzDef</a></dt>
-      <dd></dd>
+      <dd><p>JSON section schema carrying the program-coordinate position commanded on
+the current block. Written by <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a>
+before the <a class="xref" href="Hi.NcParsers.Keywords.ITransformationDef.html#Hi_NcParsers_Keywords_ITransformationDef_ProgramToMcTransform">ProgramToMcTransform</a> chain
+composes it into machine coordinates.</p>
+</dd>
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IRadiusCompensationDef.html">IRadiusCompensationDef</a></dt>
@@ -577,7 +623,9 @@ program to metric before loading.
    </dl>
    <dl class="jumplist">
      <dt><a class="xref" href="Hi.NcParsers.Keywords.IUnparsedTextDef.html">IUnparsedTextDef</a></dt>
-      <dd></dd>
+      <dd><p>JSON section schema carrying the residual block text that was not consumed
+by any registered syntax. Used for diagnostics and round-trip preservation.</p>
+</dd>
    </dl>