Draft ShapeString

Description
The Draft ShapeString command inserts a compound shape that represents a text string. This shape can be used to create 3D letters with the Part Extrude command.

The Draft ShapeString command is not intended for standard text annotations. The Draft Text command or the Draft Label command can be used for that purpose.



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) The  task panel opens.
 * 6) Click a point in the 3D view, or type coordinates.
 * 7) Optionally press the  button to reset the point to the origin.
 * 8) Enter a.
 * 9) Specify the.
 * 10) Press the  to the right of  to select a font.
 * 11) Press  button to close the task panel and finish the command.

Options

 * Press or the  button to abort the 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: