Accès aux paramètres de définition de machine dans MP.NET

Les développeurs MP.NET ont toujours eu la possibilité d’utiliser la fonction Api.MPParam pour interroger les paramètres des opérations MP dans leur génération de code MP.NET. Toutefois cette fonction ne leur permet pas d’interroger les paramètres de définition de machine ni de composants individuels. Trois nouvelles fonctions ont été ajoutées à MP.NET de façon à offrir cette possibilité.

• La première permet aux développeurs d’interroger des composants spécifiques ou la définition de machine elle-même afin d’obtenir des valeurs de paramètres.

• Les deux autres permettent d’identifier le composant spécifique dont les développeurs souhaitent interroger les paramètres. L’une d’elles interroge la combinaison d’axes à laquelle appartient le composant, tandis que la seconde identifie les composants en fonction de leur lien avec un composant connu.

Fonction Api.MachineDefInfo

Utilisez cette commande pour interroger la définition de machine ou des composants spécifiques et obtenir des valeurs de paramètres. Il s’agit de la principale fonction d’accès aux paramètres de définition de machine, qui sont disponibles pour la génération de code MP (paramètres 17000–17999 et 60000–64999). Utilisez-la avec un argument unique pour interroger les paramètres généraux de définition de machine ou fournissez un identifiant de composant comme second argument pour interroger un composant spécifique.

Cette fonction prend généralement la forme suivante :

Api.MachineDefInfo (paramNum [, componentID])

Les fonctions sont définies comme suit :

• paramNum correspond au numéro du paramètre de définition de machine à atteindre. Il peut s’agit d’un nombre ou du nom d’un jeton numérique.

• componentID (facultatif) correspond à l’identifiant de composant à atteindre. Par exemple, si votre définition de machine comprend plusieurs types de composants similaires, comme des axes linéaires, des tourelles ou des broches, Mastercam utilise ce nombre pour sélectionner précisément le composant de définition de machine à interroger.

  Lorsque cet argument n’est pas fourni, Mastercam interroge les paramètres de machine généraux. Cela comprend les informations de la boîte de dialogue Paramètres généraux de la machine et de la boîte de dialogue principale Gestionnaire de définitions de machine.

Généralement, l’identifiant de composant souhaité est obtenu grâce aux fonctions Api.AxisCombo ou Api.GetRelatedComponentID.

Fonction Api.AxisCombo

Utilisez cette fonction pour obtenir l’identifiant de composant d’une combinaison d’axes ou d’un composant dans une combinaison d’axes. L’identifiant obtenu est généralement utilisé comme entrée pour la fonction Api.MachineDefInfo.

Cette fonction prend généralement la forme suivante :

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

Les fonctions sont définies comme suit :

• mode correspond aux informations qui seront retournées par la fonction Title ou ComponentID.

  • Utilisez la fonction Title pour obtenir le nom de la combinaison d’axes.

  • Utilisez la fonction ComponentID pour obtenir l’identifiant d’un composant dans la combinaison d’axes ou de la combinaison d’axes elle-même.

    N’ajoutez pas de guillemets autour de l’argument.

• spindleID correspond au numéro de broche dans la combinaison d’axes que vous interrogez. Le jeton SpindleID est communément utilisé à cette fin.

• streamID correspond au numéro de flux associé à la combinaison d’axes que vous interrogez. Le jeton StreamID est communément utilisé à cette fin.

  Veuillez noter que dans la définition de machine (fichier *.mcam-lmd), les identifiants de flux démarrent à partir de 1 (en d’autres termes, sur une machine à deux flux, ceux-ci porteront les numéros 1 et 2), mais qu’ils démarrent de 0 dans MP.NET (les deux flux porteraient les identifiants 0 et 1). Cette fonction utilise les identifiants de flux MP.NET, qui démarrent à partir de 0.

• ComponentType (facultatif) indique le type de composant de la combinaison d’axes que vous interrogez, par exemple CAxis (axe C), Chuck (mandrin), ou Turret (tourelle). La liste complète des types de composant pris en charge se trouve ci-dessous.

  • Lorsque vous incluez cet argument, Mastercam renvoie l’identifiant du type de composant présent dans la combinaison d’axes.

  • Si vous ne précisez pas cet argument, Mastercam renvoie l’identifiant de la combinaison d’axes elle-même.

Précision du type de composant

Les types de composant pris en charge sont référencés ci-après. La valeur indiquée via la fonction doit correspondre exactement à ce qui est indiqué ci-dessous. N’utilisez pas de guillemets.

• XAxis

• YAxis

• ZAxis

• AAxis

• BAxis

• CAxis

• RectangleTable

• Fixture

• Vise

• Chuck

• ColletChuck

• MultiHead

• PiggyBack

• WireUpperGuide

• WireLowerGuide

• ToolSpindle

• MultiTool

• Turret

• AggregateHead

• DrillBlock

• GangTool

• MTTurret

L’on considère qu’une combinaison d’axes se compose de ces types de composant. À l’inverse, les identifiants des pinces de serrage ou des collets, par exemple, qui ne font pas partie des combinaisons d’axes, ne peuvent pas être obtenus par le biais de cette fonction. Chaque combinaison d’axes n’est censée contenir qu’un seul type de chaque composant.

• Si aucun composant du type requis n’existe, aucun résultat n’est retourné.

• Lorsque l’argument ComponentType est utilisé, Mastercam renvoie toujours l’identifiant de composant, quel que soit le premier argument (Title ou ComponentID).

Fonction Api.GetRelatedComponentID

Utilisez cette fonction pour obtenir l’identifiant d’un composant d’après sa relation avec un autre composant (par ex., composant enfant ou frère). Vous pouvez également utiliser cette fonction pour obtenir l’identifiant d’un composant qui ne se trouve pas dans la combinaison d’axes. L’identifiant obtenu est généralement utilisé comme entrée pour la fonction Api.MachineDefInfo.

Cette fonction prend généralement la forme suivante : Api.GetRelatedComponentID (navigationType, componentID [, generation]).

Les fonctions sont définies comme suit :

• navigationType indique le lien qui existe entre le composant dont l’identifiant est fourni et celui que vous interrogez. Les valeurs possibles sont les suivantes : Parent, FirstChild, NextSibling, PreviousSibling, ou Root. N’ajoutez pas de guillemets autour de l’argument.

• componentID correspond à l’identifiant du composant de base de la relation.

• generation (facultatif) représente la génération souhaitée. En l’absence de cet argument, la valeur par défaut est 1. Par exemple, si navigationType est FirstChild et que la valeur de cet argument est 2, Mastercam recherche le premier enfant du composant d’origine, puis le premier enfant de ce composant et renvoie son identifiant.