Draft Shape2DView: Difference between revisions

From FreeCAD Documentation
(Vertical GuiCommand. See also Part and Arch Workbenches. This tool can be used to create projections of those objects.)
(Redaction)
Line 12: Line 12:


<!--T:3-->
<!--T:3-->
This tool places in the document a 2D object which is a flattened view of a selected [[Part Module|Shape]]-based object, projected along the current view direction.
This tool produces a 2D projection from a selected 3D solid object such as those created with the [[Part Workbench|Part]], [[PartDesign Workbench|PartDesign]], or [[Arch Workbench]]es. The default projection direction is along the current view.


</translate>
</translate>

Revision as of 05:47, 14 November 2018

Draft Shape2DView

Menu location
Draft → Shape 2D View
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
-
See also
Part Workbench, Arch Workbench

Description

This tool produces a 2D projection from a selected 3D solid object such as those created with the Part, PartDesign, or Arch Workbenches. The default projection direction is along the current view.

How to use

  1. Select the object you want to extract a 2D view from
  2. Rotate the view (or use the view presets shortcuts) so it reflects the direction you want to project the object to. For example, using a Top view will project the object on the XY plane, vertically along the Z axis like on the image above.
  3. Press the Draft Shape2DView button

Options

  • If the selected object is an Arch SectionPlane, the 2D projection will be of the contents of the Section plane, and the projection vector will be taken from the section plane instead of the Projection property below.
  • The normal operating mode is Solid, which projects the whole shape, but, if you selected some faces of the base object when creating the 2D view, you can also set the Individual Faces mode, which will project only the faces that were selected.
  • If the selected object is an Arch SectionPlane, Cutlines and Cutfaces projection mode are also available, which project only the edges being cut by the section plane. Cutfaces mode displays the cut areas of solids as faces.

Properties

  • DataProjection: The direction of the projection.
  • DataProjection Mode: The mode of the projection: solid, individual faces, or cutlines.
  • DataIn Place: If this is True, when using Cutlines or Cutfaces mode (Arch SectionPlane only), the result will appear at the cut plane location instead of the ground plane introduced in version 0.17
  • DataHiddenLines: Shows hidden lines or not
  • DataTessellation: Tessellate Ellipses and BSplines into line segments
  • DataSegment Length: The size of segments if Tessellation is turned on
  • DataVisible Only: If True, this view will be recomputed only if it is visible

Scripting

The Draft Shape2DView tool can by used in macros and from the python console by using the following function:

makeShape2DView (object,[projection],[facenumbers])
  • Adds a 2D shape to the document, which is a 2D projection of the given object.
  • A specific projection vector can also be given.
  • Returns the generated object.
  • You can also provide a list of face numbers to be considered.

Example:

import FreeCAD,Draft
Draft.makeShape2DView(FreeCAD.ActiveDocument.ActiveObject)