AutoCAD 2013 .

NET API Webcast One Getting Started

About the Presenter

Wayne

Brill

Developer Technical Services Americas

Wayne has been a member of Autodesk Developer Technical services supporting ADN (Autodesk Developer Network) over eleven years. Currently, Wayne provides API support for AutoCAD, Autodesk Inventor, ETO and Vault

2012 Autodesk

Eight Sessions
1. AutoCAD .NET Basics Getting Started Wayne Brill 2. User Interaction - User Input Wayne Brill 3. Database fundamentals Fenton Webb 4. Database Events, PaletteSet Gopinath Taget 5. Dictionaries, Containers - Balaji Ramamoorthy 6. Input PointMonitor - Philippe Leefsma 7. Jigs - Philippe Leefsma 8. User Interface elements - Balaji Ramamoorthy

2012 Autodesk

Course Objective
It

is to understand:
the fundamentals of the AutoCAD .NET API how to teach yourself the AutoCAD .NET API where to get help

What

it is not:

Teach you .NET framework or C# , VB programming language Give you complete of coverage of all API functions

2012 Autodesk

Session 1 Getting Started -Objectives

See

a High level introduction to .NET

Learn

how to create an AutoCAD .NET application

2012 Autodesk

High Level .NET Overview

2012 Autodesk

.NET Framework
VB C++ C# JScript Visual Studio 2008 / 2010

Common Language Specification ASP.NET

Windows Forms

Data and XML

Base Class Library

Common Language Runtime

2012 Autodesk

.NET key components

Common
Interprets

Language Runtime (CLR)

IL code created by the compiler Provides a common execution environment for .NET apps Code that runs in the CLR is Managed code
Framework
Object

Class Library (FCL)

Oriented Collection of re-usable types

2012 Autodesk

CLR Execution Model

Source code Compiler Managed Code (dll or exe) VB vbc.exe C# csc.exe C++ cc.exe

Assembly IL Code

Assembly IL Code

Assembly IL Code

Common Language Runtime

JIT Compiler
Native Code

Operating System Services

2012 Autodesk

.NET Assemblies
Assembly
A IL

Contains:

manifest that describes the assembly code. (Intermediate language)

CLR

ensures:
methods are called in a type safe manner

That

That

other items the assembly needs are available

For
2012 Autodesk

AutoCAD the assembly is a DLL

.NET Debugging Tools

Reflector

Browse .NET assemblies, disassemble, decompile

http://www.reflector.net/ Ildasm

Disassemble .NET assemblies

Location - C:\Program Files\Microsoft SDKs\Windows\v7.0A\bin

Fuslogvw

Diagnose load time problems

Location - C:\Program Files\Microsoft SDKs\Windows\v7.0A\bin

FxCop

Check conformance with Design Guidelines http://msdn.microsoft.com/en-us/library/bb429476(VS.80).aspx Install - C:\Program Files\Microsoft SDKs\Windows\v7.0A\FXCop

2012 Autodesk

Links for .NET

MSDN - Visual Basic Developer Center

http://msdn.microsoft.com/en-us/vbasic/default.aspx

MSDN C# Developer Center

http://msdn.microsoft.com/en-us/vcsharp/default.aspx Training videos, Download Visual Studio express

Microsoft .NET Framework Primer for the Visual Basic Developer

http://msdn.microsoft.com/library/aa730858.aspx#netvbde v01_topic7

2012 Autodesk

How to create an AutoCAD .NET application

2012 Autodesk

Development Environment

Microsoft Visual Studio 2010 (SP1)

AutoCAD 2013

Microsoft Windows 7 Microsoft Windows XP Microsoft Windows vista

2012 Autodesk

AutoCAD .NET API Resources

AutoCAD Developer Center

http://usa.autodesk.com/adsk/servlet/index?siteID=123112&id=1911627

AutoCAD .NET 2013 Training

(This is the training to use with this series) (Use this if just getting started with .NET)

My First AutoCAD Plug-in

AutoCAD .NET Users Guide AutoCAD .NET Wizards ObjectARX SDK

NET SDK Samples, Classmap.dwg, Managed Reference Guide

AutoCAD DevBlog
http://adndevblog.typepad.com/autocad/

