访问 MP.NET 中的机器定义参数

MP.NET 开发人员始终能够在他们的 MP.NET 后处理中使用 Api.MPParam 函数查询 MP 操作参数。但是，此函数不支持开发人员查询机床定义参数或单个组件的参数。我们向 MP.NET 添加了三个新的函数以提供此功能。

• 一个函数允许后处理开发人员查询特定组件或机床定义本身以获取参数值。

• 另外两个函数满足了识别开发人员希望查询其参数的特定组件的需求。一个函数用于查询组件所在的组合轴；第二个函数用于根据组件与已知组件的关系来识别组件。

Api.MachineDefInfo 函数

使用此命令可查询机床定义或特定组件以获取参数值。这是用于访问可用于 MP 后处理的机床定义参数（参数 17000–17999 和 60000–64999）的主要功能。将其与单个参数一起使用可查询常规机床定义设置，或提供组件 ID 作为第二个参数以查询特定组件。

函数的一般形式如下：

Api.MachineDefInfo (paramNum [, componentID])

函数定义如下：

• paramNum 是要访问的机床定义参数的编号。这可以是数字或数字标记的名称。

• componentID（可选）是要访问的组件的 ID。例如，您的机床定义可能具有多个相同类型的组件，例如线性轴、刀塔或主轴。Mastercam 使用此编号选择要查询的特定机床定义组件。

  如果未提供此参数，Mastercam 将查询常规机床设置。其中包括“标准机床参数”对话框和主“机床定义管理器”对话框中的信息。

通常，您将通过 Api.AxisCombo 函数或 Api.GetRelatedComponentID 函数获得所需的组件 ID。

Api.AxisCombo 函数

使用此函数可获取组合轴或组合轴内组件的组件 ID。通常，返回的 ID 被用作 Api.MachineDefInfo 函数的输入。

函数的一般形式如下：

Api.AxisCombo (mode, spindleID, streamID [, componentType])

函数定义如下：

• mode 指定以下函数将返回的信息：Title 或 ComponentID。

  • 指定 Title 以返回组合轴的名称。

  • 指定 ComponentID 以返回组合轴中组件的 ID 或组合轴本身的 ID。

    请勿在此参数两边加上引号。

• spindleID 是要查询的组合轴中的主轴编号。SpindleID 标记通常用于此目的。

• streamID 是与要查询的组合轴关联的程序流的编号。StreamID 标记通常用于此目的。

  请注意，在机床定义（*.mcam-lmd 文件）中，程序流 ID 从 1 开始（换句话说，在双程序流机床上，程序流为 1 和 2），但在 MP.NET 内部，它们从零开始（两个程序流为 0 和 1）。此函数使用从零开始的 MP.NET 程序流 ID。

• ComponentType（可选）指定要查询的组合轴中的组件类型，例如，CAxis、Chuck 或 Turret。下面提供了允许类型的完整列表。

  • 如果包含此参数，Mastercam 将返回组合轴中存在的该类型组件的 ID。

  • 如果省略此参数，Mastercam 将返回组合轴本身的 ID。

指定组件类型

此处列出了允许的组件类型。使用函数指定的值必须与下面的列表完全匹配。请勿使用引号。

• XAxis

• YAxis

• ZAxis

• AAxis

• BAxis

• CAxis

• RectangleTable

• Fixture

• Vise

• Chuck

• ColletChuck

• MultiHead

• PiggyBack

• WireUpperGuide

• WireLowerGuide

• ToolSpindle

• MultiTool

• Turret

• AggregateHead

• DrillBlock

• GangTool

• MTTurret

这些组件类型被视为组合轴的一部分。例如，卡爪或筒夹不被视为组合轴的一部分，并且无法使用此函数检索其 ID。每个组合轴应只包含每种类型组件中的一个。

• 如果不存在所请求类型的组件，则不会返回任何内容。

• 如果提供了 ComponentType 参数，则第一个参数是什么（Title 或 ComponentID）并不重要 — Mastercam 将始终返回组件 ID。

Api.GetRelatedComponentID 函数

使用此函数可以根据组件与另一个组件（例如，子组件或同级组件）的关系获取组件的 ID。您还可以使用此函数获取不在组合轴中的组件的 ID。通常，返回的 ID 被用作 Api.MachineDefInfo 函数的输入。

该函数的一般形式是 Api.GetRelatedComponentID (navigationType, componentID [, generation])。

函数定义如下：

• navigationType 指定提供其 ID 的组件与要查询的组件之间的关系。允许的值为 Parent、FirstChild、NextSibling、PreviousSibling 或 Root。请勿在此参数两边加上引号。

• componentID 是关系中基本组件的 ID。

• generation（可选）表示要访问的生成。如果未提供此参数，则默认为 1。例如，如果 navigationType 是 FirstChild 并且此参数为 2，则 Mastercam 将查找原始起始组件的第一个子组件，然后查找该组件的第一个子组件，并返回其 ID。