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