Contact our corporate or local offices directly.
A string is a primitive design object. It places text on the selected layer in a variety of display styles and formats, including popular barcoding standards. As well as user-defined text, a special type of string, referred to as a special string, can be used to display board or system information, or the value of user-parameters, on the board.
After launching the command, the cursor will change to a cross-hair and you will enter string placement mode. A string will appear "floating" on the cursor:
Additional actions that can be performed during placement are:
This method of editing allows you to select a placed string object directly in the workspace and change its location, rotation, orientation or, in the case of inverted strings, size.
When a non-inverted string object is selected, the following editing handle is available:
When an inverted string object with an editable bounding rectangle (inverted rectangle) is selected, the following editing handles are available:
The following methods of non-graphical editing are available:
Dialog page: String
This method of editing uses the following dialog to modify the properties of a string object.
The String dialog can be accessed prior to entering placement mode, from the PCB Editor – Defaults page of the Preferences dialog. This allows the default properties for the string object to be changed, which will be applied when placing subsequent strings.
During placement, the dialog can be accessed by pressing the Tab key.
After placement, the dialog can be accessed in one of the following ways:
An Inspector panel enables the designer to interrogate and edit the properties of one or more design objects in the active document. Used in conjunction with appropriate filtering - by using the PCB Filter panel or the Find Similar Objects dialog - the panel can be used to make changes to multiple objects of the same kind, from one convenient location.
A List panel allows the designer to display design objects from one or more documents in tabular format, enabling quick inspection and modification of object attributes. Used in conjunction with appropriate filtering - by using the PCB Filter panel or the Find Similar Objects dialog - it enables the display of just those objects falling under the scope of the active filter – allowing the designer to target and edit multiple design objects with greater accuracy and efficiency.
While string objects can be used to place user-defined text on the current PCB layer, it's not just user-defined text that can be placed. To assist in producing documentation, the concept of "special strings" is used. These act as placeholders for design, system or user information that is to be displayed on the PCB at the time of output generation.
If a string starts with ".", the entire string is treated as a 'special' string. To include more than one string in a 'special' string, use apostrophe ( ' ) to enclose each string. Example: '.PcbDoc' '.PcbName'. You can now also use spaces or special characters inside 'special' strings. Example: '.PcbDoc #1'.
There is a default set of predefined special strings provided for use with new PCB documents. The designer can also add their own custom special strings, by defining additional parameters at the project-level, these parameters are defined in the Parameters Tab of the Options for Project dialog.
The special strings that are available in a PCB document come from a number of sources:
To use a special string on a PCB, simply place a string object and select one of the special string names from the drop-down. To open the drop-down, start typing in the String text field. Scroll through the drop-down or continue typing to narrow down the options.
The values of some special strings can only be viewed when the relevant output is generated. Most special strings can be viewed directly on-screen however, by enabling the Convert Special Strings option, on the View Options page of the View Configurations dialog, when viewing the board in 2D (press the L shortcut to open the dialog).
The following are the predefined, system-based special strings available for use on a PCB document:
.Application_BuildNumber– the version of the software that the PCB is currently loaded in. When generating Gerber output, use this string to record the software build that the design was created on.
.Arc_Count– the number of arcs on the PCB.
.Comment– the comment string for a component (placed on any layer in the library editor as part of the component footprint).
.Component_Count– the number of components on the PCB.
.ComputerName– the name of the computer on which the software is installed and running.
.Designator– the designator string for a component (placed on any layer in the library editor as part of the component footprint).
.Fill_Count– the number of fills on the PCB.
.Hole_Count– the number of drill holes on the PCB.
.Item– the Item that the generated data relates to (e.g.
D-810-2000). The data will be used to build that Item.
.ItemAndRevision– the Item and specific revision of that Item that the generated data relates to, in the format
<Item ID>-<Revision ID>(e.g.
D-810-2000-01.A.1). The data will be used to build that specific revision of that particular Item.
.ItemRevision– the specific revision of the Item that the generated data relates to (e.g. 01.A.1). The data is stored in that Item Revision within the target Altium Vault.
.ItemRevisionBase– the Base Level portion of an Item Revision's naming scheme (e.g. 1).
.ItemRevisionLevel1– the Level 1 portion of an Item Revision's naming scheme (e.g. A).
.ItemRevisionLevel1AndBase– the Level 1 and Base Level portions of an Item Revision's naming scheme (e.g. A.1).
.ItemRevisionLevel2– the Level 2 portion of an Item Revision's naming scheme (e.g. 01).
.ItemRevisionLevel2AndLevel1– the Level 2 and Level 1 portions of an Item Revision's naming scheme (e.g. 01.A).
.Layer_Name– the name of the layer the string is placed on.
.Legend– a symbol legend for mechanical drill plots. This string is only valid when placed on the Drill Drawing layer. Note: this is a legacy feature, place a Drill Table object for more detailed drill information.
.Net_Count– the total number of different nets on the PCB.
.Net_Names_On_Layer– the names of all nets on the specific layer. This string is only valid when placed on an internal plane layer.
.Pad_Count– the number of pads on the PCB.
.Pattern– the names of the component footprints used on the PCB.
.PCBConfigurationName– the name of the data set from which the output has been generated, as defined in the Release view (Project Releaser).
.Pcb_File_Name– the path and file name of the PCB document.
.Pcb_File_Name_No_Path– the file name of the PCB document.
.Plot_File_Name– for generated Gerber output, this string identifies the file name of the Gerber plot file. For printed output, it identifies the layer depicted within the output. For ODB++ output, it identifies the name of the parent folder in which the files are stored.
.Poly_Count– the number of polygons on the PCB (consisting of polygon pours, internal planes and split planes).
.Print_Date– the date of printing/plotting.
.Print_Scale– the printing/plot scale factor.
.Print_Time– the time of printing/plotting.
.Printout_Name– the name of the printout.
.SlotHole_Count– the number of slotted holes on the PCB.
.SquareHole_Count– the number of square holes on the PCB.
.String_Count– the number of strings on the PCB.
.Track_Count– the number of tracks on the PCB.
.VersionControl_ProjFolderRevNumber– the current revision number of the Project, which is incremented whenever a full commit of the project (i.e. including the project file) is performed. Version control must be used for this string to contain any information.
.VersionControl_RevNumber– the current revision number of the document. Version control must be used for this string to contain any information.
.Via_Count– the number of vias on the PCB.
The PCB Editor uses TrueType fonts for string objects. In addition, support is available for presenting text strings in Barcode format. Barcodes are commonly used to tag and identify PCBs, streamlining inventory tracking for example, through use of automated scan-machines. Choice of font is made from within the String dialog.
When using TrueType fonts, TrueType and OpenType (a superset of TrueType) fonts found in the
\Windows\Fonts folder will be available for use. The feature also offers full Unicode support.
To use a TrueType font, simply set the Font field (in the String dialog) to TrueType Font and choose a font type from the drop-down field in the Select TrueType Font region. Use the Bold and/or Italic options to add emphasis to the text as required.
Additional options for TrueType fonts are available. Enable the Inverted option to display the text as inverted, with control over the size of the border around the text.
Embedding TrueType Fonts
The PCB Editor – TrueType Fonts page of the Preferences dialog provides options for embedding TrueType fonts when saving a design and for applying font substitution when loading a design. Embedding fonts is useful when text is required to be displayed in a font that may or may not be available on a target computer upon which the design is loaded. Font substitution enables specification of a TrueType font to be used as a replacement when loading a design where fonts have not been embedded and where fonts may not be available on the computer upon which the design is currently loaded.
Three Stroke-based fonts are available – Default, Sans Serif and Serif. The Default style is a simple vector font which supports pen plotting and vector photoplotting. The Sans Serif and Serif fonts are more complex and will slow down vector output generation, such as Gerber.
To use a Stroke-based font, simply enable the Stroke font option in the String dialog and choose a font type from the drop-down field in the Select Stroke Font region.
Ability is provided to place barcode symbols directly onto a PCB on any layer, allowing barcodes to be easily imprinted on a PCB as part of the manufacturing process.
To use a Barcode font, simply set the Font field (in the String dialog) to BarCode Text, and define the display options as required in the Select BarCode Text region.
BarCode ISO Code 39 (US Dept of Defense standard) and Code 128 (global trade identification standard) are supported, and the actual text string that the barcode is derived from can also be displayed by enabling the Show Text option.
By using a combination of barcode and inverted text strings, along with fills if necessary, a nice barcode area can be defined on a board, with more information textually than would otherwise be afforded by just the originating barcode text.
Contact our corporate or local offices directly.