IPCB_AngularDimension interface

An angular dimension on a PCB document, which measures the angle between two lines.

public interface IPCB_AngularDimension : IPCB_Dimension

Namespace: PCB · Assembly: Altium.SDK.Interfaces

Inherits: IPCB_Primitive → IPCB_Group → IPCB_Dimension

Remarks

An angular dimension has four references: references 0 and 1 define the first line and references 2 and 3 the second. The references may be tracks, fills or polygons. The vertex of the angle is the intersection of the two lines; when the primitives are regenerated, the dimension's location (XLocation, YLocation) is set to the vertex. When the two lines are parallel, the dimension uses the first line for both and the first reference point as the vertex.

The two lines divide the area around the vertex into four sectors. Sector selects the sector that is measured and Radius the radius of the dimension arc. When the primitives are regenerated, TextValue is set to the angle of the sector in degrees; a new angular dimension shows it in degrees (TextDimensionUnit is TDimensionUnit.eDegrees).

With TextPosition set to TDimensionTextPosition.eTextAuto, the text and arrowheads are drawn as with TDimensionTextPosition.eTextRight and TDimensionArrowPosition.eOutside when the measured angle is less than 15 degrees, and as with TDimensionTextPosition.eTextCenter and TDimensionArrowPosition.eInside otherwise.

The text, arcs and tracks that draw the dimension are returned by Text, Arc1, Arc2, Arrow1_Track1, Arrow1_Track2, Arrow2_Track1, Arrow2_Track2, Extension1_Track and Extension2_Track.

Properties

Property	Type	Access	Description
Radius	`int`	get; set	The radius of the dimension arc, the distance from the vertex of the angle, in internal units (10,000 per mil).
Sector	`int`	get; set	Which of the four sectors formed by the two lines the dimension measures, from 1 to 4.

Radius

The radius of the dimension arc, the distance from the vertex of the angle, in internal units (10,000 per mil).

int GetState_Radius();
void SetState_Radius(int argValue);

Type: int · Access: read/write

The arcs and the arrowheads are drawn at this distance from the vertex. MoveTextToXY sets it to the distance from the vertex to the new text position.

Sector

Which of the four sectors formed by the two lines the dimension measures, from 1 to 4.

int GetState_Sector();
void SetState_Sector(int argValue);

Type: int · Access: read/write

Taking the direction of each line from its first reference point to its second, sector 1 is the angle of at most 180 degrees between the two directions; sectors 2, 3 and 4 follow counterclockwise, so sector 3 is the angle opposite sector 1. MoveTextToXY sets it to the sector that contains the new text position.

Methods

Method	Returns	Description
Arc1	IPCB_Arc	Returns the first of the two arcs that draw the dimension arc.
Arc2	IPCB_Arc	Returns the second of the two arcs that draw the dimension arc.
Arrow1_Track1	IPCB_Track	Returns one of the two tracks of the arrowhead at the start of the measured sector.
Arrow1_Track2	IPCB_Track	Returns one of the two tracks of the arrowhead at the start of the measured sector.
Arrow2_Track1	IPCB_Track	Returns one of the two tracks of the arrowhead at the end of the measured sector.
Arrow2_Track2	IPCB_Track	Returns one of the two tracks of the arrowhead at the end of the measured sector.
Extension1_Track	IPCB_Track	Returns the extension line from the line that bounds the start of the measured sector to the dimension arc.
Extension2_Track	IPCB_Track	Returns the extension line from the line that bounds the end of the measured sector to the dimension arc.
Text	IPCB_Text	Returns the text that shows the measured angle.