Acesso a parâmetros de definição de máquina no MP.NET

Os desenvolvedores de MP.NET sempre puderam usar a função Api.MPParam para consultar parâmetros de operação MP no pós-processador MP.NET. No entanto, essa função não permite que os desenvolvedores consultem parâmetros de definição de máquina ou parâmetros de componentes individuais. Foram adicionadas três novas funções ao MP.NET para fornecer essa funcionalidade.

• Uma das funções permite que o desenvolvedor de pós-processamento consulte valores de parâmetro dos componentes específicos ou da própria definição de máquina.

• Duas funções adicionais tratam da necessidade de identificar o componente específico cujos parâmetros o desenvolvedor deseja consultar. Uma função consulta a combinação de eixos na qual o componente reside e a outra função identifica componentes com base em sua relação com um componente conhecido.

Função Api.MachineDefInfo

Use este comando para consultar os valores de parâmetro da definição de máquina ou de componentes específicos. Esta é a função principal de acesso aos parâmetros da definição de máquina disponíveis para pós-processadores MP (parâmetros 17000–17999 e 60000–64999). Use-a com um único argumento para consultar as configurações gerais da definição de máquina ou para fornecer um ID de componente como o segundo argumento para consultar um componente específico.

A forma geral da função é esta:

Api.MachineDefInfo (paramNum [, componentID])

As funções estão definidas abaixo:

• paramNum é o número do parâmetro da definição de máquina a ser acessado. Pode ser um número ou o nome de um token numérico.

• componentID (opcional) é o ID do componente a ser acessado. Por exemplo, a definição de máquina pode ter vários componentes do mesmo tipo, como eixos lineares, torres ou fusos. O Mastercam usa esse número para selecionar o componente específico da definição de máquina a ser consultado.

  Se esse argumento não for fornecido, o Mastercam consultará as configurações gerais da máquina. Isso inclui as informações da caixa de diálogo Parâmetros gerais da máquina e da caixa de diálogo principal Gerenciador de definição de máquina.

Normalmente, você obtém o ID do componente desejado com a função Api.AxisCombo ou Api.GetRelatedComponentID.

Função Api.AxisCombo

Use esta função para obter o ID de componente de uma combinação de eixos ou um componente dentro de uma combinação de eixos. Normalmente, o ID retornado é usado como entrada para a função Api.MachineDefInfo.

A forma geral da função é esta:

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

As funções estão definidas abaixo:

• mode especifica as informações que serão retornadas pela função: Title ou ComponentID.

  • Especifique Title para retornar o nome da combinação de eixos.

  • Especifique ComponentID para retornar o ID de um componente na combinação de eixos ou a própria combinação de eixos.

    Não acrescente aspas nesse argumento.

• spindleID é o número do fuso na combinação de eixos que você está consultando. O token de SpindleID é geralmente usado para essa finalidade.

• streamID é o número do fluxo associado à combinação de eixos que você está consultando. O token de StreamID é geralmente usado para essa finalidade.

  Observe que na definição de máquina (arquivo *.mcam-lmd), os IDs de fluxo começam com 1 (ou seja, em uma máquina de fluxo duplo, os fluxos são 1 e 2), mas dentro do MP.NET eles começam com zero (os dois fluxos são 0 e 1). Esta função usa os IDs de fluxo do MP.NET que começam com zero.

• ComponentType (opcional) especifica o tipo de componente na combinação de eixos que você está consultando, por exemplo, CAxis, Chuck ou Turret. Uma lista completa de tipos permitidos está apresentada abaixo.

  • Se você incluir este argumento, o Mastercam retornará o ID do componente desse tipo presente na combinação de eixos.

  • Se este argumento for omitido, o Mastercam retornará o ID da própria combinação de eixos.

Especificação do tipo de componente

Os tipos de componente permitidos estão listados aqui. O valor especificado com a função precisa corresponder exatamente à lista abaixo. Não use aspas.

• XAxis

• YAxis

• ZAxis

• AAxis

• BAxis

• CAxis

• RectangleTable

• Fixture

• Vise

• Chuck

• ColletChuck

• MultiHead

• PiggyBack

• WireUpperGuide

• WireLowerGuide

• ToolSpindle

• MultiTool

• Turret

• AggregateHead

• DrillBlock

• GangTool

• MTTurret

Esses são os tipos de componente considerados partes de uma combinação de eixos. Por exemplo, castanhas da placa ou pinças não são consideradas partes da combinação de eixos e seus IDs não podem ser recuperados com esta função. Cada combinação de eixos deve conter apenas um de cada tipo de componente.

• Se nenhum componente do tipo solicitado estiver presente, nada não será retornado.

• Se for fornecido um argumento ComponentType, não importa qual seja o primeiro argumento (Title ou ComponentID), o Mastercam sempre retornará o ID do componente.

Função Api.GetRelatedComponentID

Use esta função para obter o ID de um componente com base em sua relação com outro componente, por exemplo, um componente secundário ou de mesma hierarquia. Use esta função também para obter o ID de um componente que não está em uma combinação de eixos. Normalmente, o ID retornado é usado como entrada para a função Api.MachineDefInfo.

A forma geral da função é Api.GetRelatedComponentID (navigationType, componentID [, generation]).

As funções estão definidas abaixo:

• navigationType especifica a relação entre o componente cujo ID foi fornecido e o componente que você está consultando. Os valores permitidos são Parent, FirstChild, NextSibling, PreviousSibling ou Root. Não acrescente aspas nesse argumento.

• componentID é o ID do componente base na relação.

• generation (opcional) representa a geração para acesso. Se este argumento não for fornecido, será usado 1 como padrão. Por exemplo, se navigationType for FirstChild e o argumento for 2, o Mastercam localizará o primeiro secundário do componente inicial original e depois o primeiro secundário desse componente, retornando o respectivo ID.