GuiCommand: Name: TechDraw Balloon MenuLocation: TechDraw , Annotations , Insert Balloon Annotation Workbenches: TechDraw_Workbench Version: 0.19 SeeAlso: TechDraw_Annotation

TechDraw Balloon

Description

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

Usage

1. Select one of the following:
   • A View (on the page or in the Tree view).
   • A vertex in a View.
   • An edge in a View.
   • A closed region in a View.
2. There are several ways to invoke the tool:
   • Press the Insert Balloon Annotation button.
   • Select the TechDraw → Annotations → Insert Balloon Annotation option from the menu.
3. If a View or a region was selected:
   1. The cursor changes to a balloon icon.
   2. 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:

Properties

Data

• Text: Text to be displayed.

• Source View: Source View for the balloon.

• Origin X: Balloon origin x-position relative to the View.

• Origin Y: Balloon origin y-position relative to the View.

• End Type: End symbol for the balloon line. Options: Filled Arrow, Open Arrow, Tick, Dot, Open Circle, Fork, Filled Triangle, None.

• End Type Scale: Scale factor for the End Type.

• Bubble Shape: Shape of the balloon bubble. Options: Circular, None, Triangle, Inspection, Hexagon, Square, Rectangle.

• Shape Scale: Scale factor for the Shape.

• Text Wrap: Text wrap length; -1 means the text will never be wrapped and the result is in every case a single line.

• Kink Length: Distance from the Shape to the leader line kink.

• X: Horizontal position of the balloon bubble relative to the View.

• Y: Vertical position of the balloon bubble relative to the View.

View

• Color: Color of the balloon text.

• Font: The name of the font to use for the balloon bubble.

• Fontsize: Dimension text size in mm.

• Line Visible: Whether the balloon line is visible.

• Line Width: Balloon line width

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

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

bal1 = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewBalloon','Balloon')
rc = page.addView(bal1)

{{TechDraw_Tools_navi}}

⏵ documentation index > TechDraw > TechDraw Balloon

This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/TechDraw_Balloon.md