Draft Text/tr

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