ARES Commander provides .NET API which that lets you author third party Plugin Software for ARES Commander.
...
Creating a .NET Classic Plugin:
- Create a new C# C# or VB.NET project using the Visual Studio project creation Wizard( **minimum requirement .NET Framework v4.5)
- Browse ARES Commander installation folder and add references of From Solution Explore, add references of TD_Mgd_x.xx_xx*.dll and and FxCoreMgd_x.xx_xx.dll from Solution Explore from the ARES Commander installation folder.
You can see all available NameSpaces, Classes, Methods, and Properties in each assembly in the Object Browser.
- Rename Class1.cs to PluginCommands.cs. This changes the class Class1 to class PluginCommands, as in the following example.
- Defining a command uses Teigha.Runtime namespace to access CommandMethod method attribute and adds a method, such as AnyFunctionName that has this attribute. The following example defines the MySampleCommand command which you can run later in ARES Commander, from the command prompt.
You can define all types of in-process plugin using a similar procedure.
- Build the sample project to generate PluginCommans.dll or <YourProjectName.dll>.
- Start ARES Commander and type NETLOAD at the command prompt. Next, browse and load the plugin dll (PluginCommands.dll).
The coommand window displays a confirmation message. - Run MySampleCommand, which executes the AnyFunctionName method.
...
You can access the Document Manager from the application object.
The Document Manager has provides properties and Methods methods that let you access perform the following:
- Access the active document
...
- Add a new document
...
- Open existing drawings.
Prompting for User Input
The Editor class controls the user Input input and prints the output into command window. All related classes for prompting on the command window are available in Teigha.EditorInput namespace.
...
.NETExtension Application lets you run your code while loading the plugin. For example, you must can create the Plugin as an Extension Application to display tabs on the Ribbon or palettes while the plugin is loading in the software.
...
When you load the plugin using the NETLOAD command, public the software automatically calls public void Initialize() is automatically called. When the System unloads the plugin, it calls Terminate.
...
Third party can define .NET methods that you can use later in LISP. The following example defines the lisptest function using the LispFunction Method attribute. You can call this function using
To call the lisptest function, use the following LISP script:
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
//Method attribute to define lisp callable function 'LispTest'
//i.e (setq x (lisptest "Text created by .NET lisp function" 1.0 '(10 10 0)))
[LispFunction("lisptest")]
public ResultBuffer DoIt(ResultBuffer args)
{
// Get the database of the active document.
Database db = HostApplicationServices.WorkingDatabase;
TypedValue[] argsVal = new TypedValue[3];
if (args != null)
{
argsVal = args.AsArray();
}
else
{
argsVal[0] = new TypedValue((int)LispDataType.Text, "Default Text");
argsVal[1] = new TypedValue((int)LispDataType.Double, .2);
argsVal[1] = new TypedValue((int)LispDataType.Point3d, new Point3d(0, 0, 0));
}
// Set up transaction manager.
Teigha.DatabaseServices.TransactionManager tm = db.TransactionManager;
using (Transaction tr = tm.StartTransaction())
{
try
{
Point3d pPosition = new Point3d(0, 0, 0);
// Create a new MText object and set properties.
DBText pText = new DBText();
pText.TextString = (String)argsVal[0].Value;
pText.Height = Convert.ToDouble(argsVal[1].Value);
pText.Position = (Point3d)argsVal[2].Value;
// Get model space to add the MText object.
BlockTable pBlockTable = (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForWrite);
BlockTableRecord pModelSpace = (BlockTableRecord)tr.GetObject(pBlockTable[BlockTableRecord.ModelSpace], OpenMode.ForWrite);
// Add the object to the model space.
ObjectId id = pModelSpace.AppendEntity(pText);
tr.AddNewlyCreatedDBObject(pText, true);
// Commit changes to database.
tr.Commit();
//return created text entity to lisp
return new ResultBuffer(new TypedValue((int)LispDataType.ObjectId, id));
}
finally
{
// delete tr , managed by c# with garbage collection
}
}
} |
Migrating AutoCAD® .NET Classic Application to ARES Commander
...
Step 2: Using project Properties, select all configurations one by one and define Symbol “AutoCAD” or “ARES” for the corresponding configurations.
For AutoCAD_Release configuration:
For ARES_Release:
Step 3: Add Conditional reference assemblies to the project using Symbols,. Modify csproj file manually in the text editor to add condition for all references as in the following example.
...