SOLIDOS API

O SOLIDOS conta com uma API para o Dynamo e Visual Lisp, que possibilita a criação de objetos, bem como a manipulação de propriedades

Para usar a API no Dynamo, é preciso carregar ela no editor do Dynamo. Acesse o menu Dynamo/Preferences:

Na tela que se abre, clique o botão Add Path:

E localize a pasta com o pacote correta para sua versão do Civil 3D:

No exemplol estou usando o Civil 3D 2025, então escolho a pasta SOLIDOS.bundle/Dynamo/2025/.

Ao fechar estas duas telas e retornar a área do Dynamo, será mostrado em Add ons:

Note: Use o comando SOLIDOSABOUT para localizar onde você instalou o SOLIDOS. Normalmente o plugin está instalado em:

Para melhor compreender e usar as funções da API do SOLIDOS, sempre observe a ajuda. Cada classe tem uma série de propriedades. Elas estão descritas sempre da seguinte forma:

• Categoria
  • Nome Amigável (Nome, Tipo) - Descrição da propriedade

Assim, observe que, para acessar uma propriedade qualquer, deve usar o Nome da propriedade (Id, Name, Description...) como uma string. O tipo da propriedade também está descrito.

• Em Visual Basic, será algo assim:
  Dim valor As Tipo = SolidosGetNodeParam(handle, "Name", Nothing)
• Em Visual Lisp:
  (setq valor (SolidosGetNodeParam handle "Name" nil))
• No Dynamo:
  valor = SolidosAPI.SolidosGetNodeParam(handle, "Name", null);

A API se subdivide nas seguintes funções:

• SolidosFindObjectByName - Busca um objeto do SOLIDOS pelo seu nome
• SolidosGetRootNode - Retorna um identificador de nó raiz
• SolidosConnectNodes - Conecta uma bacia/dispositivo/setor a outra bacia/dispositivo/setor
• SolidosDisConnectNodes - Desconecta uma bacia/dispositivo/setor de outra bacia/dispositivo/setor
• SolidosCreateNode - Cria um item do SOLIDOS
• SolidosGetChildNames - Retorna a lista dos nomes do itens filhos do item especificado
• SolidosGetNodeParam - Retorna o valor de uma propriedade de um objeto do SOLIDOS
• SolidosGetPropertyType - Retorna o tipo de uma propriedade de um objeto do SOLIDOS
• SolidosSetNodeParams - Define os valores das propriedades de um item do SOLIDOS
• SolidosFindShortestPath - Retorna a menor rota entre dois dispositivos
• SolidosCommit - Força a reconstrução de dispositivos e cálculos que sóseriam feito ao término do comando/script
• SolidosGetPointAt - Retorna um ponto em um parâmetro específico de um dispositivo linear ou longitudinal
• SolidosGetParameterAtPoint - Retorna o parâmetro de um ponto projetado sobre o eixo 3D de um dispositivo linear ou longitudinal
• SolidosListProperties - Lista as propriedades de um objeto ou tipo de objeto do SOLIDOS
• SolidosGetPropertyInfo - Retorna um dicionário com informações sobre uma propriedade de um objeto ou tipo de objeto

Dica: Carregue o plugin (<pasta de instalação do SOLIDOS>/Visual Lisp/SLIST.LSP) e use-o como ocomando LIST do AutoCAD para inspecionar informações sobre as propriedades do item do SOLIDOS selecionado, tais como:

• Category - O nome da categoria da propriedade
• DisplayName - O nome amigável da propriedade
• Description - A descrição da propriedade
• PropertyType - O tipo da propriedade
• ReadOnly - Indica se a propriedade é editável ou não
• IsEnum - Indica se a propriedade é um tipo de enumerador
• Values - Os valores possíveis para a propriedade, quando IsEnum é verdadeiro