TechDraw Balloon/en

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



Usage

 * 1) Select one of the following:
 * 2) * A View (on the page or in the Tree view).
 * 3) * A vertex in a View.
 * 4) * An edge in a View.
 * 5) * A closed region in a View.
 * 6) There are several ways to invoke the tool:
 * 7) * Press the button.
 * 8) * Select the option from the menu.
 * 9) If a View or a region was selected:
 * 10) The cursor changes to a balloon icon.
 * 11) Click a point on the page for the origin of the Balloon.

To move the bubble of a Balloon, press and hold the left mouse button on its center and drag the mouse.

To change the properties of a Balloon double-click it on the page or in the Tree view. This will open the Balloon task panel.

Note: The position of a Balloon is relative to its Source View and uses the same scale factor.

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: