Dostęp do parametrów definicji maszyny w MP.NET

Deweloperzy MP.NET zawsze mogli używać Api.MPParam funkcja do wysyłania zapytań o parametry operacji MP w ich poście MP.NET. Jednak ta funkcja nie pozwala programistom na wysyłanie zapytań o parametry definicji maszyny lub parametry dla poszczególnych składników. Aby zapewnić tę funkcjonalność, do MP.NET dodano trzy nowe funkcje.

• Jedna funkcja pozwala post-deweloperowi zapytać określone komponenty lub samą definicję maszyny o wartości parametrów.

• Dwie dodatkowe funkcje odpowiadają na potrzebę zidentyfikowania konkretnego komponentu, którego parametry programista chce zapytać. Jedna funkcja sprawdza kombinację osi, w której znajduje się komponent; druga funkcja identyfikuje komponenty na podstawie ich relacji ze znanym komponentem.

Funkcja Api.MachineDefInfo

Użyj tego polecenia, aby zapytać definicję maszyny lub określone komponenty o wartości parametrów. Jest to główna funkcja dostępu do parametrów definicji maszyny, które są dostępne dla stanowisk MP (parametry 17000–17999 i 60000–64999). Użyj tego z pojedynczym argumentem, aby zapytać o ogólne ustawienia definicji maszyny lub podaj identyfikator komponentu jako drugi argument, aby zapytać o określony komponent.

Ogólna postać funkcji jest następująca:

Api.MachineDefInfo (paramNum [, componentID])

Funkcje są zdefiniowane poniżej:

• paramNum to numer parametru definicji maszyny do uzyskania dostępu. Może to być liczba lub nazwa tokena numerycznego.

• componentID (opcjonalnie) to identyfikator komponentu, do którego ma być uzyskany dostęp. Na przykład definicja maszyny może zawierać kilka komponentów tego samego typu, takich jak osie liniowe, głowice rewolwerowe lub wrzeciona. Mastercam używa tego numeru do wybrania określonego komponentu definicji maszyny do zapytania.

  Jeśli ten argument nie zostanie podany, Mastercam zapyta o ogólne ustawienia maszyny. Należą do nich informacje w oknie dialogowym Ogólne parametry maszyny i głównym oknie dialogowym Menedżer definicji maszyny .

Zazwyczaj otrzymasz żądany identyfikator komponentu z rozszerzeniem Api.AxisCombo funkcja lub Api.GetRelatedComponentID funkcjonować.

Funkcja Api.AxisCombo

Użyj tej funkcji, aby uzyskać identyfikator komponentu kombinacji osi lub komponentu w kombinacji osi. Zazwyczaj zwrócony identyfikator jest używany jako dane wejściowe dla Api.MachineDefInfo funkcjonować.

Ogólna postać funkcji jest następująca:

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

Funkcje są zdefiniowane poniżej:

• mode określa informacje, które zostaną zwrócone przez funkcję: Title, Lub ComponentID.

  • Sprecyzować Title aby zwrócić nazwę kombinacji osi.

  • Sprecyzować ComponentID aby zwrócić identyfikator komponentu w kombinacji osi lub samą kombinację osi.

    Nie dodawaj cudzysłowów wokół tego argumentu.

• spindleID to numer wrzeciona w kombinacji osi, o którą pytasz. The SpindleID token jest powszechnie używany do tego celu.

• streamID jest numerem strumienia powiązanego z kombinacją osi, której dotyczy zapytanie. The StreamID token jest powszechnie używany do tego celu.

  Zauważ, że w definicji maszyny (plik *.mcam-lmd ) identyfikatory strumieni są oparte na 1 (innymi słowy, na maszynie dwustrumieniowej strumienie to 1 i 2), ale w MP.NET są równe zeru -na podstawie (dwa strumienie to 0 i 1). Ta funkcja używa identyfikatorów strumieni MP.NET liczonych od zera.

• ComponentType (opcjonalnie) określa typ komponentu w kombinacji osi, której dotyczy zapytanie — na przykład CAxis, Chuck, Lub Turret. Poniżej przedstawiono pełną listę dozwolonych typów.

  • Jeśli uwzględnisz ten argument, Mastercam zwraca identyfikator komponentu tego typu, który jest obecny w kombinacji osi.

  • Jeśli pominiesz ten argument, Mastercam zwraca identyfikator samej kombinacji osi.

Określenie typu komponentu

Dozwolone typy komponentów są wymienione tutaj. Wartość określona w funkcji musi dokładnie pasować do poniższej listy. Nie używaj cudzysłowów.

• XAxis

• YAxis

• ZAxis

• AAxis

• BAxis

• CAxis

• RectangleTable

• Fixture

• Vise

• Chuck

• ColletChuck

• MultiHead

• PiggyBack

• WireUpperGuide

• WireLowerGuide

• ToolSpindle

• MultiTool

• Turret

• AggregateHead

• DrillBlock

• GangTool

• MTTurret

Są to typy komponentów, które są uważane za część kombinacji osi. Na przykład szczęki uchwytu lub tuleje zaciskowe nie są uważane za część kombinacji osi, a ich identyfikatory nie mogą być odzyskane za pomocą tej funkcji. Każda kombinacja osi powinna zawierać tylko jeden komponent każdego typu.

• Jeśli nie ma żadnego komponentu żądanego typu, nic nie zostanie zwrócone.

• Jeśli ComponentType podany jest argument, nie ma znaczenia, jaki jest pierwszy argument (Title Lub ComponentID)— Mastercam zawsze zwróci identyfikator komponentu.

Funkcja Api.GetRelatedComponentID

Użyj tej funkcji, aby uzyskać identyfikator komponentu na podstawie jego relacji z innym komponentem — na przykład komponentem podrzędnym lub równorzędnym. Możesz także użyć tej funkcji, aby uzyskać identyfikator komponentu, który nie znajduje się w kombinacji osi. Zazwyczaj zwrócony identyfikator jest używany jako dane wejściowe dla Api.MachineDefInfo funkcjonować.

Ogólna postać funkcji to Api.GetRelatedComponentID (navigationType, componentID [, generation]).

Funkcje są zdefiniowane poniżej:

• navigationType określa relację między komponentem, którego identyfikator jest podany, a komponentem, którego dotyczy zapytanie. Dopuszczalne wartości to Parent, FirstChild, NextSibling, PreviousSibling, Lub Root. Nie dodawaj cudzysłowów wokół tego argumentu.

• componentID jest identyfikatorem komponentu podstawowego w relacji.

• generation (opcjonalnie) reprezentuje generację do uzyskania dostępu. Jeśli ten argument nie zostanie podany, jego wartość domyślna to 1. Na przykład if navigationType Jest FirstChild a zatem ten argument wynosi 2 Mastercam znajdzie pierwsze dziecko oryginalnego komponentu początkowego, a następnie pierwsze dziecko tego komponentu, zwracając jego identyfikator.