PCB API Constants and Functions

Now reading version 19.0. For the latest, read: PCB API Constants and Functions for version 22

Parent page: Technical Reference - PCB API

Please note that this documentation was last updated for an older version of Altium Designer. While many of the principles and approaches will remain the same, be aware that interfaces, objects, methods, properties, and the like will have changed since then, and will not reflect the entirety of those found in later versions of the software.

PCB API: Constants and Functions Reference

The PCB API Constants and Functions reference includes the following sections and content:

PCB Constants PCB Functions
PCB Constants
AllLayers
AllObjects
AllPrimitives
cAdvPCB
cBoardSideStrings constant
cComonentCollisionCheckModeStrings constant
cDefaultLayerDrawingOrder constant
cDir_NONE
cDir_ANY
cDir_Diagonal
cDir_HorVert
cLayerStrings
cMaxTestPointStyle
cMinTestPointStyle
cMidLayers
cMinLayer_WidthRule
cMaxLayer_WidthRule
cRoutingWidthModeStrings
cRuleIdStrings
cTextAutopositionStrings
cTestPointPriorityHigh
cTestPointPriorityLow
cWidthRuleLayers
FirstObjectId
InternalUnits
InternalPlanes
kDiameterSymbolANSI
kDiameterSymbolUnicode
kDegreeSymbol
k1Inch
kDefaultArcResolution
k1Mil
kMaxCoord
kMinCoord
kMaxInternalPlane
kMinInternalPlane
kMaxPolySize
LastObjectId
kMaxStrokes
MaxLayer
MaxBoardLayer
MaxLogicalTextSize
MaxRouteLayer
MaxMechanicalLayer constant
MechanicalLayers
MinLayer
MinMechanicalLayer constant
Numbers
WideStringObjects
PCB Messages
SignalLayers
Unit conversion functions
Angle and Trigonometric functions
Object Boundary Functions
Layer conversion functions
Font Functions
Locale Functions
General Functions

 

PCB Constants

AllLayers

AllLayers = [MinLayer..eConnectLayer];

AllObjects

AllObjects = [FirstObjectId..LastObjectId];

AllPrimitives

AllPrimitives = [ eArcObject         ,
                  eViaObject         ,
                  eTrackObject       ,
                  eTextObject        ,
                  eFillObject        ,
                  ePadObject         ,
                  eComponentObject   ,
                  eNetObject         ,
                  ePolyObject        ,
                  eDimensionObject   ,
                  eCoordinateObject  ,
                  eEmbeddedObject    ,
                  eEmbeddedBoardObject,
                  eFromToObject      ,
                  eConnectionObject,
                  ePolyRegionObject,
                  eComponentBodyObject
                  ];

cAdvPCB

cAdvPCB = 'AdvPCB';

cBoardSideStrings constant

cBoardSideStrings : Array [TBoardSide] Of String[20] =
('Top Side','Bottom Side');

cComonentCollisionCheckModeStrings constant

cComponentCollisionCheckModeStings : Array [TComponentCollisionCheckMode] Of String[22]= ('Quick Check Mode','Multi-Layer Check Mode','Full Check Mode','Component Body Mode');

cDefaultLayerDrawingOrder constant

cDefaultLayerDrawingOrder : TDrawingOrderArray = (
eBackGroundLayer,
eMultiLayer,
eTopOverlay,
eBottomOverlay,
eConnectLayer,
eNoLayer,
eTopLayer,
eMidLayer1,
eMidLayer2,
eMidLayer3,
eMidLayer4,
eMidLayer5,
eMidLayer6,
eMidLayer7,
eMidLayer8,
eMidLayer9,
eMidLayer10,
eMidLayer11,
eMidLayer12,
eMidLayer13,
eMidLayer14,
eMidLayer15,
eMidLayer16,
eMidLayer17,
eMidLayer18,
eMidLayer19,
eMidLayer20,
eMidLayer21,
eMidLayer22,
eMidLayer23,
eMidLayer24,
eMidLayer25,
eMidLayer26,
eMidLayer27,
eMidLayer28,
eMidLayer29,
eMidLayer30,
eBottomLayer,
eTopPaste,
eBottomPaste,
eTopSolder,
eBottomSolder,
eInternalPlane1,
eInternalPlane2,
eInternalPlane3,
eInternalPlane4,
eInternalPlane5,
eInternalPlane6,
eInternalPlane7,
eInternalPlane8,
eInternalPlane9,
eInternalPlane10,
eInternalPlane11,
eInternalPlane12,
eInternalPlane13,
eInternalPlane14,
eInternalPlane15,
eInternalPlane16,
eDrillGuide,
eKeepOutLayer,
eMechanical1,
eMechanical2,
eMechanical3,
eMechanical4,
eMechanical5,
eMechanical6,
eMechanical7,
eMechanical8,
eMechanical9,
eMechanical10,
eMechanical11,
eMechanical12,
eMechanical13,
eMechanical14,
eMechanical15,
eMechanical16,
eDrillDrawing,
eGridColor1,
eBackGroundLayer,
eBackGroundLayer,
eBackGroundLayer,
eBackGroundLayer,
eBackGroundLayer);

cDir_NONE

cDir_NONE     = [];

cDir_ANY

cDir_ANY      = [eDir_N..eDir_NW];

cDir_Diagonal

cDir_Diagonal = [eDir_NE, eDir_SE, eDir_SW, eDir_NW];

cDir_HorVert

cDir_HorVert  = cDir_ANY - cDir_Diagonal;

cLayerStrings

cLayerStrings : Array[TLayer] Of String
              = ( 'NoLayer'        ,
                  'TopLayer'       ,
                  'MidLayer1'      ,
                  'MidLayer2'      ,
                  'MidLayer3'      ,
                  'MidLayer4'      ,
                  'MidLayer5'      ,
                  'MidLayer6'      ,
                  'MidLayer7'      ,
                  'MidLayer8'      ,
                  'MidLayer9'      ,
                  'MidLayer10'     ,
                  'MidLayer11'     ,
                  'MidLayer12'     ,
                  'MidLayer13'     ,
                  'MidLayer14'     ,
                  'MidLayer15'     ,
                  'MidLayer16'     ,
                  'MidLayer17'     ,
                  'MidLayer18'     ,
                  'MidLayer19'     ,
                  'MidLayer20'     ,
                  'MidLayer21'     ,
                  'MidLayer22'     ,
                  'MidLayer23'     ,
                  'MidLayer24'     ,
                  'MidLayer25'     ,
                  'MidLayer26'     ,
                  'MidLayer27'     ,
                  'MidLayer28'     ,
                  'MidLayer29'     ,
                  'MidLayer30'     ,
                  'BottomLayer'    ,
                  'TopOverlay'     ,
                  'BottomOverlay'  ,
                  'TopPaste'       ,
                  'BottomPaste'    ,
                  'TopSolder'      ,
                  'BottomSolder'   ,
                  'InternalPlane1' ,
                  'InternalPlane2' ,
                  'InternalPlane3' ,
                  'InternalPlane4' ,
                  'InternalPlane5' ,
                  'InternalPlane6' ,
                  'InternalPlane7' ,
                  'InternalPlane8' ,
                  'InternalPlane9' ,
                  'InternalPlane10',
                  'InternalPlane11',
                  'InternalPlane12',
                  'InternalPlane13',
                  'InternalPlane14',
                  'InternalPlane15',
                  'InternalPlane16',
                  'DrillGuide'     ,
                  'KeepOutLayer'   ,
                  'Mechanical1'    ,
                  'Mechanical2'    ,
                  'Mechanical3'    ,
                  'Mechanical4'    ,
                  'Mechanical5'    ,
                  'Mechanical6'    ,
                  'Mechanical7'    ,
                  'Mechanical8'    ,
                  'Mechanical9'    ,
                  'Mechanical10'   ,
                  'Mechanical11'   ,
                  'Mechanical12'   ,
                  'Mechanical13'   ,
                  'Mechanical14'   ,
                  'Mechanical15'   ,
                  'Mechanical16'   ,
                  'DrillDrawing'   ,
                  'MultiLayer'     ,
                  'ConnectLayer'   ,
                  'BackGroundLayer',
                  'DRCErrorLayer'  ,
                  'HighlightLayer' ,
                  'GridColor1'     ,
                  'GridColor10'    ,
                  'PadHoleLayer'   ,
                  'ViaHoleLayer');

