Draft ShapeString

Description
The Draft ShapeString command creates 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 should 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) To select a font do one of the following:
 * 11) * Enter a file path in the input box.
 * 12) * Press the button and select a file.
 * 13) Press the  button to finish the command.

Options

 * Press or the  button to abort the command.

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

Preferences

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

Properties
See also: Property editor.

A Draft ShapeString object is derived from a Part Part2DObject and inherits all its properties. It also has the following additional properties:

Data

 * : specifies the path of the font file used to draw the text.
 * : specifies the general height of the text.
 * : specifies the text string to display. Unlike a Draft Text, a Draft ShapeString can only display a single text line.
 * : specifies the additional inter-character spacing of the text.

View

 * : specifies the Draft Pattern with which to fill the faces of the text. This property only works if is.
 * : specifies the size of the Draft Pattern.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a Draft ShapeString use the method  of the Draft module. This method replaces the deprecated method.


 * 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: