Altium Designer API

Old Content - visit altium.com/documentation

The Altium Designer Application Programming Interface (API) exposes program functionality to external sources, such as the Altium Designer scripting system.

The API is composed of sub APIs, such as those offered by Altium Designer's range of design editors. For example the PCB editor has the PCB API, the Schematic editor has the Schematic API, the Project Manager has the Workspace manager API, Altium Designer platform has its own Client API, and so on.

Each API can compose of object interfaces, classes, routines and enumerated constants. The editor-specific APIs have their own Object Model, which in itself is a hierarchical system of Object Interfaces. These object interfaces represent Altium Designer's objects.

The Altium Designer API, its sub APIs and their Object Models

Object Model Hierarchy

Object Interfaces represent design objects, and can be used in scripts to access data in design documents that are open in Altium Designer.

Object Interfaces have properties and methods:

  • Methods of Object Interfaces are the actions an Object Interface can perform.
  • Properties of Object Interfaces represent the data contained in the object that's represented by the interface.

A parent object interface can have child object interfaces, and in turn, child object interfaces can act as parent object interfaces to child object interfaces, and so on down the chain.

This forms an Object Model Hierarchy. For example, in the Workspace Manager Object Model, the IWorkspace Object Interface is the top level interface representing the Workspace manager in Altium Designer. Projects are part of the Workspace Manager, therefore an IProject interface is a child interface to the parent IWorkspace interface.

Continuing on, documents are part of a project, so the IProject interface is the parent interface and IDocument is a child interface. Design objects such as sheet symbols, components and buses are child objects of the document object (represented by the IDocument interface).

This can be illustrated in the following simple example hierarchy:

IWorkspace
.  IProject
.  .  IDocument
.  .  .  ISheetSymbol
.  .  .  IComponent
.  .  .  IBus

The figure below is an illustration of the relationship between objects in Altium Designer, and the object Interfaces supported by the various Object Models from Altium Designer API.

Projects and the corresponding documents are managed by the Workspace Manager. A project open in Altium Designer is represented by the IProject object interface, and the documents from this project are represented by the IDocument interfaces.

As also shown, the PCB documents and PCB design objects are managed by the PCB Editor and its PCB Object Model. The open PCB document is represented by its IPCB_Board interface and the design objects, in this case the pad and track objects, are represented by IPCB_Pad and IPCB_Track interfaces.

Using the API in scripts

The scripting engine in Altium Designer has built in PCB, Schematic and Workspace Manager APIs as well as a subset of Embarcadero Delphi's Run Time Library. The PCB, Schematic, Workspace Manager Object Models from the scripting engine enable you to write scripts that act on PCB or Schematic documents, or invoke one of the file management routines.

The Object Models from the Altium Designer API are accessible in scripts, so you can code the object and method names (with appropriate parameter values) using one of the several supported scripting languages, such as EnableBasic, Visual Basic, Javascript, TCL and the most commonly-used DelphiScript (which is very much like Embarcadero Delphi).

DelphiScript Example
Procedure PadCount;
Var
 Board : IPCB_Board;
 Pad : IPCB_Primitive;
 Iterator : IPCB_BoardIterator;
 PadNumber : Integer;
Begin
 PadNumber := 0;
 Board := PCBServer.GetCurrentPCBBoard;
 If Board = Nil Then Exit;
 
 Iterator := Board.BoardIterator_Create;
 Iterator.AddFilter_ObjectSet(MkSet(ePadObject));
 Iterator.AddFilter_LayerSet(AllLayers);
 Iterator.AddFilter_Method(eProcessAll);
 
 Pad := Iterator.FirstPCBObject;
 While (Pad <> Nil) Do
 Begin
   Inc(PadNumber);
   Pad := Iterator.NextPCBObject;
 End;
 
 Board.BoardIterator_Destroy(Iterator);
 ShowMessage('Pad Count = ' + IntToStr(PadNumber));
End;

Using the API for server development

The Altium Designer scripting system implements a subset of the complete Altium Designer API and its Object Interfaces. The Altium DXP Developer, used for developing Altium Designer server Extensions, has access to the full Altium Designer API via a set of API SDK source units.

More information

You are reporting an issue with the following selected text and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.


Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Sounds exciting! Did you know we offer special discounted student licenses? For more information, click here.

In the meantime, feel free to request a free trial by filling out the form below.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.