Difference between revisions of "TechDraw Balloon"

From FreeCAD Documentation
Jump to navigation Jump to search
(Move UnfinishedDocu template above languages bar)
Line 20: Line 20:

Revision as of 09:38, 24 May 2019

This documentation is not finished. Please help and contribute documentation.

Gui Command explains how tools should be documented. See Draft ShapeString for an example of a well documented tool. Browse Category:UnfinishedDocu to see incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Other languages:
Deutsch • ‎English • ‎français • ‎italiano • ‎русский

TechDraw Balloon.svg TechDraw Balloon

Menu location
TechDraw → Balloon
Default shortcut
Introduced in version
0.19 (dev)
See also
TechDraw New annotation


The Balloon tool adds a ...

Techdraw balloon.png

Balloon ...

How to use

  1. Select the View to which the Balloon will be attached...
  2. Press the TechDraw Balloon.svg Balloon button
  3. A balloon will be added to the View. The balloon bubble may be dragged to the desired position. Use CTL-drag to move the bubble and the arrow.


Dimension objects are vulnerable to "topological naming" issues. This means that if you modify the 3D geometry the faces and edges of the model may be renamed internally; if a dimension is attached to an edge that is then modified, the dimension may break. In general, it is not possible to keep the projected 2D dimensions synchronized with the actual 3D objects.

Therefore, it is recommended that dimensions be added when the 3D model is no longer being modified.



  • DataX: Horizontal position of the balloon bubble relative to the View.
  • DataY: Vertical position of the balloon bubble relative to the View.


  • ViewFont: The name of the font to use for the balloon bubble.
  • ViewFontsize: Dimension text size in mm.


See also: TechDraw API 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)