deploy webservice static-file routing for docsite folder URLs, per-instance step-cache db, and constant-height panel title bars.

This commit is contained in:
2026-08-27 14:51:37 +08:00
parent 1fc510af5e
commit 2a98ae7556
1468 changed files with 182837 additions and 18888 deletions
@@ -175,6 +175,57 @@ Must be placed before <a class="xref" href="Hi.NcParsers.LogicSyntaxs.LinearMoti
syntax chain. Both share the Group 01 motion slot; whichever
writes a <a class="xref" href="Hi.NcParsers.Keywords.MotionEvent.html">MotionEvent</a> first claims it.
</p>
<p>
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.CircularMotionSyntax.html#Hi_NcParsers_LogicSyntaxs_CircularMotionSyntax_IsIjkAbsolute">IsIjkAbsolute</a> switches the I/J/K reading to absolute
center coordinates (Heidenhain DIN/ISO — the ISO twin of the
Klartext CC pole; the Heidenhain list sets it, every other brand
keeps the offset default). In that mode the center is modal: letters
not written in a block inherit the previous absolute pole
(<a class="xref" href="Hi.NcParsers.LogicSyntaxs.CircularMotionSyntax.html#Hi_NcParsers_LogicSyntaxs_CircularMotionSyntax_AbsoluteIjkPoleKey">AbsoluteIjkPoleKey</a>, carried by the brand's
<a class="xref" href="Hi.NcParsers.PostLogicSyntaxs.ModalCarrySyntax.html">ModalCarrySyntax</a>), a letter never
written falls back to the arc start's component, a letters-free
block that commands an endpoint continues the modal arc off the
pole (a flags-only block stays motionless), a G91 block reads
offsets again and breaks the pole chain, and the plane-normal letter
is a center coordinate — never the per-turn helix pitch. Behavior
mirrors <code>HardNcLine.BuildArcNcArg</code> +
<code>ArcNcArg.GetCenterOrCenterOnBeginPlane</code> (HiUniNc 3.1.152.2)
bit for bit.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.CodedPositionUtil.html">CodedPositionUtil</a></dt>
<dd><p>Shared coded-position resolution for the write-stage consumers
(<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a> for rotary words,
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IncrementalResolveSyntax.html">IncrementalResolveSyntax</a> for linear words): turns a
per-word <a class="xref" href="Hi.NcParsers.Keywords.PositioningOverride.html">PositioningOverride</a> entry of the coded family
(<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedAbsolute">CodedAbsolute</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedIncremental">CodedIncremental</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedShortest">CodedShortest</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedPositiveOnly">CodedPositiveOnly</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedNegativeOnly">CodedNegativeOnly</a> — stamped by
<a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.Siemens.SiemensAcIcSyntax.html">SiemensAcIcSyntax</a> for
<code>CAC()</code>/<code>CIC()</code>/<code>CDC()</code>/<code>CACP()</code>/<code>CACN()</code>)
plus the evaluated position number into an axis coordinate via
<a class="xref" href="Hi.NcParsers.Dependencys.IIndexingPositionConfig.html">IIndexingPositionConfig</a>, and names the plain override
value the caller rewrites the entry to — so the
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a> tail-pass and every other
downstream reader only ever see the established non-coded vocabulary.</p>
<p>
Failure semantics mirror the Siemens alarms as far as a simulator can:
an invalid position number (alarm 17510) or a missing table reports an
error diagnostic and resolves to "hold" — the caller writes the anchor
so the axis does not move. <code>CIC(0)</code> also resolves to hold, by
specification ("the indexing axis is not traversed") and silently.
A <code>CIC</code> from between two indexing positions advances to the n-th
next position in the programmed direction. On a cyclic indexing axis
the incremental sign becomes a directional
(<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_PositiveOnly">PositiveOnly</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_NegativeOnly">NegativeOnly</a>) approach; increments spanning
more than one revolution reach the correct position but collapse the
extra full turns (the tail-pass windows cover one revolution).
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -210,6 +261,48 @@ G91 conversion, missing-axis fallback) before this syntax runs.
Must be placed after <a class="xref" href="Hi.NcParsers.LogicSyntaxs.CannedCycleResolveSyntax.html">CannedCycleResolveSyntax</a> and before
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IncrementalResolveSyntax.html">IncrementalResolveSyntax</a> in the syntax chain.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.DwellSyntax.html">DwellSyntax</a></dt>
<dd><p>Consumes the non-modal G4/G04 dwell sub-section captured by
<a class="xref" href="Hi.NcParsers.Syntaxs.GenericSyntaxKit.html#Hi_NcParsers_Syntaxs_GenericSyntaxKit_G4Syntax">G4Syntax</a>
(<code>Parsing.G4</code> / <code>Parsing.G04</code>) and emits a
<a class="xref" href="Hi.NcParsers.Keywords.CompoundMotion.html">CompoundMotion</a> with a single <a class="xref" href="Hi.NcParsers.Keywords.Dwell.html">Dwell</a> item,
which <span class="xref">Hi.NcParsers.Semantics.CompoundMotionSemanticUtil</span> resolves into
an <a class="xref" href="Hi.Numerical.Acts.ActDelay.html">ActDelay</a> of the dwell duration.</p>
<p>
Argument dialects are configured per brand preset:
</p>
<ul><li>Fanuc-family default — <a class="xref" href="Hi.NcParsers.LogicSyntaxs.DwellSyntax.html#Hi_NcParsers_LogicSyntaxs_DwellSyntax_SecondsPrefixes">SecondsPrefixes</a> =
<code>X</code>/<code>U</code> (seconds), <a class="xref" href="Hi.NcParsers.LogicSyntaxs.DwellSyntax.html#Hi_NcParsers_LogicSyntaxs_DwellSyntax_MillisecondsPrefixes">MillisecondsPrefixes</a> =
<code>P</code> (milliseconds), <a class="xref" href="Hi.NcParsers.LogicSyntaxs.DwellSyntax.html#Hi_NcParsers_LogicSyntaxs_DwellSyntax_SpindleRevPrefixes">SpindleRevPrefixes</a> = <code>S</code>
(spindle revolutions).</li><li>Siemens — <code>G4 F&lt;seconds&gt;</code> / <code>G4 S&lt;revolutions&gt;</code>:
the preset sets <a class="xref" href="Hi.NcParsers.LogicSyntaxs.DwellSyntax.html#Hi_NcParsers_LogicSyntaxs_DwellSyntax_SecondsPrefixes">SecondsPrefixes</a> = <code>F</code>, clears the
milliseconds list, keeps <code>S</code> revolutions.</li></ul>
<p>
Because the capture layer owns the whole argument (the F/X/P word
lands inside the dwell sub-section, never in <code>Parsing.F</code> /
<code>Parsing.X</code>), a dwell block cannot poison the modal
<a class="xref" href="Hi.NcParsers.Keywords.Feedrate.html">Feedrate</a> and its X-word cannot mint a ghost motion —
structural fixes for the <code>G04 F60000</code> feed-poison and
<code>G04 X0.5</code> ghost-motion hazards.
</p>
<p>
Spindle-revolution dwell needs the modal spindle speed: this syntax
must be placed after <a class="xref" href="Hi.NcParsers.LogicSyntaxs.SpindleSpeedSyntax.html">SpindleSpeedSyntax</a> in the Logic
bundle so the block's own modal <a class="xref" href="Hi.NcParsers.Keywords.SpindleSpeed.html">SpindleSpeed</a> section is
already written. When no positive rpm is known the dwell is consumed
and recorded via an Unsupported Message (<code>Dwell--SpindleRevUnresolved</code>)
instead of being time-simulated — no act is emitted.
</p>
<p>
When several recognized argument prefixes appear on one block the
resolution priority is seconds → milliseconds → revolutions; every
recognized key is consumed either way. Unrecognized keys inside the
sub-section are left in place so they surface through
<a class="xref" href="Hi.NcParsers.InspectionSyntaxs.UnconsumedCheckSyntax.html">UnconsumedCheckSyntax</a>.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -334,6 +427,32 @@ within <a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers
Reads <a class="xref" href="Hi.NcParsers.Keywords.IPositioningDef.html#Hi_NcParsers_Keywords_IPositioningDef_Term">Term</a> written
by <a class="xref" href="Hi.NcParsers.LogicSyntaxs.PositioningSyntax.html">PositioningSyntax</a>.</p>
<p>
Per-word override: a block-root
<a class="xref" href="Hi.NcParsers.Keywords.PositioningOverride.html">PositioningOverride</a> section (written by
<a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.Siemens.SiemensAcIcSyntax.html">SiemensAcIcSyntax</a> for the
Siemens per-word coordinate functions) beats the modal
term for the listed axes on this block only: an
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Incremental">Incremental</a> entry converts that word even
under G90, an <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Absolute">Absolute</a> entry skips it even
under G91 — as does, deliberately, every other non-Incremental value
(the rotary-family <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Shortest">Shortest</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_PositiveOnly">PositiveOnly</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_NegativeOnly">NegativeOnly</a> entries are absolute targets;
their swing resolution lives in <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a>,
not here). A coded-position entry
(<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedAbsolute">CodedAbsolute</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_CodedIncremental">CodedIncremental</a> — Siemens
<code>CAC()</code>/<code>CIC()</code> on a linear indexing axis) carries an
indexing position <b>number</b> instead of a coordinate: the number
is resolved through <a class="xref" href="Hi.NcParsers.Dependencys.IIndexingPositionConfig.html">IIndexingPositionConfig</a>
via <a class="xref" href="Hi.NcParsers.LogicSyntaxs.CodedPositionUtil.html#Hi_NcParsers_LogicSyntaxs_CodedPositionUtil_TryResolveCodedTarget_Hi_NcParsers_Dependencys_IIndexingPositionConfig_System_String_System_String_System_Double_System_Double_Hi_NcParsers_ISentenceCarrier_Hi_NcParsers_NcDiagnosticProgress_System_Double__System_String__">TryResolveCodedTarget(IIndexingPositionConfig, string, string, double, double, ISentenceCarrier, NcDiagnosticProgress, out double, out string)</a>, the word
is rewritten to the resolved absolute coordinate, and the entry to
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Absolute">Absolute</a>; a failed resolve reports an error
and holds the last program position. Axes without an entry follow the
modal term unchanged, so brands that never write the section
(Fanuc/Heidenhain/...) keep the exact legacy behavior.
</p>
<p>
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IncrementalResolveSyntax.html#Hi_NcParsers_LogicSyntaxs_IncrementalResolveSyntax_WorkingPathList">WorkingPathList</a> specifies which JSON paths
contain axis values that need incremental-to-absolute conversion.
Default: <code>[["Parsing"], ["Parsing", "G28"]]</code>.
@@ -423,19 +542,72 @@ XYZ-only and XYZABC motion by checking whether rotary axis values
are present in <a class="xref" href="Hi.NcParsers.Keywords.MachineCoordinateState.html">MachineCoordinateState</a>.
</p>
Must be placed after <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a> in the syntax chain.
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.MCodeExpansionSyntax.html">MCodeExpansionSyntax</a></dt>
<dd><p>Expands machine-declared M-codes (<a class="xref" href="Hi.NcParsers.Dependencys.IMCodeDeclarationConfig.html">IMCodeDeclarationConfig</a>
on the controller parameter table) into the canonical ISO flags the
regular consumers already understand: tool change → <code>M06</code>, spindle
direction → <code>M03</code>/<code>M04</code>/<code>M05</code>, coolant →
<code>M07</code>/<code>M08</code>/<code>M09</code>. Must run ahead of
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.SpindleSpeedSyntax.html">SpindleSpeedSyntax</a>, <a class="xref" href="Hi.NcParsers.LogicSyntaxs.CoolantSyntax.html">CoolantSyntax</a>, and
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html">ToolChangeSyntax</a> — expanding early is what lets one
composite OEM code (e.g. <code>M13</code> = spindle CW + flood coolant) feed
several downstream consumers without any of them fighting over who
removes the original flag. Same rewrite-into-shared-vocabulary pattern
as <a class="xref" href="Hi.NcParsers.LogicSyntaxs.Heidenhain.HeidenhainRadiusCompSyntax.html">HeidenhainRadiusCompSyntax</a> (RL/RR/R0 →
G41/G42/G40).</p>
<p>
Two deliberate boundaries keep the rewrite faithful. Declarations whose
sole content is a spindle direction
(<a class="xref" href="Hi.NcParsers.Dependencys.MCodeEffects.html#Hi_NcParsers_Dependencys_MCodeEffects_IsSpindleDirectionOnly">IsSpindleDirectionOnly</a>) are NOT expanded —
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.SpindleSpeedSyntax.html">SpindleSpeedSyntax</a> resolves them in place via
<a class="xref" href="Hi.NcParsers.Dependencys.ISpindleControlConfig.html#Hi_NcParsers_Dependencys_ISpindleControlConfig_TryResolveDirection_System_String_Hi_Numerical_SpindleDirection__">TryResolveDirection(string, out SpindleDirection)</a>, which keeps
legacy <code>&lt;SpindleMCode&gt;</code> configs bit-identical and avoids the
expansion product being re-translated by that same custom-first map
(e.g. a mirrored M03↔M04 remap would otherwise flip direction).
Expansion codes are inserted at the declared flag's own position, and a
code whose raw twin also appears un-declared elsewhere in the block is
not emitted — the block's textual order keeps deciding last-wins
conflicts exactly as it did before.
</p>
<p>
Declared-but-unmodeled behavior stays loud: a declaration carrying an
<a class="xref" href="Hi.NcParsers.Dependencys.MCodeEffects.html#Hi_NcParsers_Dependencys_MCodeEffects_UnmodeledNote">UnmodeledNote</a> emits one
<code>DeclaredMCode--UnmodeledEffects</code> informational diagnostic per
occurrence — a declaration replaces the raw <code>Parsing--Unconsumed</code>
warning with an explanation, never with silence. A declaration with no
effects and no note consumes its code silently by explicit intent.
Undeclared codes are untouched and keep falling through to
<a class="xref" href="Hi.NcParsers.InspectionSyntaxs.UnconsumedCheckSyntax.html">UnconsumedCheckSyntax</a>.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.MachineCoordSelectSyntax.html">MachineCoordSelectSyntax</a></dt>
<dd><p>Handles G53 (machine coordinate selection) — non-modal, one-shot.
<dd><p>Handles machine coordinate selection — non-modal, one-shot.
The axis values (X/Y/Z) in the block are interpreted as machine
coordinates, bypassing all work offsets, local coordinates,
tool height compensation, and coordinate rotations.
If G91 (incremental) is active, G53 is ignored per ISO standard.</p>
If G91 (incremental) is active, the code is ignored per ISO standard.</p>
<p>
Defaults to ISO <code>G53</code>. Brands with additional one-shot
machine-coordinate codes widen <a class="xref" href="Hi.NcParsers.LogicSyntaxs.MachineCoordSelectSyntax.html#Hi_NcParsers_LogicSyntaxs_MachineCoordSelectSyntax_SupportedCodes">SupportedCodes</a> — the
Siemens preset adds <code>G153</code> and <code>SUPA</code> (both suppress every
active frame for one block; in this pipeline all of those reduce to
"bypass the composed <a class="xref" href="Hi.NcParsers.Keywords.ITransformationDef.html#Hi_NcParsers_Keywords_ITransformationDef_ProgramToMcTransform">ProgramToMcTransform</a>",
which the ProgramXyz back-derivation below already models). The
matched code is stamped verbatim into
<a class="xref" href="Hi.NcParsers.Keywords.IMotionEventDef.html#Hi_NcParsers_Keywords_IMotionEventDef_Term">Term</a> for bidirectional source recovery.
Rotary words on the same block (e.g. <code>SUPA G0 B0</code>) are left to
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a> — same behavior as ISO G53, where rotary
axes flow through the normal rotary path.
</p>
<p>
Must be placed <b>before</b> <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a> in the
syntax chain. When G53 is active, this syntax consumes X/Y/Z from
<a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers_Keywords_IParsingDef_Parsing">Parsing</a> and writes
syntax chain. When a supported code is active, this syntax consumes
X/Y/Z from <a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers_Keywords_IParsingDef_Parsing">Parsing</a> and writes
<a class="xref" href="Hi.NcParsers.Keywords.IMachineCoordinateStateDef.html#Hi_NcParsers_Keywords_IMachineCoordinateStateDef_MachineCoordinateState">MachineCoordinateState</a> directly,
preventing <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a> from processing them
as program coordinates.
@@ -461,6 +633,32 @@ The items pass enables rotary motion (e.g. G28 ABC intermediate /
home stages) to surface as motion <a class="xref" href="Hi.Numerical.Acts.IAct.html">IAct</a>
segments rather than a single root-MC stamp.
<p>
Per-word directional override: a block-root
<a class="xref" href="Hi.NcParsers.Keywords.PositioningOverride.html">PositioningOverride</a> entry (stamped by
<a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.Siemens.SiemensAcIcSyntax.html">SiemensAcIcSyntax</a>) valued
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_PositiveOnly">PositiveOnly</a> (Siemens <code>ACP()</code>) or
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_NegativeOnly">NegativeOnly</a> (<code>ACN()</code>) swaps that
axis's window for this block only: [anchor, anchor+360°) /
(anchor-360°, anchor] instead of the default ±180° — the approach
direction is forced even when it is the longer way around. A target
congruent with the anchor (within an ULP-scale epsilon) keeps the
anchor value verbatim — no move, never a spurious full turn, and no
deg→rad→deg drift. <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Shortest">Shortest</a> (<code>DC()</code>)
is the default window and needs no special path here. The override
is read from the current block only (it is one-shot, never carried —
deliberately unlike the modal <code>RotaryWrap</code> gate's one-step
previous fallback) and applies to the root MC stage only, not to
<a class="xref" href="Hi.NcParsers.Keywords.CompoundMotion.html">CompoundMotion</a> items (G28/G74/G75 expansions capture
their words in sub-objects the stamping syntax never sees, so an
override can only ever describe a root word). Directional/shortest
entries keyed by an axis outside the modular set are reported as
<code>Coord-McAbc--003</code> — the promise cannot be honored there and
silence would mis-read the program's intent; an entry with no anchor
to resolve against (first rotary value in the stream) is reported as
<code>Coord-McAbc--004</code> and adopted unwrapped, matching the default
path.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -493,6 +691,46 @@ unless the current section already has the value
Values are stored in degrees (matching <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a>).
</p>
<p>
Per-word override: a block-root
<a class="xref" href="Hi.NcParsers.Keywords.PositioningOverride.html">PositioningOverride</a> section (written by
<a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.Siemens.SiemensAcIcSyntax.html">SiemensAcIcSyntax</a> for the
Siemens <code>AC()</code>/<code>IC()</code> coordinate functions) marks a rotary
word <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Incremental">Incremental</a>: the parsed value is then
added to the previous modal value of that axis (previous
<code>MachineCoordinateState</code> lookback, falling back to a value
already present in the current section, then 0) instead of being
written as an absolute angle. The accumulated raw degrees stay
monotonic across iterations — each per-block step is well inside the
±180° window, so the <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a> tail-pass
keeps it as net rotation instead of re-normalizing it away. An
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Absolute">Absolute</a> entry (from <code>AC()</code>) matches
the default write and needs no special path — and so, deliberately,
do the rotary-family entries <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Shortest">Shortest</a>
(<code>DC()</code>) / <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_PositiveOnly">PositiveOnly</a>
(<code>ACP()</code>) / <a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_NegativeOnly">NegativeOnly</a>
(<code>ACN()</code>): this syntax writes the raw absolute target and the
shortest/directional swing is resolved by the
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a> tail-pass, which owns the wrap
math. Brands that never write the section keep the exact legacy
behavior.
</p>
<p>
Coded-position overrides (Siemens
<code>CAC()</code>/<code>CIC()</code>/<code>CDC()</code>/<code>CACP()</code>/<code>CACN()</code>)
carry an indexing position <b>number</b> instead of an angle: the
number is resolved through <a class="xref" href="Hi.NcParsers.Dependencys.IIndexingPositionConfig.html">IIndexingPositionConfig</a> via
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.CodedPositionUtil.html#Hi_NcParsers_LogicSyntaxs_CodedPositionUtil_TryResolveCodedTarget_Hi_NcParsers_Dependencys_IIndexingPositionConfig_System_String_System_String_System_Double_System_Double_Hi_NcParsers_ISentenceCarrier_Hi_NcParsers_NcDiagnosticProgress_System_Double__System_String__">TryResolveCodedTarget(IIndexingPositionConfig, string, string, double, double, ISentenceCarrier, NcDiagnosticProgress, out double, out string)</a> and the override
entry is rewritten to the plain vocabulary
(<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Absolute">Absolute</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_Shortest">Shortest</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_PositiveOnly">PositiveOnly</a> /
<a class="xref" href="Hi.NcParsers.Keywords.Positioning.html#Hi_NcParsers_Keywords_Positioning_NegativeOnly">NegativeOnly</a> — a cyclic <code>CIC</code> keeps
its programmed direction through the directional values) before the
tail-pass runs, so the tail-pass never sees a coded value. A failed
resolve (invalid number, missing table) reports an error and holds
the axis at its previous value.
</p>
<p>
Must be placed <b>before</b> <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McXyzSyntax.html">McXyzSyntax</a> so syntaxes
that need the current-block ABC to compute transforms
(e.g. <a class="xref" href="Hi.NcParsers.LogicSyntaxs.G43p4RtcpSyntax.html">G43p4RtcpSyntax</a>) can see it; and <b>before</b>
@@ -582,36 +820,54 @@ G91 conversion, missing-axis fallback) before this syntax runs.
Must be placed after <a class="xref" href="Hi.NcParsers.LogicSyntaxs.CannedCycleResolveSyntax.html">CannedCycleResolveSyntax</a> and before
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IncrementalResolveSyntax.html">IncrementalResolveSyntax</a> in the syntax chain.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.PivotTransformUtil.html">PivotTransformUtil</a></dt>
<dd><p>Shared engine for the brand pivot-gate syntaxes
(<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PivotTransformationSyntax.html">PivotTransformationSyntax</a> — ISO/Fanuc family,
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.Siemens.SiemensPivotTransformationSyntax.html">SiemensPivotTransformationSyntax</a> — Siemens).
Each brand syntax owns only its gate (which modal terms mean
&ldquo;commanded XYZ needs the Pn→MC kinematic rigid transform&rdquo;); the
endpoint-ABC resolution and the <code>PivotTransform</code> chain entry
composition live here so every brand writes the identical JSON
vocabulary.</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.PivotTransformationSyntax.html">PivotTransformationSyntax</a></dt>
<dd><p>Writes the <a class="xref" href="Hi.NcParsers.Syntaxs.TransformationUtil.html#Hi_NcParsers_Syntaxs_TransformationUtil_PivotTransformSource">PivotTransformSource</a> entry
into <a class="xref" href="Hi.NcParsers.Keywords.ITransformationDef.html#Hi_NcParsers_Keywords_ITransformationDef_ProgramToMcTransform">ProgramToMcTransform</a>
on <b>every block</b>, capturing the Pn→MC kinematic rigid transform
for the block's endpoint rotary state. Mirrors legacy
<code>HardNcLine.GetProgramXyz</code>'s use of
<a class="xref" href="Hi.Numerical.Xyzabc.IMachineKinematics.html#Hi_Numerical_Xyzabc_IMachineKinematics_McToPn_Hi_Geom_DVec3d_">McToPn(DVec3d)</a> — without this entry, the
transform chain would miss the rotary rotation on any block whose
<code>MachineCoordinate.ABC</code> is non-zero, and <code>McXyzSyntax</code> (and
<code>ProgramXyzSyntax</code>'s inverse lookback) would silently drift.</p>
<dd><p>ISO/Fanuc-family pivot gate: writes the
<a class="xref" href="Hi.NcParsers.Syntaxs.TransformationUtil.html#Hi_NcParsers_Syntaxs_TransformationUtil_PivotTransformSource">PivotTransformSource</a> entry
into <a class="xref" href="Hi.NcParsers.Keywords.ITransformationDef.html#Hi_NcParsers_Keywords_ITransformationDef_ProgramToMcTransform">ProgramToMcTransform</a> on blocks
where the controller is interpreting commanded XYZ in a frame that
needs the Pn→MC kinematic rigid transform — namely active RTCP
(G43.4) or active tilted plane (G68/G68.2). On plain-mode blocks
(no RTCP, no tilted plane), the controller treats commanded XYZ as
machine-frame directly, so the indexed rotary angle is a positioning
value only and must <b>not</b> fold into the linear axes; this
syntax skips those blocks and leaves the chain at identity (or
whatever non-kinematic offsets earlier syntaxes contributed).
Brand variants with their own modal vocabulary gate the same shared
engine (<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PivotTransformUtil.html">PivotTransformUtil</a>): Siemens TRAORI/CYCLE800 →
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.Siemens.SiemensPivotTransformationSyntax.html">SiemensPivotTransformationSyntax</a>; Heidenhain
M128/PLANE SPATIAL would follow the same pattern.</p>
<p>
Scope is <b>not</b> limited to RTCP modal: as long as rotary axes are
physically at a non-zero position (e.g. after a non-RTCP <code>G00 B90</code>
plus any subsequent motion), the kinematic chain still contributes a
non-identity rigid transform that must appear in the endpoint chain.
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.G43p4RtcpSyntax.html">G43p4RtcpSyntax</a> is orthogonal and only governs the
dynamic-rotary <a class="xref" href="Hi.NcParsers.Syntaxs.TransformationUtil.html#Hi_NcParsers_Syntaxs_TransformationUtil_KindKey">KindKey</a> tagging used by
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.LinearMotionSyntax.html">LinearMotionSyntax</a> to pick the motion form.
Mirrors real Fanuc semantics: plain G43 offsets along the active
tilted-plane normal (or machine Z when no tilt is active), and
plain XYZ moves map directly to machine axis registers regardless
of indexed table/head rotary position. Only G43.4 follows the live
tool vector and only G68.2 redefines the work-plane orientation —
both of which this guard detects via the existing chain markers.
</p>
<p>
Chain position: must run <b>after</b> all Pn-frame writers
(<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IsoG68p2TiltSyntax.html">IsoG68p2TiltSyntax</a>, <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolHeightOffsetSyntax.html">ToolHeightOffsetSyntax</a>,
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.G43p4RtcpSyntax.html">G43p4RtcpSyntax</a>, <a class="xref" href="Hi.NcParsers.LogicSyntaxs.IsoCoordinateOffsetSyntax.html">IsoCoordinateOffsetSyntax</a>,
brand-specific coord offset syntaxes) so the <code>PivotTransform</code>
entry naturally lands as the <b>last</b> chain element. Must run
<b>before</b> <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McXyzSyntax.html">McXyzSyntax</a> / <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a>
so they see the completed chain.
brand-specific coord offset syntaxes) so the guard sees the
finalised mode markers and the <code>PivotTransform</code> entry — when
emitted — naturally lands as the <b>last</b> chain element. Must
run <b>before</b> <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McXyzSyntax.html">McXyzSyntax</a> /
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a> so they see the completed chain.
</p>
<p>
Silently no-ops when <a class="xref" href="Hi.Numerical.Xyzabc.IMachineKinematics.html">IMachineKinematics</a> is absent
@@ -630,6 +886,64 @@ Downstream consumers (<a class="xref" href="Hi.NcParsers.LogicSyntaxs.CircularMo
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IsoG68RotationSyntax.html">IsoG68RotationSyntax</a>) call
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PlaneSelectSyntax.html#Hi_NcParsers_LogicSyntaxs_PlaneSelectSyntax_GetPlaneNormalDir_System_Text_Json_Nodes_JsonObject_">GetPlaneNormalDir(JsonObject)</a> to read the resolved plane.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.PolarGCodeCheckSyntax.html">PolarGCodeCheckSyntax</a></dt>
<dd><p>Warns on G-codes that Fanuc disallows during Polar Coordinate
Interpolation (G12.1), per the manual whitelist mirrored from HardNc
<code>IsGCodePolarModeCompatible</code>
(<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PolarInterpolationSyntax.html#Hi_NcParsers_LogicSyntaxs_PolarInterpolationSyntax_IncompatibleDiagId">IncompatibleDiagId</a>).</p>
<p>
Placed FIRST in the Logic bundle so the scan sees
<a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers_Keywords_IParsingDef_Parsing">Parsing</a> Flags before the mode/plane/offset
syntaxes consume their codes — at the old in-place check position,
G17/G18/G19, G20/G21, G49, G53.1 and G68/G69 cancels had already been
eaten and passed silently. Polar-active detection needs no valve of its
own: the PREVIOUS block's
<a class="xref" href="Hi.NcParsers.Keywords.IPolarInterpolationDef.html#Hi_NcParsers_Keywords_IPolarInterpolationDef_PolarInterpolationState">PolarInterpolationState</a> is already
final (the whole Logic bundle ran for it) unless this block exits with
G13.1; a block entering with G12.1 is checked too.
</p>
<p>
Residual blind spot (documented): codes captured as Parsing sub-objects
by <code>ParameterizedFlagSyntax</code> in the Parsing bundle (G28, G43/G44,
G43.4, G05.1, G52, G54.1, G68/G68.2, canned cycles) never reach Flags
and stay outside the scan. They cannot corrupt the polar trajectory —
the plane normal is fixed by the polar pair — so the gap is
diagnostic-only, same as HardNc's own per-code parse-time check.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.PolarInterpolationSyntax.html">PolarInterpolationSyntax</a></dt>
<dd><p>Maintains the modal Polar Coordinate Interpolation valve section
(<a class="xref" href="Hi.NcParsers.Keywords.IPolarInterpolationDef.html#Hi_NcParsers_Keywords_IPolarInterpolationDef_PolarInterpolationState">PolarInterpolationState</a>) for Fanuc
G12.1/G13.1.</p>
<p>
On a G12.1 block: consumes the flag, reads the block's own X/C words as
the anchor (<a class="xref" href="Hi.NcParsers.Keywords.PolarInterpolation.html#Hi_NcParsers_Keywords_PolarInterpolation_InitRxcz">InitRxcz</a>; the X word is a
diameter and is halved), converts the previous program position
(program X/Z + machine C angle) onto the polar hypothetical plane via
<a class="xref" href="Hi.Numerical.MechNcUtil.html#Hi_Numerical_MechNcUtil_GetProgramPolarRxczByOrdinaryProgramXcz_Hi_Geom_Vec3d_">GetProgramPolarRxczByOrdinaryProgramXcz(Vec3d)</a>, and
writes both the state section and the entry
<a class="xref" href="Hi.NcParsers.Keywords.IPolarInterpolationDef.html#Hi_NcParsers_Keywords_IPolarInterpolationDef_ProgramPolarRxcz">ProgramPolarRxcz</a> position.
Mirrors HardNc <code>HardNcLine</code> case <code>12_100</code>.
</p>
<p>
On a G13.1 block: consumes the flag and stops carrying the state — the
block itself is already Cartesian, matching HardNc case <code>13_100</code>.
</p>
<p>
On other blocks: re-materializes the previous block's state section
(single-step lookback carry, the <a class="xref" href="Hi.NcParsers.LogicSyntaxs.PositioningSyntax.html">PositioningSyntax</a> pattern),
and warns <code>FanucPolar--IncompatibleGCode</code> for G-codes outside the
Fanuc polar-mode whitelist (mirrors HardNc
<code>IsGCodePolarModeCompatible</code>).
</p>
Must be placed <b>before</b> <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a> so the downstream
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramRxczSyntax.html">ProgramRxczSyntax</a> can consume the hypothetical C word before
it is interpreted as a rotary machine axis.
</dd>
</dl>
<dl class="jumplist">
@@ -641,7 +955,11 @@ to the block JSON.</p>
<p>
Fanuc/ISO: reads G90/G91 from <a class="xref" href="Hi.NcParsers.Keywords.IFlagsDef.html#Hi_NcParsers_Keywords_IFlagsDef_Flags">Flags</a> (global modal).
Heidenhain: would need a separate implementation reading I-prefix per axis.
Siemens: would extend with AC()/IC() per-axis override.
Siemens: the AC()/IC() per-word override rides on top of this modal
state — <a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.Siemens.SiemensAcIcSyntax.html">SiemensAcIcSyntax</a>
writes a <a class="xref" href="Hi.NcParsers.Keywords.PositioningOverride.html">PositioningOverride</a> section the
downstream consumers (<a class="xref" href="Hi.NcParsers.LogicSyntaxs.IncrementalResolveSyntax.html">IncrementalResolveSyntax</a>,
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a>) honor per axis.
</p>
<p>
Does NOT convert incremental values — that is handled by
@@ -699,16 +1017,50 @@ should read the <a class="xref" href="Hi.NcParsers.Keywords.ProgramEnd.html">Pro
scanning for M30 in Flags directly.
</p>
Must be placed before syntaxes that depend on the ProgramEnd section.
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramRxczSyntax.html">ProgramRxczSyntax</a></dt>
<dd><p>Polar-mode sibling of <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a>: while the
<a class="xref" href="Hi.NcParsers.Keywords.IPolarInterpolationDef.html#Hi_NcParsers_Keywords_IPolarInterpolationDef_PolarInterpolationState">PolarInterpolationState</a> valve section
is present, consumes the block's X/C/Z words as polar hypothetical-plane
coordinates (X = diameter, halved; C = hypothetical axis in mm) and writes:</p>
<ol><li><a class="xref" href="Hi.NcParsers.Keywords.IPolarInterpolationDef.html#Hi_NcParsers_Keywords_IPolarInterpolationDef_ProgramPolarRxcz">ProgramPolarRxcz</a> — the
anchor-relative polar position (G90/G91 resolved against the previous
block's position, mirroring HardNc <code>NcGroup03.GetNcFromSyntax</code>);</li><li><a class="xref" href="Hi.NcParsers.Keywords.IProgramXyzDef.html#Hi_NcParsers_Keywords_IProgramXyzDef_ProgramXyz">ProgramXyz</a> — the derived ordinary
program position (radius, previous program Y, Z), so the downstream
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McXyzSyntax.html">McXyzSyntax</a> derives machine XYZ through the normal
transform chain — <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramXyzSyntax.html">ProgramXyzSyntax</a> itself naturally
no-ops because the axis words are already consumed;</li><li>the machine C angle (degrees) into
<a class="xref" href="Hi.NcParsers.Keywords.IMachineCoordinateStateDef.html#Hi_NcParsers_Keywords_IMachineCoordinateStateDef_MachineCoordinateState">MachineCoordinateState</a> —
placed before <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcSyntax.html">McAbcSyntax</a>, which then preserves the
value instead of treating C as a directly-commanded rotary word;</li><li>on motion-programmed blocks, <a class="xref" href="Hi.NcParsers.Keywords.MotionState.html">MotionState</a> and a
<a class="xref" href="Hi.NcParsers.Keywords.MotionEvent.html">MotionEvent</a> with <a class="xref" href="Hi.NcParsers.Keywords.Generic.MotionForm.html#Hi_NcParsers_Keywords_Generic_MotionForm_McPolarLinear">McPolarLinear</a>
(G00/G01) or <a class="xref" href="Hi.NcParsers.Keywords.Generic.MotionForm.html#Hi_NcParsers_Keywords_Generic_MotionForm_McPolarArc">McPolarArc</a> (G02/G03 with R or
I/J/K resolved on the hypothetical plane).</li></ol>
The G12.1 entry block is skipped (its position was anchored by
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.PolarInterpolationSyntax.html">PolarInterpolationSyntax</a>). Angle-branch resolution mirrors
HardNc: <a class="xref" href="Hi.Numerical.MechNcUtil.html#Hi_Numerical_MechNcUtil_GetOrdinaryProgramXcz_rad_Hi_Geom_Vec3d_System_Double_Hi_Geom_Vec3d_">GetOrdinaryProgramXcz_rad(Vec3d, double, Vec3d)</a> chained from
the previous machine C angle.
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramStopSyntax.html">ProgramStopSyntax</a></dt>
<dd><p>Consumes M00 (unconditional stop) and M01 (optional stop) from
<dd><p>Consumes the program-stop words in <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramStopSyntax.html#Hi_NcParsers_LogicSyntaxs_ProgramStopSyntax_SupportedCodes">SupportedCodes</a>
(default M00 unconditional / M01 optional) from
<a class="xref" href="Hi.NcParsers.Keywords.IFlagsDef.html#Hi_NcParsers_Keywords_IFlagsDef_Flags">Flags</a> and writes a
<a class="xref" href="Hi.NcParsers.Keywords.IProgramStopDef.html">IProgramStopDef</a> section on the block that carried the
flag. Non-modal: the section is written only on the exact block
where the stop code appears.</p>
<p>
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramStopSyntax.html#Hi_NcParsers_LogicSyntaxs_ProgramStopSyntax_SupportedCodes">SupportedCodes</a> is ordered by priority: when several
listed words share a block the first listed one wins and stamps
<code>Term</code> with its literal; every listed word is removed from the
block either way. A brand preset widens the list for its own
vocabulary (the Heidenhain <code>STOP</code> word — the
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.MachineCoordSelectSyntax.html#Hi_NcParsers_LogicSyntaxs_MachineCoordSelectSyntax_SupportedCodes">SupportedCodes</a> precedent).
</p>
<p>
Siblings with <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ProgramEndSyntax.html">ProgramEndSyntax</a> (M02/M30) which handles
end-of-program, not in-program stops.
</p>
@@ -781,7 +1133,7 @@ Non-RTCP using "corresponding" — leaves the pre-chain-change values,
so a block emitted right after <code>G43.4 H03</code> would inherit
ProgramXyz still in the G49 frame and the next motion's MC.Z drifts
by the introduced tool-height offset. (This was the 2026-04-25
SoftNc / HardNc divergence on <code>DemoPmcAirPlane/NC/02-ED6L20.NC</code>.)
SoftNc / HardNc divergence found on a five-axis sample program.)
</li><li>
RTCP using "current" — double-counts the rotary
<code>PivotTransform</code> difference, so the inherited workpiece anchor
@@ -823,12 +1175,28 @@ and other syntaxes that read or write rotary axis values.</p>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.SpindleSpeedSyntax.html">SpindleSpeedSyntax</a></dt>
<dd><p>Consumes S (spindle speed) and M03/M04/M05 (spindle direction)
<dd><p>Consumes S (spindle speed) and spindle direction M-codes
from <a class="xref" href="Hi.NcParsers.Keywords.IParsingDef.html#Hi_NcParsers_Keywords_IParsingDef_Parsing">Parsing</a>.
Both are modal — persist across blocks via backward node lookback.
Writes resolved state to a <a class="xref" href="Hi.NcParsers.Keywords.ISpindleSpeedDef.html">ISpindleSpeedDef</a> section.
Direction is converted from ISO M-codes to the conventional
Direction is converted from M-codes to the conventional
<a class="xref" href="Hi.Numerical.SpindleDirection.html">SpindleDirection</a> enum at this layer.</p>
<p>
Direction M-codes: the ISO defaults M03 (CW) / M04 (CCW) / M05 (STOP)
always apply; a machine that starts/stops its spindle with custom
M-codes (e.g., ultrasonic <code>M203</code>/<code>M205</code>) declares them on an
<a class="xref" href="Hi.NcParsers.Dependencys.ISpindleControlConfig.html">ISpindleControlConfig</a> dependency
(<a class="xref" href="Hi.NcParsers.Dependencys.ControllerParameterTableBase.html">ControllerParameterTableBase</a>), which this
syntax consults first — mapped flags are consumed like the ISO ones.
</p>
<p>
Fallback: an S &gt; 0 with no direction ever issued is contradictory
(physics would silently never run). The build assumes CW and emits a
one-shot <code>SpindleDirection--AssumedCw</code> validation warning — once is
structural, not stateful: the stamped CW propagates modally, so later
blocks no longer lack a direction. An explicit M05 (STOP) is a real
direction and never triggers the fallback.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -857,6 +1225,46 @@ Must be placed after <a class="xref" href="Hi.NcParsers.LogicSyntaxs.CannedCycle
<dd><p>Shared utilities for all tilt transform syntaxes
(ISO, Siemens, Heidenhain). Handles section IO,
backward lookback, and <a class="xref" href="Hi.NcParsers.Keywords.ITransformationDef.html#Hi_NcParsers_Keywords_ITransformationDef_ProgramToMcTransform">ProgramToMcTransform</a> composition.</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeMotionSyntax.html">ToolChangeMotionSyntax</a></dt>
<dd><p>Synthesizes the machine motion of a tool change: on a block whose
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_SectionName">SectionName</a> section carries
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_IsChangeKey">IsChangeKey</a> = true AND whose tool number
actually differs from the previously equipped tool, overlays
<a class="xref" href="Hi.NcParsers.Dependencys.IToolingMcConfig.html">IToolingMcConfig</a>'s per-axis tooling position onto the
current machine pose (NaN / missing axis = stays) and emits a one-item
rapid <a class="xref" href="Hi.NcParsers.Keywords.ICompoundMotionDef.html">ICompoundMotionDef</a> to that target — the axis travel
a real machine's M06 macro performs before the changer cycle runs.
Root <a class="xref" href="Hi.NcParsers.Keywords.IProgramXyzDef.html#Hi_NcParsers_Keywords_IProgramXyzDef_ProgramXyz">ProgramXyz</a> (and the moved rotary axes
in root <a class="xref" href="Hi.NcParsers.Keywords.IMachineCoordinateStateDef.html#Hi_NcParsers_Keywords_IMachineCoordinateStateDef_MachineCoordinateState">MachineCoordinateState</a>)
are overwritten for subsequent-block modal lookback, mirroring
<code>HardNcLine</code>'s M06 handling (<code>McXyz</code>/<code>McAbc_rad</code> overlay +
<code>RebuildProgramXyzByMc</code>).</p>
<p>
A same-number tool call (M06 without an actual change) emits no motion —
the parity twin of HardNc's <code>preT != T</code> overlay gate. A block with
its own motion words folds them into the single rapid: the overlay
applies on top of the block's commanded position and the stamped
<a class="xref" href="Hi.NcParsers.Keywords.CompoundMotion.html">CompoundMotion</a> makes <a class="xref" href="Hi.NcParsers.LogicSyntaxs.LinearMotionSyntax.html">LinearMotionSyntax</a> skip
the block, so one contour covers both — the HardNc M06 branch shape.
Placement: the <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ReferenceReturnSyntax.html">ReferenceReturnSyntax</a> (G28) slot — after
the offset/frame syntaxes (the ProgramXyz back-derivation needs the
composed transform), before <a class="xref" href="Hi.NcParsers.LogicSyntaxs.McXyzSyntax.html">McXyzSyntax</a> /
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.McAbcCyclicPathSyntax.html">McAbcCyclicPathSyntax</a> (root MC XYZ backfill; rotary
targets wrapped shortest-path by the cyclic tail-pass).
</p>
<p>
Programs that retract on their own (G75/G28/SUPA before M06 — every
healthy post) reach the tooling position before the M06 block, so the
synthesized move is zero-length and
<a class="xref" href="Hi.NcParsers.Semantics.CompoundMotionSemantic.html">CompoundMotionSemantic</a> emits nothing. Only a
program that leaves the tool elsewhere (typically hand-edited) gets an
actual synthesized travel — and the machining steps along it surface
any material contact, plus the runtime's <code>ToolChange--UnsafePose</code>
diagnostic.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -869,6 +1277,28 @@ Writes resolved state to a <code>ToolChange</code> section:
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_TermKey">TermKey</a> records the trigger command and is only written
when <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_IsChangeKey">IsChangeKey</a> is true (i.e. the block actually carried
the tool-change M code); modal-only blocks omit it.</p>
<p>
<code>ToolId</code> is an int for numeric calls (<code>T5</code>) and a string for
Siemens string tool calls (<code>T="D8R1"</code>, captured by
<a class="xref" href="Hi.NcParsers.ParsingSyntaxs.Siemens.SiemensToolCallSyntax.html">SiemensToolCallSyntax</a>); both
shapes carry modally. String names are resolved to tool numbers at the
semantic layer (<a class="xref" href="Hi.NcParsers.Semantics.ToolChangeSemantic.html">ToolChangeSemantic</a>) — this
syntax records the call verbatim.
</p>
<p>
The trigger is machine-configurable. A custom tool-change M-code
(Siemens MD22560 <code>$MC_TOOL_CHANGE_M_CODE</code>) is declared on the
controller parameter table
(<a class="xref" href="Hi.NcParsers.Dependencys.MCodeEffects.html#Hi_NcParsers_Dependencys_MCodeEffects_IsToolChange">IsToolChange</a>) and reaches this
syntax already expanded to M06 by <a class="xref" href="Hi.NcParsers.LogicSyntaxs.MCodeExpansionSyntax.html">MCodeExpansionSyntax</a>.
Turret/lathe machines where the <code>T</code> word itself performs the
change (Siemens MD22550 <code>$MC_TOOL_CHANGE_MODE</code> = 0) set
<a class="xref" href="Hi.NcParsers.Dependencys.IToolChangeTriggerConfig.html#Hi_NcParsers_Dependencys_IToolChangeTriggerConfig_ToolWordTriggersChange">ToolWordTriggersChange</a>;
the block then triggers with <a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_ToolWordTerm">ToolWordTerm</a> recorded as
<a class="xref" href="Hi.NcParsers.LogicSyntaxs.ToolChangeSyntax.html#Hi_NcParsers_LogicSyntaxs_ToolChangeSyntax_TermKey">TermKey</a>. Without that config a bare <code>T</code> block stays
pre-selection only — magazine rotation is the PLC's business and moves
no feed axis.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -890,12 +1320,24 @@ section (<a class="xref" href="Hi.NcParsers.Keywords.IUnitDef.html#Hi_NcParsers_
Modal — absence of an explicit flag inherits the previous block's
unit, defaulting to <a class="xref" href="Hi.NcParsers.Keywords.Unit.html#Hi_NcParsers_Keywords_Unit_Metric">Metric</a> at program start.</p>
<p>
The HiNC pipeline works exclusively in millimetres. When
<a class="xref" href="Hi.NcParsers.Keywords.Generic.IsoKeywords.html#Hi_NcParsers_Keywords_Generic_IsoKeywords_G20">G20</a> is detected this syntax emits an
<code>Unit--InchNotSupported</code> Unsupported Error so upstream callers
are forced to pre-convert the NC program to metric.
<a class="xref" href="Hi.NcParsers.Keywords.Generic.IsoKeywords.html#Hi_NcParsers_Keywords_Generic_IsoKeywords_G21">G21</a> is accepted as a no-op confirmation of
the default.
The code vocabulary is configurable per brand: <a class="xref" href="Hi.NcParsers.LogicSyntaxs.UnitModeSyntax.html#Hi_NcParsers_LogicSyntaxs_UnitModeSyntax_InchCodes">InchCodes</a>
/ <a class="xref" href="Hi.NcParsers.LogicSyntaxs.UnitModeSyntax.html#Hi_NcParsers_LogicSyntaxs_UnitModeSyntax_MetricCodes">MetricCodes</a> default to ISO G20 / G21; the Siemens
preset uses G70+G700 / G710+G71 instead (G70/G71 switch geometry-word
interpretation only, G700/G710 also switch feedrate interpretation —
a distinction preserved via the verbatim <a class="xref" href="Hi.NcParsers.Keywords.IUnitDef.html#Hi_NcParsers_Keywords_IUnitDef_Term">Term</a>
but irrelevant to this record-only syntax; both inch variants warn
identically). The first <a class="xref" href="Hi.NcParsers.LogicSyntaxs.UnitModeSyntax.html#Hi_NcParsers_LogicSyntaxs_UnitModeSyntax_MetricCodes">MetricCodes</a> entry doubles as the
program-start default <code>Term</code>. Note Siemens G70/G71 must never be
added to ISO/Fanuc presets — on Fanuc lathes the same codes are
finishing/roughing cycles (same collision family as the documented
Siemens G74 exclusion).
</p>
<p>
The HiNC pipeline works exclusively in millimetres. When an inch code
is detected this syntax emits an <code>Unit--InchNotSupported</code>
Unsupported Error so upstream callers are forced to pre-convert the
NC program to metric — while still recording what the program said.
Metric codes are accepted as no-op confirmations of the default.
</p>
</dd>
</dl>