MP.NET でのマシン定義パラメータへのアクセス

MP.NET 開発者は常に、 Api.MPParam MP.NET 投稿で MP 操作パラメータをクエリする関数。ただし、この機能では、開発者がマシン定義パラメータや個々のコンポーネントのパラメータをクエリすることはできません。この機能を提供するために、MP.NET に 3 つの新しい関数が追加されました。

• 1 つの機能により、ポスト開発者は特定のコンポーネントまたはマシン定義自体にパラメータ値を問い合わせることができます。

• 2 つの追加関数は、開発者がパラメータを照会したい特定のコンポーネントを識別する必要性に対処します。 1 つの関数は、コンポーネントが存在する軸の組み合わせをクエリします。 2 番目の機能は、既知のコンポーネントとの関係に基づいてコンポーネントを識別します。

API.MachineDefInfo 関数

このコマンドを使用して、マシン定義または特定のコンポーネントのパラメーター値をクエリします。これは、MP ポストで使用できるマシン定義パラメータ (パラメータ 17000 ～ 17999 および 60000 ～ 64999) にアクセスするためのメイン関数です。これを 1 つの引数とともに使用して一般的なマシン定義設定をクエリするか、コンポーネント ID を 2 番目の引数として指定して特定のコンポーネントをクエリします。

関数の一般的な形式は次のとおりです。

Api.MachineDefInfo (paramNum [, componentID])

関数は以下のように定義されています。

• paramNum アクセスするマシン定義パラメータの番号です。これは、数値または数値トークンの名前のいずれかです。

• componentID (オプション) は、アクセスするコンポーネントの ID です。たとえば、マシン定義には、直線軸、タレット、スピンドルなどの同じタイプのコンポーネントが複数含まれている場合があります。 Mastercam は、この番号を使用して、クエリする特定のマシン定義コンポーネントを選択します。

  この引数が指定されていない場合、 Mastercam マシンの一般的な設定を照会します。これらには、 [一般マシン パラメータ]ダイアログ ボックスとメインの[マシン定義マネージャ]ダイアログ ボックスの情報が含まれます。

通常、次のコマンドを使用して目的のコンポーネント ID を取得します。 Api.AxisCombo 関数または Api.GetRelatedComponentID 関数。

API.AxisCombo 関数

この関数を使用して、軸の組み合わせまたは軸の組み合わせ内のコンポーネントのコンポーネント 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 内部では 0 であることに注意してください。 -based (2 つのストリームは 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 を取得できません。各軸の組み合わせには、各タイプのコンポーネントを 1 つだけ含める必要があります。

• 要求されたタイプのコンポーネントが存在しない場合は、何も返されません。

• もし ComponentType 引数が指定されている場合、最初の引数が何であるかは関係ありません(Title また ComponentID)— Mastercam 常にコンポーネント ID を返します。

API.GetManyComponentID 関数

この関数を使用して、別のコンポーネント (子コンポーネントや兄弟コンポーネントなど) との関係に基づいてコンポーネントの 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 を返します。