cMaxTestPointStyle

cMaxTestPointStyle             = eNewTHTop;

cMinTestPointStyle

cMinTestPointStyle = eExistingSMDBottom;

cMidLayers

cMidLayers       : Set Of TLayer = [eMidLayer1 .. eMidLayer30];

cMinLayer_WidthRule

cMinLayer_WidthRule = eTopLayer;

cMaxLayer_WidthRule

cMaxLayer_WidthRule = eBottomLayer;

cRoutingWidthModeStrings

cRoutingWidthModeStrings : Array[TRoutingWidthMode] Of String[20]
                           = ('User Choice'   , //eRoutingWidth_Default
                              'Rule Minimum'  , //eRoutingWidth_Min
                              'Rule Preferred', //eRoutingWidth_Preferred
                              'Rule Maximum'    //eRoutingWidth_Max);

cRuleIdStrings

cRuleIdStrings : Array [TRuleKind] Of String[21]
               = ( 'Clearance'            ,
                   'ParallelSegment'      ,
                   'Width'                ,
                   'Length'               ,
                   'MatchedLengths'       ,
                   'StubLength'           ,
                   'PlaneConnect'         ,
                   'RoutingTopology'      ,
                   'RoutingPriority'      ,
                   'RoutingLayers'        ,
                   'RoutingCorners'       ,
                   'RoutingVias'          ,
                   'PlaneClearance'       ,
                   'SolderMaskExpansion'  ,
                   'PasteMaskExpansion'   ,
                   'ShortCircuit'         ,
                   'UnRoutedNet'          ,
                   'ViasUnderSMD'         ,
                   'MaximumViaCount'      ,
                   'MinimumAnnularRing'   ,
                   'PolygonConnect'       ,
                   'AcuteAngle'           ,
                   'RoomDefinition'       ,
                   'SMDToCorner'          ,
                   'ComponentClearance'   ,
                   'ComponentOrientations',
                   'PermittedLayers'      ,
                   'NetsToIgnore'         ,
                   'SignalStimulus'       ,
                   'OvershootFalling'     ,
                   'OvershootRising'      ,
                   'UndershootFalling'    ,
                   'UndershootRising'     ,
                   'MaxMinImpedance'      ,
                   'SignalTopValue'       ,
                   'SignalBaseValue'      ,
                   'FlightTimeRising'     ,
                   'FlightTimeFalling'    ,
                   'LayerStack'           ,
                   'SlopeRising'          ,
                   'SlopeFalling'         ,
                   'SupplyNets'           ,
                   'HoleSize'             ,
                   'Testpoint'            ,
                   'TestPointUsage'       ,
                   'UnConnectedPin'       ,
                   'SMDToPlane'           ,
                   'SMDNeckDown'          ,
                   'LayerPairs'           ,
                   'FanoutControl'        ,
                   'Height',
                   'DiffPairsRouting'
);

cTextAutopositionStrings

cTextAutopositionStrings : Array[TTextAutoPosition] Of String[20]
                         = ( 'Manual'      ,
                             'Left-Above'  ,
                             'Left-Center' ,
                             'Left-Below'  ,
                             'Center-Above',
                             'Center'      ,
                             'Center-Below',
                             'Right-Above' ,
                             'Right-Center',
                             'Right-Below');

cTestPointPriorityHigh

cTestPointPriorityHigh = Ord(cMinTestPointStyle);

cTestPointPriorityLow

cTestPointPriorityLow = Ord(cMaxTestPointStyle);

cWidthRuleLayers

cWidthRuleLayers = [cMinLayer_WidthRule..cMaxLayer_WidthRule];

FirstObjectId

FirstObjectId = eArcObject;

InternalUnits

InternalUnits = 10000;

InternalPlanes

InternalPlanes   : Set Of TLayer = [eInternalPlane1..eInternalPlane16];

kDiameterSymbolANSI

kDiameterSymbolANSI    = #$F8;

kDiameterSymbolUnicode

kDiameterSymbolUnicode = #$3A6;

kDegreeSymbol

kDegreeSymbol          = #$B0;

k1Inch

k1Inch = 1000 * InternalUnits;
Notes
1 mil = 10000 internal units
1 inch = 1000 mils
1 inch = 2.54 cm
1 inch = 25.4 mm and 1 cm = 10 mm
PCB object's coordinates are usually in mils or mm depending on the board's current measurement units.

kDefaultArcResolution

kDefaultArcResolution            = k1Mil Div 2;
Notes
1 mil = 10000 internal units
1 inch = 1000 mils
1 inch = 2.54 cm
1 inch = 25.4 mm and 1 cm = 10 mm
PCB object's coordinates are usually in mils or mm depending on the board's current measurement units.

k1Mil

k1Mil = 1 * InternalUnits;
Notes
1 mil = 10000 internal units
1 inch = 1000 mils
1 inch = 2.54 cm
1 inch = 25.4 mm and 1 cm = 10 mm
PCB object's coordinates are usually in mils or mm depending on the board's current measurement units.

kMaxCoord

kMaxCoord = 99999  * InternalUnits;

kMinCoord

kMinCoord = 0 * InternalUnits;

kMaxInternalPlane

kMaxInternalPlane = eInternalPlane16;

kMinInternalPlane

kMinInternalPlane = eInternalPlane1;

kMaxPolySize

kMaxPolySize = 5000;

LastObjectId

LastObjectId = eEmbeddedBoardObject;

kMaxStrokes

kMaxStrokes = 2000;

MaxLayer

MaxLayer = eViaHoleLayer;
Notes
Refer to Layer2String and String2Layer functions in the PCB Functions topic.

MaxBoardLayer

MaxBoardLayer = eMultiLayer;

MaxLogicalTextSize

MaxLogicalTextSize = k1Inch;

MaxRouteLayer

MaxRouteLayer = eBottomLayer;

MaxMechanicalLayer constant

MaxMechanicalLayer = eMechanical16;

MechanicalLayers

MechanicalLayers : Set Of TLayer = [eMechanical1..eMechanical16];

MinLayer

MinLayer = eTopLayer;
Notes
Refer to Layer2String and String2Layer functions in the PCB Functions topic.

MinMechanicalLayer constant

MinMechanicalLayer = eMechanical1;

Numbers

Numbers          : Set Of Char   = ['0'..'9'];

WideStringObjects

WideStringObjects = [ eTextObject, eDimensionObject, eCoordinateObject, eComponentObject];

PCB Messages

Overview
The PCB Messages are messages that are broadcasted by the PCB Editor server. There are different types of messages that describe a specific action within the PCB server.
Normally the PCB message constants are used for the IPCB_ServerInterface.SendMessageToRobots method.
Syntax
PCBM_NullMessage         = 0;
PCBM_BeginModify         = 1;
PCBM_BoardRegisteration  = 2;
PCBM_EndModify           = 3;
PCBM_CancelModify        = 4;
PCBM_Create              = 5;
PCBM_Destroy             = 6;
PCBM_ProcessStart        = 7;
PCBM_ProcessEnd          = 8;
PCBM_ProcessCancel       = 9;
PCBM_YieldToRobots       = 10;
PCBM_CycleEnd            = 11;
PCBM_CycleStart          = 12;
PCBM_SystemInvalid       = 13;
PCBM_SystemValid         = 14;
PCBM_ViewUpdate          = 15;
PCBM_UnDoRegister        = 16;
c_BroadCast   = Nil;
c_NoEventData = Nil;
c_FromSystem  = Nil;
See also
SendMessageToRobots method

SignalLayers

SignalLayers     : Set Of TLayer = [eTopLayer.. eBottomLayer];

 

PCB Functions

The major PCB Functions are defined and implemented in the RT_PCBProcs unit.

Unit conversion functions

Function  RealToMils     (C : TReal)  : TReal;
Function  RealToMMs      (C : TReal)  : TReal;
Function  CoordToMils    (C : TCoord) : TReal;
Function  CoordToMMs     (C : TCoord) : TReal;
Function  MilsToCoord    (M : TReal)  : TCoord;
Function  MMsToCoord     (M : TReal)  : TCoord;
Function  MilsToRealCoord(M : TReal)  : TReal;
Function  MMsToRealCoord (M : TReal)  : TReal;
Function  MetricString  (Var S        : TString;
                         DefaultUnits : TUnit)  : Boolean;
Function  ImperialString(Var S        : TString;
                         DefaultUnits : TUnit)  : Boolean;
 
Procedure StringToCoordUnit(S     : TString;
                            Var C : TCoord;
                            Var U : TUnit);
 
Procedure StringToRealUnit (S     : TString;
                            Var R : TReal;
                            Var U : TUnit);
 
Function  CoordUnitToString(C : TCoord;
                            U : TUnit) : TString;
 
Function  RealUnitToString (R : TReal;
                            U : TUnit) : TString;

Angle and Trigonometric functions

Function  Degrees2Radians       (Angle             : TAngle)        : TReal;
Function  AngleToFormattedString(TextValue         : TReal;
                                 TextFormat        : TString;
                                 TextDimensionUnit : TDimensionUnit;
                                 TextPrecision     : Integer;
                                 TextPrefix        : TString;
                                 TextSuffix        : TString;
                                 UseTTFonts        : Boolean) : TString;
 
Function  DistanceToFormattedString    (TextValue         : TReal;
                                        TextFormat        : TString;
                                        TextDimensionUnit : TDimensionUnit;
                                        TextPrecision     : Integer;
                                        TextPrefix        : TString;
                                        TextSuffix        : TString;
                                        DisplayUnit       : TUnit;
                                        DimensionKind     : TDimensionKind;
                                        UseTTFonts        : Boolean)        : TString;
 
Procedure NormalizeAngle               (Var Angle         : TAngle);
 
Procedure RotateCoordsAroundXY         (Var x, y          : TCoord;
                                        Xr, Yr            : TCoord;
                                        Angle             : TAngle);
 
Procedure FindZoomRect(Const FarRect, CloseRect : TCoordRect; Out ZoomRect : TCoordRect); Overload;
Procedure FindZoomRect(Const FarRect, CloseRect : TCoordRect; Out ZoomRect : TCoordRect; Const PrecisionFactor : Double); Overload;
 
 

Object Boundary Functions

Function  GetFillBLX                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillBLY                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillTLX                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillTLY                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillTRX                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillTRY                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillBRX                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;
Function  GetFillBRY                   (P                 : TPCBObjectHandle;
                                        ExpandBy          : TCoord)         : TCoord;

Layer conversion functions

Function  Layer2String (Layer : TLayer) : TString;
Function  String2Layer (Layer : TString): TLayer;

Font Functions

Procedure EnumFontsW                   (DC                : HDC;
                                        Const AFontName   : TPCBString;
                                        Items             : TWideStrings);
Procedure EnumFontsA                   (DC                : HDC;
                                        Const AFontName   : TPCBString;
                                        Items             : TStrings);
Function  LoadFontNamesW               (Items             : TWideStrings)   : Integer;
Function  LoadFontNamesA               (Items             : TStrings)       : Integer;
Function  GetLocalizedFontName         (Const FontName    : TPCBString)     : TPCBString;

Locale Functions

Function  GetLocaleData(AID   : LCID; AFlag : DWORD) : TDynamicString;
Function  IsLocaleLanguageJapanese : Boolean;
Function  IsLocaleLanguageEnglish  : Boolean;
Function  IsLocaleLanguageAsian    : Boolean;

General Functions

GetIniFileName

Function GetIniFileName : AnsiString;

CoordsEqual

Function  CoordsEqual (c1, c2 : Double) : Boolean;

ConvertEncodedText2WideString

Function  ConvertEncodedText2WideString(Const EncodedText : TDynamicString) : TPCBString;

ConvertWideString2EncodedText

Function  ConvertWideString2EncodedText(Const WString     : TPCBString)     : TDynamicString;

StringListCopy

Function  StringListCopy               (AWideStringList : TWideStringList;
                                        AAnsiStringList : TStringList)      : Boolean;

StringToWideString

Function  StringToWideString           (const Str         : string)         : TPCBString;

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.