Draft Shape2DView/pl

Description
The tool produces a 2D projection from a selected 3D solid object such as those created with the, , and  Workbenches.

The resulting projection is a Draft object and is placed in the 3D view. This object can be displayed on a Workbench page, using the TechDraw DraftView tool. Alternatively, TechDraw has its own tools to create projected views, the and  tools; however, these tools are meant for preparing technical drawings, so they create the views only in the drawing page, and not in the 3D view.



Usage

 * 1) Rotate the view so it reflects the direction of the desired projection. For example, a top view will project the object on the XY plane.
 * 2) Select a 3D object.
 * 3) Press the  button. If no object is selected, you will be invited to select one.

The projected object will be created below the selected object, lying on the XY plane. It's position can be changed by changing its properties. The projection direction can also be changed after creation with the property editor.

Note: If the selected object is an, the projection will use the contents and direction of that Section plane; in this case, the "Projection" property will be ignored.

Options
There are no options for this tool. Either it works with the selected object or not.

Properties
See also: Property editor.

A Draft Shape2DView object is derived from a Part Part2DObject and inherits all its properties. It also has the following additional properties:

Data

 * : specifies the object to be projected.
 * : specifies the indices of the faces to be projected. Only works if is.
 * : specifies if Arch objects of the same type and material are fused or not.
 * : specifies if hidden lines are shown or not.
 * : only works if the selected object is an Arch SectionPlane, and is  or, specifies if the projection will appear co-planar with the section plane.
 * : specifies the direction of the projection.
 * : specifies the projection mode. The following modes are available:
 * : projects the entire selected object.
 * : only projects the faces in the list.
 * : only works if the selected object is an Arch SectionPlane, projects only the edges cut by the section plane.
 * : only works if the selected object is an Arch SectionPlane, projects the areas cut through solids by the section plane as faces.
 * : projects the entire selected object by cutting faces one by one. Can be used if the mode gives wrong results.
 * : specifies the size in millimeters of linear segments if is.
 * : specifies if tessellation should be performed. Tessellation means that curves are replaced by sequences of line segments. This can be computationally intensive if the is too short.
 * : specifies if the projection should only be recomputed if it is visible.
 * : A list of exclusion points. Any edge passing through any of those points will not be drawn.

View

 * : not used.
 * : not used.

How to produce plans and sections with different linewidths


Drawings with different linewidths for viewed and cut lines can easily be produced by using two shape2Dview objects from a same Arch SectionPlane. One of the shape2Dview objects has its projection mode set to Solid, which renders the viewed lines, and another set to Cut lines or Cut faces to render the cut lines. The two shape2Dviews are then placed at the same location, one on top of the other.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a 2D projection use the method  of the Draft module. This method replaces the deprecated method.


 * is the object to be projected.
 * is the projection vector. If not supplied the Z axis is used.
 * is a list of face numbers (0-based). If supplied only these faces are considered.
 * is returned with the created 2D projection.

Change the property of the created object if required. It can be:, , , or.

Example: