{"id":528,"date":"2013-07-01T11:01:16","date_gmt":"2013-07-01T11:01:16","guid":{"rendered":"https:\/\/blogs.autodesk.com\/autodesk-infrabrasil\/2013\/07\/01\/comeando-com-apis-civil-3d\/"},"modified":"2016-05-17T13:30:22","modified_gmt":"2016-05-17T16:30:22","slug":"comeando-com-apis-civil-3d","status":"publish","type":"post","link":"https:\/\/blogs.autodesk.com\/mundoaec\/comeando-com-apis-civil-3d\/","title":{"rendered":"Come\u00e7ando com APIs Civil 3D"},"content":{"rendered":"

Por Augusto Gon\u00e7alves<\/strong>, Autodesk Developer Network<\/a><\/p>\n

Para quem n\u00e3o p\u00f4de participar dos treinamentos<\/a> na Autodesk, nesta sequ\u00eancia de posts irei abordar os passos necess\u00e1rios para criar um plug-in para o Civil 3D que gera relat\u00f3rios e automatiza algumas tarefas cotidianas.<\/p>\n

Este primeiro post abordar\u00e1 os requisitos, conhecimentos b\u00e1sicos e como criar o \u2018esqueleto\u2019 geral. Na sequ\u00eancia, irei abordar os comandos com aplica\u00e7\u00e3o espec\u00edfica.<\/p>\n

Requisitos<\/span><\/strong><\/p>\n

A plataforma de desenvolvimento utilizada nos treinamentos \u00e9 o Visual Basic .NET, dispon\u00edvel gratuitamente para treinamento na vers\u00e3o Express. Para o Civil 3D 2012, 2013 e 2014, utilizamos a vers\u00e3o Visual Basic 2010. Apesar de atualmente a vers\u00e3o 2012 estar dispon\u00edvel, a vers\u00e3o suportada \u00e9 a 2010. O download est\u00e1 dispon\u00edvel em http:\/\/www.microsoft.com\/visualstudio\/ptb\/downloads#d-2010-express<\/a> (ou direto em http:\/\/go.microsoft.com\/?linkid=9709929<\/a>).<\/p>\n

\"Visual<\/a><\/p>\n

Conhecimentos b\u00e1sicos<\/span><\/strong><\/p>\n

Conhecimentos em VB.NET s\u00e3o recomendados. Existem diversos tutoriais na internet, v\u00e1rios livros e artigos. Um material interessante \u00e9 o nosso My First AutoCAD Plugin<\/a>, que passa conceitos de VB.NET e API AutoCAD. Como o Civil 3D \u00e9 baseado em AutoCAD, estes conhecimentos ser\u00e3o aplic\u00e1veis e \u00fateis.<\/p>\n

Criando um Plugin<\/span><\/strong><\/p>\n

M\u00e3os a obra! Abra o Visual Basic 2010 Express<\/strong> e escolha a op\u00e7\u00e3o \u2018New Project\u2019. O projeto \u00e9 a unidade b\u00e1sica para se criar um plugin, e cada projeto criado ir\u00e1 gerar uma DLL que poder\u00e1 ser carregada no Civil 3D. Neste curso, nunca abra um arquivo .vb avulso, este n\u00e3o cont\u00e9m os dados necess\u00e1rios, abra sempre o projeto via menu \u2018Open Project\u2019.<\/p>\n

\"Menu<\/a><\/p>\n

Agora selecione a op\u00e7\u00e3o \u2018Class Library\u2019, que significa que este projeto ir\u00e1 gerar uma DLL como resultado. D\u00ea um nome para o projeto, neste exemplo \u2018ProjetoCivil3DBR\u2019. No nome, n\u00e3o utilize espa\u00e7os e\/ou caracteres especiais (acento, pontua\u00e7\u00e3o, etc.).<\/p>\n

\"Formul\u00e1rio<\/a><\/p>\n

Por limita\u00e7\u00e3o, a vers\u00e3o Express n\u00e3o pergunta onde o projeto ser\u00e1 salvo. Para escolher, v\u00e1 ao menu e escolha \u2018Save All\u2019 (ou Ctrl+Sifth+S). Escolha uma pasta do seu computador. Evite pastas remotas ou na rede, o .NET bloqueia estas op\u00e7\u00f5es.<\/p>\n

Com o projeto aberto, a tela do Visual Basic 2010 Express deve ser algo como a tela abaixo. Note o Solution Explorer<\/em> ao lado direito, caso n\u00e3o veja esta tela, selecione no menu View<\/em>, submenu Other Windows<\/em>. Todos os arquivos .vb dispon\u00edveis estar\u00e3o listados nesta aba.<\/p>\n

\"Tela<\/a><\/p>\n

Para criarmos c\u00f3digos espec\u00edficos para o Civil 3D \u00e9 necess\u00e1rio incluir as bibliotecas (ou DLL do ingl\u00eas Dynamic Link Library<\/em>), dispon\u00edveis na pasta onde foi instalado. Clique 2x em My Project<\/em> da aba Solution Explorer<\/em>. Na janela que se abrir\u00e1, selecione a aba References <\/em>e finalmente clique em Add<\/em> para adicionar as bibliotecas.<\/p>\n

\"Lista<\/a><\/p>\n

No formul\u00e1rio de Add Reference<\/em> da figura abaixo, selecione as refer\u00eancias (ou bibliotecas) do AutoCAD AcMgd<\/strong>, AcDbMgd<\/strong> e AcCoreMgd<\/strong> e as refer\u00eancias do Civil 3D AecBaseMgd<\/strong> e AeccDbMgd<\/strong>. Note que na vers\u00e3o Civil 3D 2012 (e anteriores) n\u00e3o existe a AcCoreMgd.<\/p>\n

\"Adicionando<\/a><\/p>\n

Finalmente marque as refer\u00eancias como Copy Local<\/em> igual a False <\/em>na aba Property.<\/em> Caso n\u00e3o veja esta aba, habilite atrav\u00e9s do menu View, Other Windows.<\/em> Este procedimento \u00e9 necess\u00e1rio para que o Civil 3D execute corretamente o plugin.<\/p>\n

\"Op\u00e7\u00e3o<\/a><\/p>\n

Est\u00e1 conclu\u00edda a etapa de configura\u00e7\u00e3o do projeto, que pode ser reutilizada para qualquer novo projeto VB.NET para o AutoCAD Civil 3D. Podemos come\u00e7ar com o c\u00f3digo (rotina) que ir\u00e1 executar as opera\u00e7\u00f5es que desejamos.<\/p>\n

Nosso primeiro comando: contar corredores<\/strong><\/span><\/p>\n

O objetivo deste post n\u00e3o \u00e9 criar um comando funcional ou complexo, mas apenas preparar a funda\u00e7\u00e3o. Ent\u00e3o o comando deste exemplo ser\u00e1 bem simples, com objetivo de verificar que tudo funciona: contar a quantidade de corredores no documento (projeto) e mostrar na linha de comando do Civil 3D.<\/p>\n

Para o Civil 3D, cada rotina public sub <\/em>\u00e9 um comando. Este deve conter uma marca\u00e7\u00e3o especial (atributo do .NET) indicando o nome que ser\u00e1 executado, neste caso contarCorredores. <\/em>Note que este nome n\u00e3o pode conter espa\u00e7os.<\/p>\n

Na figura abaixo pode ser visto o Class1.vb <\/strong>com o c\u00f3digo. Abaixo da figura est\u00e1 o respectivo c\u00f3digo, copie e cole no Visual Basic 2010 Express. Retire eventuais linhas em branco remanescentes\u2026<\/p>\n

\"C\u00f3digo<\/a><\/p>\n

\n

Imports<\/span><\/span> Autodesk.AutoCAD.Runtime<\/span><\/span><\/p>\n

Imports<\/span><\/span> Autodesk.AutoCAD.ApplicationServices<\/span><\/span><\/p>\n

Imports<\/span><\/span> Autodesk.AutoCAD.EditorInput<\/span><\/span><\/p>\n

\u00a0<\/span><\/span><\/p>\n

Imports<\/span><\/span> Autodesk.Civil.ApplicationServices<\/span><\/span><\/p>\n

\u00a0<\/span><\/span><\/p>\n

Public<\/span><\/span> Class<\/span> <\/span>Class1<\/span><\/span><\/p>\n

\u00a0 <<\/span><\/span>CommandMethod<\/span>(<\/span>“contarCorredores”<\/span>)> _<\/span><\/span><\/span><\/p>\n

\u00a0 <\/span><\/span>Public<\/span> Sub<\/span> CmdQuantidadeCorredores()<\/span><\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>‘ acessar o Editor (linha de comando)<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>Dim<\/span> ed <\/span>As<\/span> Editor<\/span> = <\/span>Application<\/span>.<\/span><\/span><\/span>DocumentManager.<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 MdiActiveDocument.<\/span><\/span>Editor<\/span><\/span><\/p>\n

\u00a0<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>‘ acessar o CivilDocument, que gerencia <\/span><\/span>os dados do Civil 3D<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>Dim<\/span> civilDoc <\/span>As<\/span> CivilDocument<\/span> = <\/span><\/span><\/span>CivilApplication<\/span>.ActiveDocument<\/span><\/span><\/span><\/p>\n

\u00a0<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>‘ finalmente escrevemos a quantidade<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 <\/span><\/span>‘ de corredores neste documento<\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0 ed.WriteMessage(<\/span><\/span>“Projeto cont\u00eam {0} corredores”<\/span>,<\/span><\/span><\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 civilDoc.CorridorCollection.Count)<\/span><\/span><\/p>\n

\u00a0 <\/span><\/span>End<\/span> <\/span>Sub<\/span><\/span><\/p>\n

End<\/span><\/span> Class<\/span><\/span><\/p>\n<\/div>\n

O Civil 3D n\u00e3o reconhece c\u00f3digo, apenas DLL. Ent\u00e3o \u00e9 necess\u00e1rio \u201cconstruir\u201d uma DLL atrav\u00e9s do comando Build<\/em> no menu Debug. <\/em>Esta op\u00e7\u00e3o ir\u00e1 gerar um arquivo .dll na pasta onde o projeto foi salvo, conforme o caminho listado abaixo.<\/p>\n

\u2026\\ProjetoCivil3DBR\\ProjetoCivil3DBR\\bin\\Release\\ProjetoCivil3DBR.dll<\/strong><\/p>\n

\"Menu<\/a><\/p>\n

Estamos prontos para executar este comando no Civil 3D!<\/p>\n

Inicie o Civil 3D e, preferencialmente, abra um .dwg que contenha um corredor. Para carregar um plugin\u00a0 .NET execute o comando NETLOAD. Escolha a .dll criada pelo projeto (neste exemplo a ProjetoCivil3DBR.dll<\/strong>). Ao carregar, o Civil 3D 2014 deve exibir uma mensagem relacionada a seguran\u00e7a. Para este exemplo, clique em Load<\/em>. Para mais detalhes de seguran\u00e7a, veja este post<\/a>. Execute nosso comando customizado CONTARCORREDORES. O resultado deve ser como mostrado abaixo.<\/p>\n

\"Linha<\/a><\/p>\n

Parab\u00e9ns! Plugin completo!<\/strong><\/p>\n

No pr\u00f3ximo post iremos adicionar mais c\u00f3digo para criar um relat\u00f3rio de tra\u00e7ado horizontal, tabelas de curva de bordo e outros.<\/p>\n

Leitura para a semana<\/span><\/strong><\/p>\n

Alguns t\u00f3picos adicionais de programa\u00e7\u00e3o para AutoCAD e Civil 3D:<\/p>\n