Working with Annotations
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.
Draftsman provides a range of additional drawing and annotation tools designed to add important information to a Draftsman drawing document. These include both automated note and highlighting systems.
The type of annotation to be placed can be selected from the Place main menu.
Callout Copy Link Copied
A Draftsman callout is a graphic pointer that can be placed in a document to provide information about a specific drawing location or object. The information associated with a callout may be custom text or data derived from various sources, like a BOM entry or a note item. Callouts can have one or more pointers to source points.
Several callouts of different types placed on a board assembly view
The steps to place a callout are:
-
Select the callout placement command (Place » Annotations » Callout).
-
The cursor will change to a crosshair indicating callout placement mode. Position the cursor in the drawing space to choose between the two callout placement types as indicated by the cursor highlighting:
-
Object callout – when the cursor highlights a side or corner of an object outline (such as the perimeter of a drawing view or component), the placed callout will be 'attached' to that specific object.
-
General callout – when there is no highlighting at the cursor, the placed callout simply refers to that location, rather than an object.
-
-
Click to place the callout pointer at the desired location, as determined above.
-
Move the cursor to a suitable position for the callout source text and click to confirm the placement.
-
Callouts support multiple sources. After placing the callout's source text position, you can move and click again to identify as many other source locations as required.
-
Once the required number of sources has been defined, right-click to complete the placement of this callout. You remain in callout placement mode.
-
Repeat the sequence of steps 2 – 6 to place another callout, or right-click a second time to drop out of callout placement mode.
Notes on working with callouts:
-
The information text that is shown at the end of the callout (the callout 'tag') is determined by the Source Text property options in the Properties panel.
-
The end position of a placed callout may be graphically modified. Select a callout to enable its end position editing handle, which can be dragged to a new location.
-
The starting/target point for a placed callout can be moved to a new location through a drag-and-drop action. When moved, the starting node binds to the new object and causes the callout data to update accordingly.
-
An existing callout can have additional sources added and removed. Click to select the callout, then right-click on it to display the context menu. This menu will include an Add Source command, and if it already has multiple sources defined and an individual source was selected when the right-click was performed, the menu will also include a Delete Source command. Note the Spacebar and Delete Source shortcuts, use these to quickly add and delete sources to/from a callout, respectively.
A video demonstrating callout placement and graphical editing techniques is shown below.
Smart callout text can be placed and configured to read the matching BOM entry for a component (or components), refer to an existing note item entry, or just display custom text.
The drawing style and information source of a placed callout are configurable in the Properties panel when the callout is selected in the design space ().
Style |
|
Connection Line | Use the drop-downs to select the line thickness and pattern used to render the callout pointer line and elbow. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Arrow Style | Use the provided options to configure the callout pointer.
|
Properties |
|
Source Text | Use the drop-down menu to specify the data source that is used to generate the callout text string (tag).
|
Border | Use the drop-down menu to choose the graphic shape style at the end of the callout line (circle, square, etc.). Use the associated color button to specify the fill color of the end shape (that surrounds the text tag). |
Auto size | Enable to automatically expand the end shape of the callout to accommodate the accompanying text tag string. When this option is disabled, use the Width and/or Height fields to specify the required size of the shape. |
Text Above | Use the field to define a text that will be shown above the callout pointer line. |
Text Below | Use the field to define a text that will be shown below the callout pointer line. |
Line Style | Use the drop-downs to select the line thickness and pattern used to render the callout end shape's border line (outline). Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Elbow Style | Use the drop-down menu to specify or disable the horizontal line (elbow) attached to the end of the callout line. The callout text tag and its border are attached to the elbow. |
Elbow Length | Set the horizontal length of the elbow. |
Elbow Position | Set the elbow and text tag to project to the left or right of the callout line. |
Font |
|
Font | Sets the font used for the callout's text tag.
|
Center Mark Copy Link Copied
A Draftsman center mark is a crosshair object that automatically locks to the radius origin of a circle and arc in a Draftsman document. A placed center mark is available as a reference location for placed dimensioning objects such as linear and ordinate dimensions.
Several center marks placed on a board assembly view
The steps to place a center mark:
-
Select the center mark placement command (Place » Annotations » Center Mark). The cursor will change to a crosshair and the editor will enter center mark placement mode.
-
Hover the cursor over a circle or arc outline, which will be highlighted (colored orange) as the center mark graphic snaps to the circle/arc radius center point.
-
Click the circle/arc outline to confirm the placement of the center mark object.
-
Continue placing further center marks or right-click or press
Esc
to exit placement mode.
Notes on working with center marks:
-
Placed center marks are available for dimension bindings. When placing linear or ordinate dimensions, select the highlighted dot at the intersection of the center mark cross as a dimension reference node (
).
-
Select a placed center mark by clicking on the intersection of its cross-hairs. Once selected, an editing node is available at its center point. Click and drag the center mark's node to move it to a circle/arc in a different location. The center mark is attached to the target circle/arc in the same way as during its initial placement – hover then click on the circle/arc outline.
A video demonstrating center mark placement and graphical editing techniques is shown below.
The line style, color, and rotation of a center mark are available as settings in the Properties panel when the center mark is selected in the design space ().
Style |
|
Connection Line | Use the drop-downs to select the line thickness and pattern used to render the center mark cross-hair lines. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Properties |
|
Rotation | Specify the rotation angle of the center mark cross-hair graphic. |
Surface Finish Indicator Copy Link Copied
Draftsman allows the placement of surface finish graphical symbols and their associated parameters that comply with the ISO 1302:2002 International Standard for surface texture in technical product documentation. The standard specifies the rules for the indication of surface texture in drawings, based on special symbols and attributes that describe the permitted surface material for the product – in this case, a printed circuit board.
The addition of surface finish indicators in Draftsman avoids the need for a separate surface finish tool or application when this standardized information is required for PCB manufacture. The graphical symbols are accompanied by a range of specialized text codes, as defined by the ISO standard.
A number of surface finish objects of different styles placed on a board fabrication view
To place a surface finish object in a drawing, select the surface finish placement command (Place » Annotations » Surface Finish). When the command is launched, the cursor will change to a crosshair indicating placement mode. As the cursor is hovered over objects, the object edges will be highlighted as orange-colored lines.
To attach the surface finish to a drawing object face:
- Position the cursor on a highlighted line then click to nominate that edge position.
- Move the cursor to specify the symbol orientation relative to the edge then click to confirm the placement.
To place a free surface finish that is not attached to an object edge:
-
Position the cursor in any position where an object edge is not highlighted.
-
Click to confirm the placement.
The attached surface finish indicator can be dragged along the line, and, optionally, away from the drawing via an automatic extension line (enabled by the With Leader option in the Properties panel).
The position and orientation of a placed surface finish may be graphically modified. Select a surface finish object to enable its editing modes:
-
For an attached symbol, click and drag its attachment point node to change the connection position.
-
For an attached symbol without an arrowed leader line, drag its mid-point node to invert the symbol orientation.
-
For a free (not attached) symbol, drag its node or the graphic itself to change its position.
A video demonstrating surface finish object placement and graphical editing techniques is shown below.
The symbol style and text attributes for a placed surface finish object are configurable in the Properties panel when the object is selected in the design space ().
View |
|
Symbol | The standardized graphic symbol that will be shown in the surface finish indicator. Use the drop-down menu to choose a surface manufacturing process, as defined in the ISO 1302:2002 standard:
|
Line Style | Use the drop-downs to select the line used to render the surface finish symbol and its leader/pointer line, if enabled. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Extension Line Style | Use the drop-downs to select the line that automatically extends from an object edge when the surface finish indicator point is moved beyond the object's bounds. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Extension Line Gap | The spacing between the target object edge and the beginning of the extension line. |
Extension Line Offset | The distance that the extension lines will protrude beyond the surface finish symbol. |
Arrow Style | Use the provided options to configure the connector line (applies if the With Leader option is enabled).
|
With Leader | Enable to add an arrowed connector line between the surface finish indicator and the target object face. |
Value |
|
First Requirement | A coded and numerical tolerance for the surface texture. |
Second Requirement | An additional coded and numerical tolerance for the surface texture. |
Manufacturing Method | The permitted processes to be used to manufacture the surface. |
Machining Allowance | A numerical constraint for the surface machining accuracy. |
Allow Different Requirements | When checked, an additional bracketed symbol is added to the selected surface finish object (applies to a free, i.e. not attached, symbol only). This indicates that other attached surface finish objects in the drawing may override the currently selected surface finish object, which acts as a general/base setting for all surfaces. |
Surface Lay and Orientation | Use the drop-down menu to specify the desired pattern style and direction for the surface. |
Font |
|
Font | Sets the font used for the surface finish indicator's characters.
|
Note Copy Link Copied
A note object (Place » Annotations » Note) is an active text-based list that can be placed in a Draftsman document to provide additional and optionally targeted information that relates to drawing views.
The entries in a note list can include parameters that are available to the project document and individual list entries can be referred to by placed callout objects. A callout–note reference behaves as an active link, and therefore, changes to the note entry (such as its list number or border graphic) will be reflected in the callout label.
Two note objects in a drawing with example callout objects that refer to note list entries.
The note object's visual style and its list entries are configurable in the Properties panel when the object is selected in the design space (). To view/modify the properties of a specific note in the list, click to select that entry in the list. The Selected Element region of the Properties panel will update to reflect the properties for that entry accordingly (
).
Title |
|
Title, Location, Font |
Use these options to configure the object's title. These options are similar to those used to configure a view's title. For more information, refer to the Working with Views page. |
Properties |
|
Order | When multiple note objects are placed within the same sheet of a Draftsman document, this option defines the numbering of list entries based on the relative note locations: |
Width | The boundary width of the note object. The text entries will automatically wrap to remain constrained within the object width. |
Horizontal Spacing | The distance between the list entry numbering and their associated text entries. |
Vertical Spacing | The distance, or line spacing, between the list entry elements. |
Font | Sets the font used for the note text entries.
|
Selected Element |
|
Note Item Number | Indicates the entry number of the currently selected list element. |
Border | The graphic outline style applied to the number of the selected list element. Use the drop-down menu to select from a range of predefined geometric shapes. |
Note Description | The text entry field for the currently selected note list element. |
![]() |
Click to open the Document Parameters dialog where any of the available parameters may be selected for inclusion in the note entry. The dialog can be configured to present all system, project (both local and Workspace-side parameters), and PCB parameters related to the active Draftsman document. Select a parameter and click OK to confirm the selection; the value string for that parameter will be inserted at the current cursor position within the Note Description field ( |
![]() |
Click to add a new entry (element) to the end of the note list. Any number of note entries can be added to a note item list. |
![]() ![]() |
Use to move the selected entry up or down one row. The list entries are automatically renumbered to accommodate the change. |
![]() |
Click to remove the selected entry. |
Text Copy Link Copied
A text box (Place » Text) is a text container object that can be placed on a Draftsman document sheet.
The text object's text string and visual style are configurable in the Properties panel when the object is selected in the design space ().
Location |
|
(X/Y) | The X-axis and Y-axis values of the text box reference location (bottom-left corner position). |
Rotation | The rotation angle of the text box. |
Properties |
|
Width | The width of the text box. |
Height | The height of the text box. |
Clip Text To Bounds | When selected, the box text string will be automatically wrapped to remain constrained within the text box perimeter. |
Text | The target field for the text string that will appear in the displayed text box. |
![]() |
Click to open the Document Parameters dialog where any of the available parameters may be selected for inclusion in the note entry. The dialog can be configured to present all system, project (both local and Workspace-side parameters), and PCB parameters related to the active Draftsman document. Select a parameter and click OK to confirm the selection; the value string for that parameter will be inserted at the current cursor position within the Text field ( |
Font | Sets the font used for the text box string.
|
Alignment | Use the buttons to set the Horizontal (left, center, or right) and Vertical (top, middle, or bottom) text alignment and positioning within the text box. |
Fill Style | Use these options to configure the display of the text box fill pattern and color. The pattern swatch shows the preview of the pattern according to the configured settings. Use the associated color buttons to specify colors for the fill and hatch pattern. Select the associated
|
Geometric Dimensioning and Tolerances Copy Link Copied
Draftsman includes the capability to place and configure industry-standard Geometric Dimensioning and Geometric Tolerances symbolic elements that define the manufacturing properties of objects included in a drawing.
Also used in most advanced MCAD applications, the specialized information provided by the placed geometric symbols stipulates the allowable imperfections in the manufacture of physical objects. The geometric definition elements that can be added to Draftsman documents are derived from standards developed by the American Society of Mechanical Engineers (ASME) – specifically, the ASME Y14.5-2009 Dimension and Tolerancing standard. Many other standards and guidelines exist for geometric engineering definitions, including a large number of conceptually specific documents from the International Organization for Standardization (ISO).
See Geometric dimensioning and tolerancing Wikipedia entry for overview information and reference links.
In terms of Draftsman drawing documents, the symbol-based dimensioning and tolerancing information is incorporated into a drawing by the placement of two types of objects:
-
Datum feature symbols – identification objects that can be attached to a line, point, or axis of a physical feature in a drawing, such as the edge of the board, component, or hole.
-
Feature control frames – information objects that can be attached to a drawing feature, which include multiples of symbolic data that specify the mechanical manufacturing constraints for the feature.
Both of the above drawing objects can be positioned freely in the document, or (normally) attached to a feature such as an edge. In the same way in which other drawing annotations are placed in Draftsman, such as surface finish symbols, the geometric definition symbols are attached by clicking on a highlighted line in the drawing and then clicking again to place the symbol.
Datum Feature
A Draftsman datum feature is a graphic identification object that can be attached to a line, point, or axis of a physical feature in a drawing, such as the edge of a board, component, or hole. It acts as a reference on that drawing object so that relative dimension tolerances included in feature control frames can refer to this and other placed datum features.
A number of datum feature objects attached to the surface edges of objects in a board assembly view
The steps to place a datum feature:
-
Select the datum feature placement command (Place » Annotations » Datum Feature). The cursor will change to a cross-hair and the editor will enter datum feature placement mode. As the cursor is hovered over objects, the object edges will be highlighted as orange-colored lines.
-
Position the cursor over a highlighted object edge then click to attach the datum feature to that object face.
-
Move the cursor to set the position of the datum feature label then click to complete placement.
The edge attachment point or label location of a placed datum feature can be graphically modified. When a datum feature is selected, editing handles/nodes become available at its attachment and header label points.
-
Click and drag the label node to reposition it on the drawing document.
-
Click and drag the edge attachment node to reposition it along the selected object face. An extension line is added when the attachment point is moved beyond the boundary of the object face.
A video demonstrating datum feature placement and graphical editing techniques is shown below.
The style and text attributes for a placed datum feature object are configurable in the Properties panel when the object is selected in the design space ().
View |
|
Label | The text characters that identify the datum feature object and appear within its graphic symbol. |
With Leader | Enable to include an arrowed leader line between the datum feature graphic and its object attachment point. |
Styles |
|
Line Style | Use the drop-downs to select the line used to render the datum feature symbol and its leader line, if enabled. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Extension Line Style | Use the drop-downs to select the line that automatically extends from an object edge when the datum feature attachment point is moved beyond the object's bounds. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Arrow Style | Use the provided options to configure the leader line (applies if the With Leader option is enabled).
|
Font | Sets the font used for the datum feature label's characters.
|
Feature Control Frame
A Draftsman feature control frame is a graphic information object that can be placed on a Draftsman document sheet to define the manufacturing constraints of the physical feature to which it is attached, such as an object face or machined cutout/hole.
The tabular frame object applies a specialized range of symbols, tolerance values, and location references to specify acceptable manufacturing imperfections as defined by the ASME Y14.5-2009 Dimension and Tolerancing standard. Draftsman datum feature objects are used as reference locations in placed feature control frames. Attached machining tolerances, such as the 'straightness' of a feature for example, apply to the specified drawing object face. Attached dimension tolerances by comparison (such as 'position') are generally specified as relative to one or more placed datum features. When added to the mechanical elements in a Draftsman drawing view, the combined information represented by feature control frames and their related datum references can fully describe the acceptable manufacturing constraints for those physical elements. See Applied Geometric Tolerances for information on a number of basic examples.
Feature control frame objects attached to a hole and an edge in a board assembly view. The three datum feature objects are used as reference locations.
The steps to place a feature control frame:
-
Select the feature control frame placement command (Place » Annotations » Feature Control Frame). The cursor will change to a cross-hair and the editor will enter feature control frame placement mode. As the cursor is hovered over objects, the object edges will be highlighted as orange-colored lines.
-
Position the cursor at the required point within the drawing. Typically this will be a feature such as an edge. In this case, position at a point where the drawing element is highlighted (an edge or a point).
-
With the cursor in position, click to attach the feature control frame to that feature.
-
Move the cursor to set the position of the datum feature label then click to complete placement.
The object attachment point or frame location of a placed feature control frame can be graphically modified. When a feature control frame is selected, editing handles/nodes become available at its attachment and frame points.
-
Click and drag the tabular frame node to reposition it on the drawing document.
-
Click and drag the edge attachment node to reposition it on the selected object face. An extension line is added when the attachment point is moved beyond the boundary of the object face.
A video demonstrating datum feature placement and graphical editing techniques is shown below.
The feature control frame object's visual style and the information it conveys, presented in symbols, modifiers, and numeric values, are configurable in the Properties panel when the object is selected in the design space (). Multiple definition rows (elements) may be added to the frame. To view/modify the properties of a specific row, click within its bounds to select that row. The Selected Element region of the Properties panel will update to reflect the properties for that row accordingly (
).
View |
|
Additional Symbol | Use the drop-down menu to select optional header graphic attributes that specify if the dimension/tolerance applies to the local area or to the complete physical item. |
Display Mode | Sets the style of connection line between the frame and the object surface reference point. |
Elbow Length | Sets the length of the horizontal part of the connection line when the Display Mode option is set to Bent. |
Composite Feature Control Frame | When checked, a single definition symbol applies to all row data in the Feature Control Frame. |
Styles |
|
Line Style | Use the drop-downs to select the line used to render tabular frame and its leader line, if enabled. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Extension Line Style | Use the drop-downs to select the line that automatically extends from an object edge when a feature control frame attachment point is moved beyond the object's bounds. Available options are defined in the Line Styles region of the Properties panel when no object is selected in the design space. For more information, refer to the Setting Up a Draftsman Document page. Use the associated color button to specify the color of the line. |
Arrow Style | Use the provided options to configure the leader line (applies if the With Leader option is enabled).
|
Font | Sets the font used for the feature control frame's data characters.
|
Selected Element |
|
Frame Number | The number of the currently selected element row in the feature control frame. |
Symbol | The graphic symbol, as defined in the ASME Y14.5-2009 Dimension and Tolerancing standard, that indicates type of dimension or tolerance information in the selected frame row. |
Dimension Symbol | The type of relative dimensioning that is defined by the row data (such as machined Square or Diameter based cutouts). |
Tolerance | The acceptable variation (tolerance) in the row's specified numerical dimension. Use the associated drop-down menu to select from a range of coded symbol modifiers, as defined by the ASME Y14.5-2009 Dimension and Tolerancing standard. |
Datum 1 | Reference location for the selected dimension/tolerance, as specified by the entered datum feature label. Use the associated drop-down menu to select from a range of coded symbol modifiers. |
Datum 2 | A relative reference location for the selected dimension/tolerance, as specified by the entered datum feature label – for example, a parallel surfaces specification might apply to the faces at Datum 1 relative to Datum 2. Use the associated drop-down menu to select from a range of coded symbol modifiers. |
Datum 3 | An additional relative reference location for the selected dimension/tolerance, as specified by the entered datum feature label. Use the associated drop-down menu to select from a range of coded symbol modifiers. |
![]() |
Click to add a new data row (element) to the feature control frame. |
![]() ![]() |
Click to move the selected element up or down by one count in the frame's row order. |
![]() |
Use the button to remove the currently selected element. |