TechDraw ActiveView

From FreeCAD Documentation
Revision as of 16:37, 14 April 2022 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

TechDraw ActiveView

Menu location
TechDraw → Insert Active View (3D View)
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw Symbol

Description

The ActiveView tool inserts a copy of a 3D window into a drawing page.

A simple view from the 3D model that doesn't perform any complex calculation.

Usage

  1. Navigate to the correct 3D view.
  2. If there are multiple drawing pages in the document: optionally select the desired page in the Tree view. This is not optional for version 0.19 and below.
  3. There are several ways to invoke the tool:
  4. If there are multiple drawing pages in the document and you have not yet selected a page, the Page Chooser dialog box opens: introduced in version 0.20
    1. Select the desired page.
    2. Press the OK button.
  5. The ActiveView to TD View task panel opens. See Options for more information.
  6. Press the OK button.

Options

The following can be specified:

  • Width: The width of the generated view.
  • Height: The height of the generated view.
  • Border: The amount of empty space to be left around the view (but within Width x Height).
  • Background: If checked a background with the specified color is added.
  • Line Width: The thickness of the lines in the view.
  • Render Mode: The available modes are:
    • As is: Render primitives as they are.
    • Wireframe: Render polygons as wireframe.
    • Points: Render only the vertices of the polygons and lines.
    • Wireframe overlay: Render a wireframe overlay in addition to the As is mode.
    • Hidden Line: As Wireframe, but culls lines which would otherwise not be shown due to geometric culling.
    • Bounding box: Only show the bounding box of each object.

Notes

  • ActiveViews are static once generated, they are never updated with changes to the 3D model.
  • An ActiveView behind the scenes is a Symbol. Its DataScale Type is therefore always initialized as Custom.
  • This tool is still somewhat Experimental.

Properties

See TechDraw Symbol.

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

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

import TechDrawGui
TechDrawGui.copyActiveViewToSvgFile(Gui.ActiveDocument.ActiveView,"myFile.svg")