Draft Text

Description
The Text tool inserts a piece of text at a given point in the current document. It takes the text size and color previously set on the Tasks tab.



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, pressing  between each line
 * 4) Press  twice to finish the operation.

Options

 * Pressing will snap your point to available snap locations.
 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component.
 * Pressing will cancel the operation.
 * When editing the text, pressing or  allow you to enter or edit a next line of text.
 * Pressing allows you to edit a previous line of text.
 * Pressing twice (thus leaving the last line empty) adds the text to the document and closes the editor.

Properties

 * : The base point of the text block
 * : The contents of the text block
 * : Specifies if the text is aligned to the scene axes or always faces the camera
 * : The size of the letters
 * : Specifies if the text is aligned to the left, right or center of the base point.
 * : Specifies the space between lines of text
 * : Specifies a rotation to be applied to the text
 * : Specifies the axis to use for the rotation
 * : The font to use to draw the text. It can be a font name, such as "Arial", a default style such as "sans", "serif" or "mono", or a family such as "Arial,Helvetica,sans" or a name with a style such as "Arial:Bold". If the given font is not found on the system, a generic one is used instead.

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

makeText (string or list, [Vector], [screenmode]) : Creates a Text object, at the given point if a vector is provided, containing the string or the strings given in the list, one string by line. The current Draft color and text height and font specified in preferences are used. If screenmode is True, the text always faces the view direction, otherwise it lies on the XY plane. Returns the newly created object.

Example:

import FreeCAD,Draft Draft.makeText("This is a sample text",FreeCAD.Vector(1,1,0))