TechDraw Balloon: Difference between revisions

From FreeCAD Documentation
(relink module to workbench)
(Updated to match new page names.)
Line 4: Line 4:
<!--T:23-->
<!--T:23-->
{{Docnav
{{Docnav
|[[TechDraw_LinkDimension|LinkDimension]]
|[[TechDraw_Dimension_Link|Dimension Link]]
|[[TechDraw_LandmarkDimension|LandmarkDimension]]
|[[TechDraw_Dimension_Landmark|Dimension Landmark]]
|[[TechDraw_Workbench|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_Dimension_Link.svg
|IconL=TechDraw_LinkDimension.svg
|IconR=TechDraw_Dimension_Landmark.svg
|IconR=TechDraw_LandmarkDimension.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
}}
}}
Line 92: Line 92:
<!--T:24-->
<!--T:24-->
{{Docnav
{{Docnav
|[[TechDraw_LinkDimension|LinkDimension]]
|[[TechDraw_Dimension_Link|Dimension Link ]]
|[[TechDraw_LandmarkDimension|LandmarkDimension]]
|[[TechDraw_Dimension_Landmark|Dimension Landmark]]
|[[TechDraw_Workbench|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_Dimension_Link.svg
|IconL=TechDraw_LinkDimension.svg
|IconR=TechDraw_Dimension_Landmark.svg
|IconR=TechDraw_LandmarkDimension.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
}}
}}
Line 103: Line 103:
{{TechDraw Tools navi{{#translation:}}}}
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 18:29, 15 September 2021

TechDraw Balloon

Menu location
TechDraw → Annotations → Insert Balloon Annotation
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw Annotation

Description

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

Usage

  1. Select the View to which the Balloon will be attached.
  2. Press the Balloon button.
  3. The cursor is now displayed as a balloon icon. Click on the page to place the balloon origin to the desired position.
  4. The balloon bubble may be dragged to the desired position. Use Ctrl+drag to move the bubble and the arrow.
  5. 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 as 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)