訪問 MP.NET 中的機器定義參數

6730次瀏覽

發佈於 2023 年 5 月 30 日 / 更新於 2023 年 8 月 15 日

透過 Mastercam

MP.NET 開發人員始終能夠使用 Api.MPParam 在其 MP.NET 帖子中查詢 MP 操作參數的函數。但是，該功能不允許開發人員查詢機器定義參數或單個組件的參數。 MP.NET 中添加了三個新函數來提供此功能。

Api.MachineDefInfo 函數

使用此命令查詢機器定義或特定組件的參數值。這是訪問 MP 崗位可用的機器定義參數（參數 17000–17999 和 60000–64999）的主要功能。將其與單個參數結合使用可查詢常規計算機定義設置，或提供組件 ID 作為第二個參數以查詢特定組件。

函數的一般形式如下：

Api.MachineDefInfo (paramNum [, componentID])

函數定義如下：

paramNum 是要訪問的機器定義參數的編號。這可以是數字或數字標記的名稱。
componentID （可選）是要訪問的組件的 ID。例如，您的機器定義可能具有多個相同類型的組件，例如線性軸、轉塔或主軸。 Mastercam 使用此數字來選擇要查詢的特定機器定義組件。

如果未提供此參數， Mastercam 將查詢常規機器設置。其中包括“常規機器參數”對話框和“機器定義管理器”主對話框中的信息。

通常，您將獲得所需的組件 ID Api.AxisCombo 函數或 Api.GetRelatedComponentID 功能。

使用此函數可獲取軸組合或軸組合內組件的組件 ID。通常，返回的 ID 用作 Api.MachineDefInfo 功能。

函數的一般形式如下：

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

函數定義如下：

mode 指定函數將返回的信息： Title，或者 ComponentID.
- 指定 Title 返回軸組合的名稱。
- 指定 ComponentID 返回軸組合中組件的 ID 或軸組合本身。
  
  不要在該參數兩邊添加引號。
spindleID 為您查詢的軸組合中主軸的編號。這 SpindleID 令牌通常用於此目的。
streamID 是與您正在查詢的軸組合關聯的流的編號。這 StreamID 令牌通常用於此目的。

請注意，在機器定義（ *.mcam-lmd文件）中，流 ID 是從 1 開始的（換句話說，在雙流機器上，流是 1 和 2），但在 MP.NET 內部它們為零-based（兩個流是 0 和 1）。此函數使用從零開始的 MP.NET 流 ID。
ComponentType （可選）指定您正在查詢的軸組合中的組件類型，例如， CAxis, Chuck，或者 Turret。下面列出了允許類型的完整列表。
- 如果你包括這個論點， Mastercam 返回軸組合中存在的該類型組件的 ID。
- 如果省略這個參數， Mastercam 返回軸組合本身的 ID。

此處列出了允許的組件類型。使用函數指定的值必須與下面的列表完全匹配。不要使用引號。

這些組件類型被視為軸組合的一部分。例如，夾爪或夾頭不被視為軸組合的一部分，並且無法使用此功能檢索它們的 ID。每個軸組合應該只包含每種類型的組件之一。

如果不存在所請求類型的組件，則不會返回任何內容。
如果一個 ComponentType 提供了參數，第一個參數是什麼並不重要（Title 或者 ComponentID)— Mastercam 將始終返回組件 ID。

使用此函數可以根據組件與另一個組件（例如子組件或同級組件）的關係來獲取組件的 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。