Class HeidenhainDatumTable

Namespace

Hi.NcParsers.Dependencys

Assembly

HiMech.dll

Heidenhain datum preset and datum shift tables. CYCL DEF 247 Q339=N reads from DatumPresetTable, CYCL DEF 7 #N reads from DatumShiftTable. Each table maps an integer ID (1–20) to a Vec3d offset.

On real Heidenhain controllers, preset and datum tables are separate disk files (e.g. TNC:\table\preset.pr, *.d) — distinct from MP-prefixed Machine Parameters (held by HeidenhainParameterTable). HiNC mirrors that separation by keeping this dependency independent of HeidenhainParameterTable.

Implements IIsoCoordinateConfig by mapping the ISO/DIN G54–G59 codes to preset rows 1–6, the conventional Heidenhain compatibility mapping for ISO/DIN programs running on a Heidenhain.

public class HeidenhainDatumTable : IIsoCoordinateConfig, INcDependency, IMakeXmlSource

Inheritance

object

HeidenhainDatumTable

Implements

IIsoCoordinateConfig

INcDependency

IMakeXmlSource

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[])

InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>)

InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>)

ColorUtil.GetGloomyColor(object, double, double)

NameUtil.GetSelectionName(object)

StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool)

LockUtil.Lock(object)

Constructors

HeidenhainDatumTable()

Initializes a new instance with rows 1-20 of DatumPresetTable and DatumShiftTable seeded to zero.

public HeidenhainDatumTable()

HeidenhainDatumTable(XElement)

Initializes a new instance by deserializing from src.

public HeidenhainDatumTable(XElement src)

Parameters

src XElement

XML element produced by MakeXmlSource(string, string, bool).

Properties

CoordinateIds

Enumerates the G-code coordinate ids that this provider currently has data for.

public IEnumerable<string> CoordinateIds { get; }

Property Value

IEnumerable<string>

DatumPresetTable

Preset rows (CYCL DEF 247 Q339=N) keyed by preset id (1-20). Rows 1-6 are aliased to ISO G54-G59 via IIsoCoordinateConfig.

public Dictionary<int, Vec3d> DatumPresetTable { get; set; }

Property Value

Dictionary<int, Vec3d>

DatumShiftTable

Datum shift rows (CYCL DEF 7 #N) keyed by table id (1-20).

public Dictionary<int, Vec3d> DatumShiftTable { get; set; }

Property Value

Dictionary<int, Vec3d>

XName

XML element name used to register this dependency with XFactory.

public static string XName { get; }

Property Value

string

Methods

GetCoordinateOffset(string)

Gets the offset for the given G-code coordinate id. Returns null when no offset is configured for that id by this provider (callers iterate the next provider, or fall back to Zero).

public Vec3d GetCoordinateOffset(string coordId)

Parameters

coordId string

Returns

Vec3d

GetDatumPreset(int)

Returns the preset offset for q339, or Zero if absent. See DatumPresetTable.

public Vec3d GetDatumPreset(int q339)

Parameters

q339 int

Preset id (CYCL DEF 247 Q339).

Returns

Vec3d

GetDatumShift(int)

Returns the datum shift offset for tableId, or Zero if absent. See DatumShiftTable.

public Vec3d GetDatumShift(int tableId)

Parameters

tableId int

Datum shift row id (CYCL DEF 7 #N).

Returns

Vec3d

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

SetCoordinateOffset(string, Vec3d)

Sets the offset for the given G-code coordinate id.

public void SetCoordinateOffset(string coordId, Vec3d offset)

Parameters

coordId string

offset Vec3d

SetDatumPreset(int, Vec3d)

Sets the preset offset for q339. See DatumPresetTable.

public void SetDatumPreset(int q339, Vec3d offset)

Parameters

q339 int

Preset id (CYCL DEF 247 Q339).

offset Vec3d

Translation to store.

SetDatumShift(int, Vec3d)

Sets the datum shift offset for tableId. See DatumShiftTable.

public void SetDatumShift(int tableId, Vec3d offset)

Parameters

tableId int

Datum shift row id (CYCL DEF 7 #N).

offset Vec3d

Translation to store.