Draft Label

Description
The Label tool inserts a piece of text with a 2-segment line and an arrow. If an object or a sub-element (face, edge or vertex) is selected when starting the command, the Label can be made to display a certain attribute of the selected element.

To insert a simpler text element without an arrow use Draft Text. To create solid text shapes use Draft ShapeString with Part Extrude.



How to use

 * 1) Press the  button, or press  then  keys.
 * 2) Click a first point on the 3D view, or type a coordinate and press the  button. This point indicates the target (arrow head). This can be anywhere, it doesn't need to be on an element.
 * 3) Click a second point on the 3D view, or type a coordinate and press the  button. This point indicates the start of a horizontal or vertical lead.
 * 4) Click a third point on the 3D view, or type a coordinate and press the  button. This point indicates the position of the text.

the direction of the horizontal straight segment, to the right or to the left, will automatically justify the text to the opposite direction. If the lead goes vertically up, the text is justified to the left; if it goes vertically down, it is justified to the right.

by pre-selecting an object, or a subelement (vertex, edge or face), before pressing the tool button, the label will become parametric, that is, it will remember which object it is bound to, and it will be able to display a particular attribute of the object. If the attributes of the object change later on, the label will adjust the displayed information.

Options

 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component.
 * Press to force snapping your point to the nearest snap location, independently of the distance.
 * Press or the  button to abort the current command.

Properties

 * : The type of information shown by this label (see below)
 * : The text to display when Label Type is set to custom
 * : Indicates the rotation and the position of the text
 * : The length of the straight segment
 * : The direction of the straight segment Horizontal or vertical
 * : The point indicated by this label
 * : The size of the text
 * : The font used for the text
 * : The vertical alignment of the text: Top, middle or bottom
 * : The color of the text
 * : The width of the line
 * : The color of the line
 * : The type of the arrow: Dot, circle, arrow or tick.
 * : The size of the arrow
 * : Draws a frame around the text

Label types

 * Custom: Shows the contents of the Custom Text property
 * Name: Shows the name of the target object
 * Label: Shows the label of the target object
 * Position: Shows the coordinates of the target object (Placement base point), or the coordinates of the target vertex, if applicable, or the coordinates of the center of the target subelement (center of mass)
 * Length: Shows the length of the target subelement, if possible
 * Area: Shows the area of the target subelement, if possible
 * Volume: Shows the volume of the target object, if possible
 * Tag: Shows the tag value of the target object, if the target object has such property (which is the case of all Arch objects)
 * Material: Shows the label of the material of the target object, if the target object has such property

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


 * Returns the newly created object.

Example: