Table of Contents

Class HeidenhainPlaneTiltSyntax

Namespace
Hi.NcParsers.LogicSyntaxs.Heidenhain
Assembly
HiMech.dll

Heidenhain PLANE consumer — the Heidenhain sibling of IsoG68p2TiltSyntax (Fanuc G68.2) and SiemensCycle800TiltSyntax both XmlDocs promise.

  • PLANE SPATIAL — composes the tilted work plane Rx(SPA)·Ry(SPB)·Rz(SPC) (row-vector, degrees; the HardNc oracle's HeidenhainPlaneSpatialArg matrix verbatim) into ProgramToMcTransform as the shared TransformSource entry with Term = "PLANE SPATIAL".
  • MOVE / TURN — the implicit rotary positioning (the CYCLE800 "G53.1 half"): with IMachineKinematics wired the plane orientation is solved to machine ABC (full-orientation IK first so a pure in-plane SPC under TABLE ROT still turns the table; tool-axis-normal fallback for machines with fewer rotary DOF; no identity short-circuit — the explicit zero-angle PLANE SPATIAL SPA+0 SPB+0 SPC+0 TURN is the klartext idiom for returning the rotaries to 0, oracle parity) and written into MachineCoordinateState plus a non-modal MotionEvent with Term = "PLANE SPATIAL". MOVE's DIST (tool retract radius during the swivel) and the TCP-preserving XYZ compensation are recorded but not simulated — the machine XYZ stays at the previous position like TURN, a transient-only divergence from the HardNc oracle (endpoints re-anchor at the next commanded point); MOVE's F is recorded on the event as MoveFeedrate.
  • COORD ROT is honored only when the plane rotates purely about the tool axis (ToolAxisDirection, TNC manual rule; HardNc parity): the coordinate system rotates and the rotaries stay. Any other rotation — or TABLE ROT, or neither word — positions the rotary axes on MOVE/TURN.
  • SEQ± is recorded in the section; when the IK solution's master rotary (first declared rotary axis) violates an explicit SEQ preference the preference is not applied and Coord-Tilt--007 warns (solution-family selection is not modeled; the HardNc ±2π window wrap would be undone by McAbcCyclicPathSyntax's shortest-cyclic tail pass, and the corpus never exercises SEQ with MOVE/TURN).
  • PLANE RESET — the shared inactive sentinel (Term = "G69" + identity entry). The rotary axes are not re-positioned on reset (CYCLE800 cancel precedent; corpus programs follow with explicit rotary moves).
  • PLANE VECTOR / PROJECTED / EULER / POINTS / RELATIV / AXIAL — recognized-but-not-simulated: consumed, HeidenhainPlane--Unsupported warns, and the previous tilt state carries unchanged (the HardNc oracle instead reuses a stale spatial arg here — SoftNc deliberately exceeds it).

