TechDraw DetailView

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎français • ‎italiano

TechDraw DetailView.svg TechDraw DetailView

Menu location
TechDraw → Insert Detail View
Default shortcut
Introduced in version
See also
Insert View, Insert Projection Group


The Detail tool creates a view of small area of an existing view.


Detail view with circular viewbox of an existing view


  • Select a view in the page or tree.
  • Press the TechDraw DetailView.svg Insert Detail View button to create the detail view.
  • In the appearing task dialog you can define the radius of the view box, the scale and the view position. For the latter you can do this
    • either by changing the coordinates
    • or by pressing the button Drag Highlight. In this case the detail origin border is highlighted bold and with the label drag. Click on the border or the label, keep the mouse button pressed and drag it to the position you like. Finally release the mouse to accept the change.

The Detail view can be displayed within a round or square view box. This is controlled by the preferences setting Detail View Outline Shape.


Detail View

  • DataBaseView: The view on which this Detail view is based.
  • DataAnchor Point: The center of the Detail view within the DataBaseView.
  • DataRadius: The size of the area in the DataBaseView that is displayed in the Detail view.
  • DataScale Type: Type of the scale. The choices are:
    • Page: The scale factor of the drawing Page is used
    • Automatic: In case the detail view would be larger than the page, it will be scaled down to fit into the page
    • Custom: A custom scale factor set by DataScale
  • DataScale: Magnification level.
  • DataReference: An identifier to indicate the area of the DataBaseView that is displayed.

Base View

A Detail view inherits all applicable properties of the view specified as DataBaseView. In the properties of this view you can change the appearance of the detail outline:

  • ViewHighlight Adjust: Clockwise rotation angle of the Detail view.
  • ViewHighlight Line Color: Line color for the outline shape. Default setting for this is the setting Detail Highlight in the TechDraw preferences.
  • ViewHighlight Line Style: Line style for the outline shape. Default setting for this is the setting Detail Highlight Style in the TechDraw preferences.


See also: TechDraw API and FreeCAD Scripting Basics.

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

Detail = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewDetail','Detail')


  • The space around the view outline and the view object border is by default a white area. This means it covers everything behind it. Sometimes there is not enough space on the page and you can save space by reducing this unnecessary white area.
    This is done by putting the Detail view into a clip group:

TechDraw DetailClipped.png

Detail view in a clip group

  • For detail views with a round outline, the position of the reference label in the base view can be changed via the base view property ViewHighlight Adjust.