DevTVs Other Blog posts on AutoCAD .NET

2012 Autodesk

Visual Studio project settings Hello World!

Start with a Class Library application type with DLL output. Add references to AutoCADs managed assemblies

acdbmgd.dll

Database

services and DWG file manipulation (like ObjectDBX) Application specific core logic

acmgd.dll

AutoCAD
accoremgd.dll

AutoCAD

Find them in the AutoCAD install folder (set COPY LOCAL = FALSE)

C:\Program Files\AutoCAD 2013 C:\ObjectARX 2013\inc

2012 Autodesk

How does a plugin for AutoCAD work ?

Reference to AutoCAD DLLs. Use it from ObjectARX INC folder

Code witten in Visual Basic .NET

Project VB.NET

Compile

Assembly (.dll)
2012 Autodesk

Load inside AutoCAD with NETLOAD

Start Hello World Demo project

2012 Autodesk

Namespaces
Add
In In

the namespaces you will be using

VB using the Imports keyword C# use the using keyword

AutoCAD

Namespaces used in most Apps

Autodesk.AutoCAD.ApplicationServices Autodesk.AutoCAD.Runtime Autodesk.AutoCAD.EditorInput

Available

2012 Autodesk

when AutoCAD managed dlls referenced

acmgd.dll, acdbmgd.dll & accoremgd.dll

Add an AutoCAD command using an Attribute

Make a procedure an AutoCAD command by adding an attribute

<CommandMethod("HelloWorld")> _ Public Sub HelloWorld() End Sub

An attribute is added to the metadata for that procedure

CommandMethod or CommandMethodAttribute type accepts several parameters in its constructor such as group name, global and local names, command flags and more (Use the object browser)

2012 Autodesk

AutoCAD Editor Print string to command line

Get the editor object for the active document Call the editors WriteMessage method
<CommandMethod("HelloWorld")> _ Public Sub HelloWorld()

Dim ed As Editor ed = Application.DocumentManager. _ MdiActiveDocument.Editor ed.WriteMessage("Hello World")

End Sub

2012 Autodesk

Recap the steps

1. Start with a Class Library application type (DLL) 2. Add references to AutoCADs managed assemblies

acdbmgd.dll, acmgd.dll & accoremgd.dll

3. Add the namespaces

In VB use Imports keyword, in .C# use the using keyword

4. Add an AutoCAD command using CommandMethod attribute.

5. Create the procedure that will run when the command is run in AutoCAD

using the classes from the AutoCAD managed assemblies.

2012 Autodesk

(acmgd.dll, acdbmdg.dll & accoremgd.dll)

Complete & run Hello World project

2012 Autodesk

Loading .NET assembly

NETLOAD command AUTOLOADER Startup On command invocation Demand Load (Registry) Startup On command invocation On request

From another application

On proxy detection

[HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD\R19.0\ACADB001:409\Applications\AcLayer] "DESCRIPTION"="AutoCAD Layer Manager" "LOADER"="C:\\Program Files\\AutoCAD 2013\\aclayer.dll" "LOADCTRLS"=dword:0000000e "MANAGED"=dword:00000001 [HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD\R19.0\ACADB001:409\Applications\AcLayer\Commands] "LAYER"="LAYER [HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD\R19.0\ACADB001:409\Applications\AcLayer\Groups] "ACLAYER_CMDS"="ACLAYER_CMDS

Use Installers to set these keys!

2012 Autodesk

AutoLoader

AutoCAD loads bundles from %appdata%\Autodesk\ApplicationPlugins

Each bundle has PackageContents.xml

2012 Autodesk

Autodesk Exchange Apps

http://usa.autodesk.com/adsk/servlet/item?siteID=123112&id=20143020 DevTV Autoloader Format Explained

2012 Autodesk

How to use the Labs

VB.NET

and C# labs Can be done in two ways

1. Do everything in your own projects Use the provided Doc file for overview Copy and paste the Lab steps 2. Use the Lab Projects Use the provided Doc file for overview Use lab steps in the provided projects

Completed

Labs are provided for reference

2012 Autodesk

Next Week - User Interaction / User Input

Thank You !

2012 Autodesk