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
- 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.
- 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.
- Press the
- If a View or a region was selected:
- The cursor changes to a balloon icon.
- 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