Draft ShapeString

Description
The ShapeString tool inserts a compound shape representing a text string at a given point in the current document. Text height, tracking and font can be specified.



How to use

 * 1) Press the  button, or press  then  keys
 * 2) Click a point on the 3D view, or type a coordinate
 * 3) Enter the desired text, press
 * 4) Enter the desired size, press
 * 5) Enter the desired tracking, press
 * 6) Press  to accept the displayed font, or,
 * 7) Press  to select a font file.

Options

 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component.
 * Pressing will cancel the operation.

Properties

 * : The base point of the compound shape
 * : The contents of the text string
 * : The height of the letters in FC units
 * : The inter-character spacing in FC units
 * : The font definition file used to draw the string

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

makeShapeString(String,FontFile,[Size],[Tracking]) : Turns a text string into a Compound Shape using a specified font.

Example:

import FreeCAD,Draft Draft.makeShapeString("This is a sample text",                      "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf',                       200.0,10)

Limitations

 * This tool is not yet available. It will be included in a future version.  (as of v0.13)
 * This tool currently only handles ASCII characters in the text string and font file path. Non-ASCII characters give unpredictable results. (as of v0.13)
 * TrueType(*.ttf), OpenType(*.otf) and Type1(*.pfb) font files are supported.