Owns the once-per-block TiltTransform modal carry for the Heidenhain list (CarryForwardFromPrevious(LazyLinkedListNode<SyntaxPiece>, JsonObject)). Must run before ToolHeightOffsetSyntax / HeidenhainToolOffsetSyntax (their translation follows the tilt entry's normal — the oracle's tool-normal-tiltable rule) and before McAbcSyntax / the coordinate-offset syntaxes (chain order: tilt entry ahead of CoordinateOffset, mirroring the Siemens frame slot; implicit MC rotary values must land before McAbc's per-axis lookback). 

public class HeidenhainPlaneTiltSyntax : ISituNcSyntax, INcSyntax, IMakeXmlSource
Inheritance
HeidenhainPlaneTiltSyntax
Implements
Inherited Members
Extension Methods

Examples

PLANE RESET — the shared inactive sentinel: #BeforeBuild:

{ "Parsing": { "PLANE": { "Mode": "RESET", "Positioning": "STAY" } } }

#AfterBuild:

{
  "TiltTransform": { "Term": "G69" },
  "ProgramToMcTransform": [
    {
      "Source": "TiltTransform",
      "Kind": "Static",
      "Mat4d": [1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]
    }
  ]
}

PLANE SPATIAL with STAY — tilt only, no rotary positioning, no kinematics needed. SPA+30 gives Rx(30°) (row-vector; the HardNc Rx(SPA)·Ry(SPB)·Rz(SPC) matrix): #BeforeBuild:

{
  "Parsing": {
    "PLANE": {
      "Mode": "SPATIAL", "SPA": 30, "SPB": 0, "SPC": 0,
      "Positioning": "STAY"
    }
  }
}

#AfterBuild:

{
  "TiltTransform": {
    "Term": "PLANE SPATIAL",
    "SPA": 30, "SPB": 0, "SPC": 0, "Positioning": "STAY"
  },
  "ProgramToMcTransform": [
    {
      "Source": "TiltTransform",
      "Kind": "Static",
      "Mat4d": [
        1, 0, 0, 0,
        0, 0.8660254037844387, 0.49999999999999994, 0,
        0, -0.49999999999999994, 0.8660254037844387, 0,
        0, 0, 0, 1
      ]
    }
  ]
}

The turbine STAY form — SEQ and TABLE ROT recorded; angles compose Rx(-77.516°)·Rz(-10.365°); machine coordinates untouched: #BeforeBuild:

{
  "Parsing": {
    "PLANE": {
      "Mode": "SPATIAL", "SPA": -77.516, "SPB": 0, "SPC": -10.365,
      "SEQ": "-", "Rot": "TABLE", "Positioning": "STAY"
    }
  }
}

#AfterBuild:

{
  "TiltTransform": {
    "Term": "PLANE SPATIAL",
    "SPA": -77.516, "SPB": 0, "SPC": -10.365,
    "SEQ": "-", "Rot": "TABLE", "Positioning": "STAY"
  },
  "ProgramToMcTransform": [
    {
      "Source": "TiltTransform",
      "Kind": "Static",
      "Mat4d": [
        0.9836815601642315, -0.17991828198619333, 0, 0,
        0.03889239026499967, 0.21263946449492488, -0.9763564103946809, 0,
        0.1756643679644177, 0.9604237970533884, 0.21616697222566972, 0,
        0, 0, 0, 1
      ]
    }
  ]
}

Recognized-but-not-simulated mode — consumed, warned, previous tilt (here: none → the G69 default stamp) carries unchanged: #BeforeBuild:

{
  "Parsing": {
    "PLANE": {
      "Mode": "VECTOR",
      "BX": 1, "BY": 0, "BZ": 0, "NX": 0, "NY": 0, "NZ": 1,
      "Positioning": "STAY"
    }
  }
}

#AfterBuild:

{
  "TiltTransform": { "Term": "G69" }
}

Constructors

HeidenhainPlaneTiltSyntax()

Initializes a new instance with default settings.

public HeidenhainPlaneTiltSyntax()

HeidenhainPlaneTiltSyntax(XElement)

Initializes a new instance by deserializing from the given XML element.

public HeidenhainPlaneTiltSyntax(XElement src)

Parameters

src XElement

Source XML element.

Fields

MoveFeedrateKey

MotionEvent key recording the MOVE repositioning feed (recorded only).

public const string MoveFeedrateKey = "MoveFeedrate"

Field Value

string

SpatialTerm

TiltTransform term written for an active PLANE SPATIAL plane (also the implicit positioning MotionEvent term).

public const string SpatialTerm = "PLANE SPATIAL"

Field Value

string

Properties

Name

Syntax kind name (typically the concrete type name).

public string Name { get; }

Property Value

string

XName

XML element name used to register this syntax with XFactory.

public static string XName { get; }

Property Value

string

Methods

Build(LazyLinkedListNode<SyntaxPiece>, List<INcDependency>, NcDiagnosticProgress)

Build syntax arrangement into the syntaxPieceNode in-place.

public void Build(LazyLinkedListNode<SyntaxPiece> syntaxPieceNode, List<INcDependency> ncDependencyList, NcDiagnosticProgress ncDiagnosticProgress)

Parameters

syntaxPieceNode LazyLinkedListNode<SyntaxPiece>
ncDependencyList List<INcDependency>
ncDiagnosticProgress NcDiagnosticProgress

MakeXmlSource(string, string, bool)

Creates an XML representation of the object. This method may also generate additional resources such as related files.

public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly)

Parameters

baseDirectory string

The base directory for resolving relative paths

relFile string

The relative file path for the XML source

exhibitionOnly bool

if true, the extended file creation is suppressed.

Returns

XElement

An XML element representing the object's state

Remarks

For the demand of easy moving source folder (especially project folder) without configuration file path corruption, the relative file path is applied. The baseDirectory is typically the folder at the nearest configuration file folder. Since the folder can be moving with the configuration file.

Reg(XFactory)

Registers this type's deserializer with the given XFactory (or Default when factory is null). Idempotent.

public static void Reg(XFactory factory = null)

Parameters

factory XFactory