Draft ShapeString

Description
The tool inserts a compound shape that represents a text string. Text height, tracking and font can be specified. The resulting shape can be used with the Part Extrude tool to create 3D letters.

Alternatively: To insert a simpler text element without a closed shape use Draft Text. To create a text label with a lead and an arrow use Draft Label.



Usage

 * 1) There are several ways to invoke the command:
 * 2) * Press the button.
 * 3) * Select the option from the menu.
 * 4) * Use the keyboard shortcut: then.
 * 5) A dialog will appear where you can specify your parameters.
 * 6) Press  to create the ShapeString.

Options

 * Press or the  button to abort the current command.

Preferences

 * The default font file can be changed in the preferences: . See Draft Preferences.

Tutorials

 * Draft ShapeString tutorial: extrude a ShapeString, position it in 3D space, and create an engraving in another body.
 * How to use ShapeStrings in PartDesign

Properties

 * : specifies the position of the base point of the compound shape.
 * : specifies the rotation of the baseline of the shape.
 * : specifies the axis to use for the rotation.
 * : specifies the text string to display; unlike the Draft Text tool, the Draft ShapeString can only display a single line.
 * : specifies the general height of the letters.
 * : specifies the additional inter-character spacing in the string.
 * : specifies the full path of the font file used to draw the string.

Scripting
See also: Draft API and FreeCAD Scripting Basics.

The ShapeString tool can be used in macros and from the Python console by using the following function:


 * Creates a compound shape using the specified  and the full path of a supported.
 * is the height of the resulting text in millimeters.
 * is the additional inter-character spacing in millimeters.

The placement of the ShapeString can be changed by overwriting its attribute, or by individually overwriting its  and  attributes.

Example: