Доступ к параметрам определения машины в MP.NET

Разработчики MP.NET всегда могли использовать Api.MPParam функция для запроса параметров операции MP в своем посте MP.NET. Однако эта функция не позволяет разработчикам запрашивать параметры определения машины или параметры для отдельных компонентов. Для обеспечения этой функциональности в MP.NET были добавлены три новые функции.

• Одна функция позволяет пост-разработчику запрашивать определенные компоненты или само определение машины для значений параметров.

• Две дополнительные функции предназначены для идентификации конкретного компонента, параметры которого разработчик хочет запросить. Одна функция запрашивает комбинацию осей, в которой находится компонент; вторая функция идентифицирует компоненты на основе их связи с известным компонентом.

Функция Api.MachineDefInfo

Используйте эту команду, чтобы запросить значения параметров у определения машины или определенных компонентов. Это основная функция для доступа к параметрам определения машины, которые доступны для постов MP (параметры 17000–17999 и 60000–64999). Используйте это с одним аргументом, чтобы запросить общие параметры определения компьютера, или укажите идентификатор компонента в качестве второго аргумента, чтобы запросить конкретный компонент.

Общий вид функции следующий:

Api.MachineDefInfo (paramNum [, componentID])

Функции определены ниже:

• paramNum - это номер параметра определения машины, к которому нужно получить доступ. Это может быть число или имя числового токена.

• componentID (необязательный) — идентификатор компонента для доступа. Например, в определении станка может быть несколько компонентов одного типа, таких как линейные оси, револьверные головки или шпиндели. Mastercam использует этот номер для выбора конкретного компонента определения машины для запроса.

  Если этот аргумент не указан, Mastercam будет запрашивать общие настройки машины. К ним относится информация в диалоговом окне «Общие параметры машины» и в главном диалоговом окне «Диспетчер определения машины» .

Как правило, вы получите желаемый идентификатор компонента с Api.AxisCombo функция или Api.GetRelatedComponentID функция.

Функция Api.AxisCombo

Используйте эту функцию, чтобы получить идентификатор компонента либо комбинации осей, либо компонента внутри комбинации осей. Обычно возвращаемый идентификатор используется в качестве входных данных для Api.MachineDefInfo функция.

Общий вид функции следующий:

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

Функции определены ниже:

• mode указывает информацию, которая будет возвращена функцией: Title, или ComponentID.

  • Указать Title чтобы вернуть имя комбинации осей.

  • Указать ComponentID для возврата идентификатора компонента в комбинации осей или самой комбинации осей.

    Не добавляйте кавычки вокруг этого аргумента.

• spindleID это номер шпинделя в запрашиваемой комбинации осей. SpindleID токен обычно используется для этой цели.

• streamID — это номер потока, связанного с запрашиваемой комбинацией осей. StreamID токен обычно используется для этой цели.

  Обратите внимание, что в определении машины (файл *.mcam-lmd ) идентификаторы потоков отсчитываются от 1 (другими словами, на двухпотоковой машине потоки равны 1 и 2), но внутри MP.NET они равны нулю. -основанный (два потока 0 и 1). Эта функция использует отсчитываемые от нуля идентификаторы потоков MP.NET.

• ComponentType (необязательно) указывает тип компонента в запрашиваемой комбинации осей, например, CAxis, Chuck, или Turret. Полный список разрешенных типов представлен ниже.

  • Если включить этот аргумент, Mastercam возвращает идентификатор компонента того типа, который присутствует в комбинации осей.

  • Если опустить этот аргумент, Mastercam возвращает идентификатор самой комбинации осей.

Указание типа компонента

Здесь перечислены допустимые типы компонентов. Значение, указанное с помощью функции, должно точно соответствовать приведенному ниже списку. Не используйте кавычки.

• XAxis

• YAxis

• ZAxis

• AAxis

• BAxis

• CAxis

• RectangleTable

• Fixture

• Vise

• Chuck

• ColletChuck

• MultiHead

• PiggyBack

• WireUpperGuide

• WireLowerGuide

• ToolSpindle

• MultiTool

• Turret

• AggregateHead

• DrillBlock

• GangTool

• MTTurret

Это типы компонентов, которые считаются частью комбинации осей. Например, кулачки патрона или цанги не считаются частью комбинации осей, и их идентификаторы не могут быть получены с помощью этой функции. Каждая комбинация осей должна содержать только один компонент каждого типа.

• Если компонент запрошенного типа отсутствует, то ничего не будет возвращено.

• Если ComponentType передается аргумент, не имеет значения, какой первый аргумент (Title или ComponentID)— Mastercam всегда будет возвращать идентификатор компонента.

Функция Api.GetRelatedComponentID

Используйте эту функцию, чтобы получить идентификатор компонента на основе его связи с другим компонентом, например дочерним компонентом или компонентом-одноуровневым компонентом. Вы также можете использовать эту функцию для получения идентификатора компонента, который не входит в комбинацию осей. Обычно возвращаемый идентификатор используется в качестве входных данных для Api.MachineDefInfo функция.

Общий вид функции: Api.GetRelatedComponentID (navigationType, componentID [, generation]).

Функции определены ниже:

• navigationType определяет связь между компонентом, идентификатор которого предоставляется, и компонентом, который вы запрашиваете. Допустимые значения Parent, FirstChild, NextSibling, PreviousSibling, или Root. Не добавляйте кавычки вокруг этого аргумента.

• componentID является идентификатором базового компонента в отношении.

• generation (необязательно) представляет генерацию для доступа. Если этот аргумент не указан, по умолчанию он равен 1. Например, если navigationType является FirstChild и этот аргумент равен 2, то Mastercam найдет первый дочерний элемент исходного начального компонента, а затем первый дочерний элемент этого компонента, возвращая его идентификатор.