TechDraw Balloon
Jump to navigation
Jump to search
TechDraw
User documentation
Menu location |
---|
TechDraw → Balloon |
Workbenches |
TechDraw |
Default shortcut |
None |
Introduced in version |
0.19 |
See also |
TechDraw New annotation |
Description
The Balloon tool can add balloons with leader line in a drawing.
Usage
- Select the View to which the Balloon will be attached.
- Press the
Balloon button.
- The cursor is now displayed as a balloon icon. Click on the page to place the balloon origin to the desired position.
- The balloon bubble may be dragged to the desired position. Use Ctrl+drag to move the bubble and the arrow.
- 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 than the View.
Using separators
When using a rectangle shape, separators can be added using "|" in the text. For example "AAA|TEST|111" gives:
Properties
Data
- DataText: Text to be displayed.
- DataSource View: Source View for the balloon.
- DataOrigin X: Balloon origin x-position relative to the View.
- DataOrigin Y: Balloon origin y-position relative to the View.
- DataEnd Type: End symbol for the balloon line. Options:
None,
Filled Arrow,
Open Arrow,
Tick,
Dot,
Open Circle,
Fork,
Filled Triangle
- DataEnd Type Scale: Scale factor for the End Type.
- DataBubble Shape: Shape of the balloon bubble. Options:
Circular, None,
Triangle,
Inspection,
Hexagon,
Square,
Rectangle
- DataShape Scale: Scale factor for the Shape.
- DataText Wrap: Text wrap length; -1 means the text will never be wrapped and the result is in every case a single line.
- DataKink Length: Distance from the Shape to the leader line kink.
- DataX: Horizontal position of the balloon bubble relative to the View.
- DataY: Vertical position of the balloon bubble relative to the View.
View
- ViewColor: Color of the balloon text.
- ViewFont: The name of the font to use for the balloon bubble.
- ViewFontsize: Dimension text size in mm.
- ViewLine Visible: Whether the balloon line is visible.
- ViewLine Width: Balloon line width
Scripting
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)
- Pages: Insert Default Page, Insert Page using Template, Redraw Page
- Views: Insert View, Insert Active View, Insert Projection Group, Insert Section View, Insert Detail View, Insert Draft Workbench Object, Insert Arch Workbench Object, Insert Spreadsheet View
- Clips: Insert Clip Group, Add View to Clip Group, Remove View from Clip Group
- Dimensions: New Length, New Horizontal, New Vertical, New Radius, New Diameter, New Angle, New Angle3Pt, New Links, New Balloon
- Decorations: Hatch Face using Image File, Apply Geometric Hatch to Face, Insert SVG Symbol, Insert Bitmap Image, Turn View Frames On/Off
- Annotations: Insert Annotation, Add Leaderline to View, Insert Rich Text Annotation, Add Cosmetic Vertex, Add Midpoint Vertices, Add Quadrant Vertices, Add Centerline to Face(s), Add Centerline between 2 Lines, Add Centerline between 2 Points, Remove Cosmetic Object, Change Appearance of Line(s), Show/Hide Invisible Edges, Add Welding Information to Leader
- Import/Export: Export Page as SVG, Export Page as DXF
- Additional: Preferences; Hatching, LineGroup, Templates; TechDraw API, TechDrawGui API

- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties; Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base; Arch, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Raytracing, Reverse Engineering, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Deprecated or unmaintained workbenches: Complete, Drawing, Robot
- Hubs: User hub, Power users hub, Developer hub