TechDraw Balloon

Description
The Balloon tool can add balloons with leader line in a drawing.



Usage
There are 2 ways to add a Balloon:
 * Select the View to which the Balloon will be attached.
 * 1) Press the  button.
 * 2) The cursor is now displayed as a balloon icon. Click on the page to place the Balloon origin to the desired position.
 * Select a drawing object in the page.
 * 1) Press the  button.
 * 2) If the selected object is a line or point, the Balloon is immediately added to it. For lines, it is automatically added at its center. If the object was an area, click at a position of the area where the Balloon should be added.

To drag the Balloon to the desired position, left-click on the Balloon and keep the mouse pressed while moving.

To change the balloon properties either double-clicking onto it in the drawing or double-click on the balloon object in the model tree. This will open the balloon dialog.

Note: The position of the balloon is relative to the View and uses the same scale factor as the View.

Using separators
When using a rectangle shape, separators can be added using "|" in the text. For example "AAA|TEST|111" gives:



Data

 * : Text to be displayed.
 * : Source View for the balloon.
 * : Balloon origin x-position relative to the View.
 * : Balloon origin y-position relative to the View.
 * : End symbol for the balloon line. Options: [[Image:Arrownone.svg|20px]] None, [[Image:Arrowfilled.svg|20px]] Filled Arrow, [[Image:Arrowopen.svg|20px]] Open Arrow, [[Image:Arrowtick.svg|20px]] Tick, [[Image:Arrowdot.svg|20px]] Dot, [[Image:arrowopendot.svg|20px]] Open Circle, [[Image:arrowfork.svg|20px]] Fork, [[Image:arrowpyramid.svg|20px]] Filled Triangle
 * : Scale factor for the End Type.
 * : Shape of the balloon bubble. Options: [[Image:Circular.svg|20px]] Circular, None, [[Image:Triangle.svg|20px]] Triangle, [[Image:Inspection.svg|20px]] Inspection, [[Image:Hexagon.svg|20px]] Hexagon, [[Image:TechDraw_Square.svg|20px]] Square, [[Image:Rectangle.svg|20px]] Rectangle
 * : Scale factor for the Shape.
 * : Text wrap length; -1 means the text will never be wrapped and the result is in every case a single line.
 * : Distance from the Shape to the leader line kink.
 * : Horizontal position of the balloon bubble relative to the View.
 * : Vertical position of the balloon bubble relative to the View.

View

 * : Color of the balloon text.
 * : The name of the font to use for the balloon bubble.
 * : Dimension text size in mm.
 * : Whether the balloon line is visible.
 * : Balloon line width

Scripting
TechDraw API and FreeCAD Scripting Basics.

The Balloon tool can be used in macros and from the Python console by using the following functions: