AutoCAD .NET #005 Tutorial – Criando um Plug-in básico para AutoCAD

 Agora que já estamos mais ou menos familiarizados com a ferramenta do Visual Studio e como ele interage com o AutoCAD acho interessante seguir o tutorial básico da própria Autodesk para a API .NET disponível em (https://knowledge.autodesk.com/support/autocad/learn-explore/caas/simplecontent/content/lesson-1-the-basic-autocad-plug.html)

Tratam-se de 8 lições bem instrutivas de como usar as ferramentas do AutoCAD .NET para customizar o AutoCAD e expandir as possibilidades.

A primeira lição é basicamente um sumário de tudo que vimos até agora. 

Vale fazer um pequeno adendo: As linguagens vb e c# bem como F# são linguagens equivalentes, ou seja, o tutorial da Autodesk é desenvolvido em vb (visual basic) mas ele pode ser convertido usando até mesmo ferramentas online de conversão para C#. Assim vou seguir criando aqui os códigos em C# .NET mas se preferir pode fazer o download ou seguir os exemplos do próprio tutorial da Autodesk.

Criando um Plug-in básico para AutoCAD

Objetivo:

O objetivo dessa lição será: (1) rever todo o processo de criação de um projeto do zero e (2) introduzir a manipulação de propriedades de atributos de blocos, criando um comando que posiciona automaticamente os atributos de um bloco para a posição paralela ao eixo X do WCS.

Passo-a-passo de criação:

1 - Iniciando o Visual Studio 2019:

2 - Criando um projeto Novo no Visual Studio:

3 – Configurando um Novo Projeto:

4 - AutoCAD.NET Wizard Configurator:

5 - Salve o projeto:

6 – Feche e reabra o Visual Studio: Particulamente acho que esse passo não é necessário, mas para fazer um paralelo com o que foi feito na lição 1 da Autodesk coloquei esse passo aqui.

7 – Verifique as referências:

Na janela Gerenciador de Soluções no lado direito da janela expanda a opção “Referências”.

Se por algum motivo AcCoreMgd, AcMgd e AcDbMgd não estiverem listados, clique no botão Adicionar…, selecione Referência…, navegue até a pasta ... ObjectARX\inc e selecione esses arquivos. Em seguida, selecione cada referência na lista para visualizar suas propriedades na janela no canto inferior direito e defina a propriedade Copy Local como false.

8 – Adicione seu Código

Dê um clique duplo no myCommands.cs e abra-o.

Apague tudo e substitua pelo código a seguir:

using Autodesk.AutoCAD.Runtime;
using Autodesk.AutoCAD.DatabaseServices;
using Autodesk.AutoCAD.Geometry;

namespace HorizontalAttributes
{
    public class Commands
    {

        // Class variable to store the instance of our overrule
        private static KeepStraightOverrule myOverrule;

        [CommandMethod("KeepStraight")]
        public static void ImplementOverrule()
        {

            // We only want to create our overrule instance once, 
            // so we check if it already exists before we create it
            // (i.e. this may be the 2nd time we've run the command)
            if (myOverrule == null)
            {
                // Instantiate our overrule class
                myOverrule = new KeepStraightOverrule();
                // Register the overrule
                Overrule.AddOverrule(RXClass.GetClass(typeof(AttributeReference)), myOverrule, false);
            }
            // Make sure overruling is turned on so our overrule works
            Overrule.Overruling = true;
        }
    }

    // Our custom overrule class derived from TransformOverrule
    public class KeepStraightOverrule : TransformOverrule
    {

        // We want to change how an AttributeReference responds to being
        // transformed (moved, rotated, etc.), so we override its
        // standard TransformBy function.
        public override void TransformBy(Entity entity, Matrix3d transform)
        {

            // Call the normal TransformBy function for the attribute
            // reference we're overruling.
            base.TransformBy(entity, transform);
            // We know entity must be an AttributeReference because 
            // that is the only entity we registered the overrule for.
            AttributeReference attRef = entity;
            // Set rotation of attribute reference to 0 (horizontal)
            attRef.Rotation = 0.0;
        }
    }

Nas notas do código o autor diz que é possível apagar o myPlugin.cs. Eu nunca fiz isso, sempre deixei o código de inicialização para caso eu precise no futuro quando tornar a aplicação escalável. Chega a ser até um pouco contraditório porque lendo as notas geradas dentro do myPlugin.cs é mencionado que esse código serve também para algumas otimizações.

Quando ao código em si. Esse código achei até um pouco “avançado” para um exemplo básico. O que o código faz resumidamente é sobreescrever um método que já existe dentro do AutoCAD chamado TransformOverrule, esse método possuí uma função TransformBy que possui um conjunto de dois argumentos diferentes das implementações nativas do AutoCAD. Esse novo método permite que ele seja utilizado na função ImplementOverrule() sob o nome de comando KeepStraight.

Dentro do comando ImplementOverrule() ele atribui apenas uma vez o myOverrule a um novo objeto KeepStraightOverrule e depois apenas ativa a atribuição de argumentos sempre na horizontal.

8 – Compile e código.

Executando o código:

1 – Com o AutoCAD sendo executado abra o desenho “BlocksWithAttributes.dwg”.

2 – Use o comando NETLOAD para carregar a aplicação.

3 – Navegue até a pasta \debug\seuaplicativo.dll selecione e clique em Open.

4 – Teste a sua aplicação: Digite KEEPSTRAIGHT na linha de comando e pressione <Enter> . Feito isso o comando personalizado será executado. O comportamento de cada atributo em cada desenho aberto no AutoCAD agora está sendo modificado pelo seu plug-in. Para ver esse comportamento está realmente funcionando, use o comando ROTATE para girar cada uma das inserções de bloco em BlockWithAttributes.dwg. Conforme você monta o bloco, verá que seus atributos permanecem paralelos ao eixo x do UCS.

E assim você tem o seu primeiro Plug-in para AutoCAD completamente pronto e operacional. Se você quiser distribuir para alguém utilizar dentro do seu trabalho precisa apenas enviar essa DLL compilada para pessoa e ela conseguirá utilizando o NETLOAD carregar a ferramenta que você fez.

Na próxima lição veremos mais um exemplo de como utilizar a API do dotNET a nossa favor no AutoCAD

Abrindo o AutoCAD com um desenho pré-definido

Complementando um pouco, nesse projeto utilizamos o arquivo BlockWithAttributes.dwg que é o mesmo disponível na lição 1 da Autodesk, tivemos que carrega-lo manualmente no AutoCAD clicando em abrir no entanto é possível carregar esse arquivo continuamente sempre que clicar no comando de depuração no visual Studio em RUN.

Para isso vá em propriedades do projeto, Properities:

Vá na aba Depurar (debug):

Nessa aba vamos configurar dois campos: campo de Diretório de Trabalho (work directory) e Argumentos (arguments). Esses campos é configurado onde o AutoCAD está considerando o espaço de trabalho, geralmente eu coloco sempre a pasta de depuração ...Visual Studio 2013\Projects\Lesson 1 The Basic AutoCAD Plug-in\bin\Debug.

Para ele abrir o documento BlockWithAttributes.dwg automaticamente coloque o arquivo BlockWithAttributes.dwg em ...Visual Studio 2013\Projects\Lesson 1 The Basic AutoCAD Plug-in\bin\Debug.

Finalmente nos argumentos inclua o nome do arquivo que deseja abrir com aspas duplas “"blockswithattributes.dwg"”.

Pronto!” agora toda vez que você for testar sua aplicação o arquivo de teste será aberto automaticamente poupando o tempo de ir lá tentar abri-lo.

Arquivos para Download:

Lesson 1 The Basic AutoCAD Plug-in.zip 

Lesson 1 The Basic AutoCAD Plug-in.dll (compilado)

Arquivo blockswithattributes.dwg