TechDraw ArchView: Difference between revisions

From FreeCAD Documentation
m ({{PropertyData|Show Hidden}} correcting geometry)
No edit summary
Line 15: Line 15:
|Name=TechDraw ArchView
|Name=TechDraw ArchView
|MenuLocation=TechDraw → Insert Arch Workbench Object
|MenuLocation=TechDraw → Insert Arch Workbench Object
|Workbenches=[[TechDraw_Module|TechDraw]]
|Workbenches=[[TechDraw_Module|TechDraw]], [[Arch_Workbench|Arch Workbench]]
|Version=0.19
|Version=0.19
|SeeAlso=[[Arch_Workbench|Arch Workbench]], [[Arch_SectionPlane|Arch Section Plane]]
|SeeAlso=[[Arch_SectionPlane|Arch Section Plane]]
}}
}}


Line 23: Line 23:


<!--T:15-->
<!--T:15-->
The ArchView tool inserts a view of an {{KEY|[[Image:Arch SectionPlane.svg|16px]] [[Arch SectionPlane|Arch SectionPlane]]}} on a [[TechDraw New Default|TechDraw page]].
The ArchView tool inserts a view of an {{KEY|[[Image:Arch SectionPlane.svg|16px]] [[Arch_SectionPlane|Arch SectionPlane]]}} on a [[TechDraw_New Default|TechDraw page]].


<!--T:8-->
<!--T:8-->
Line 39: Line 39:


<!--T:17-->
<!--T:17-->
The ArchView is rendered within the [[Arch Workbench|Arch Workbench]], therefore TechDraw has limited control over its appearance. You may need to make changes within Arch to get the representation you want.
The ArchView is rendered within the [[Arch_Workbench|Arch Workbench]], therefore TechDraw has limited control over its appearance. You may need to make changes within Arch to get the representation you want.


==Options== <!--T:4-->
==Options== <!--T:4-->


<!--T:9-->
<!--T:9-->
* The Arch View is rendered by the [[Arch Module|Arch Module]], the same way as in the [[Drawing Workbench|Drawing Workbench]]. See Notes.
* The Arch View is rendered by the [[Arch_Module|Arch Module]], the same way as in the [[Drawing Workbench|Drawing Workbench]]. See Notes.
* [[Draft_Snap_Dimensions|Draft Dimensions]], [[Draft Text|Draft Texts]] and any other 2D (Sketch or Draft) object considered by the section plane is rendered "as is" (no intersection or hidden lines) on top of the solid geometry
* [[Draft_Snap_Dimensions|Draft Dimensions]], [[Draft_Text|Draft Texts]] and any other 2D (Sketch or Draft) object considered by the section plane is rendered "as is" (no intersection or hidden lines) on top of the solid geometry
* The volume of [[Arch Space|Arch Spaces]] is not rendered, only the label will be rendered
* The volume of [[Arch_Space|Arch Spaces]] is not rendered, only the label will be rendered
* Cut lines, projected lines (if Show Hidden property is set to True) and 2D lines above can be rendered with different line widths. This can be configured in the Arch preferences.
* Cut lines, projected lines (if Show Hidden property is set to True) and 2D lines above can be rendered with different line widths. This can be configured in the Arch preferences.
* The ArchView has two rendering modes: Wireframe, which uses the OpenCasCade algorithms of the [[Drawing Module|Drawing Module]], is fast and produces only lines (no face fill possible), and Solid, which is based on the [https://en.wikipedia.org/wiki/Painter%27s_algorithm Painter's algorithm], and is capable of rendering faces filled with their shape color. However, it is much slower and can fail in many situations. The image below illustrates the difference between the two rendering modes:
* The ArchView has two rendering modes: Wireframe, which uses the OpenCasCade algorithms of the [[Drawing_Module|Drawing Module]], is fast and produces only lines (no face fill possible), and Solid, which is based on the [https://en.wikipedia.org/wiki/Painter%27s_algorithm Painter's algorithm], and is capable of rendering faces filled with their shape color. However, it is much slower and can fail in many situations. The image below illustrates the difference between the two rendering modes:


<!--T:10-->
<!--T:10-->
Line 54: Line 54:


<!--T:11-->
<!--T:11-->
* Only the base line of [[Arch Pipe|Arch Pipes]] is rendered, not the full volume of the tube:
* Only the base line of [[Arch_Pipe|Arch Pipes]] is rendered, not the full volume of the tube:


<!--T:12-->
<!--T:12-->
Line 73: Line 73:


<!--T:18-->
<!--T:18-->
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:19-->
<!--T:19-->

Revision as of 21:04, 16 November 2020

TechDraw ArchView

Menu location
TechDraw → Insert Arch Workbench Object
Workbenches
TechDraw, Arch Workbench
Default shortcut
None
Introduced in version
0.19
See also
Arch Section Plane

Description

The ArchView tool inserts a view of an Arch SectionPlane on a TechDraw page.

Usage

  1. Select an Arch section plane in the 3D view or in the tree
  2. If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
  3. Press the Insert Arch Workbench Object button
  4. A view of the objects seen by the section plane will appear on the page.

Limitations

The ArchView is rendered within the Arch Workbench, therefore TechDraw has limited control over its appearance. You may need to make changes within Arch to get the representation you want.

Options

  • The Arch View is rendered by the Arch Module, the same way as in the Drawing Workbench. See Notes.
  • Draft Dimensions, Draft Texts and any other 2D (Sketch or Draft) object considered by the section plane is rendered "as is" (no intersection or hidden lines) on top of the solid geometry
  • The volume of Arch Spaces is not rendered, only the label will be rendered
  • Cut lines, projected lines (if Show Hidden property is set to True) and 2D lines above can be rendered with different line widths. This can be configured in the Arch preferences.
  • The ArchView has two rendering modes: Wireframe, which uses the OpenCasCade algorithms of the Drawing Module, is fast and produces only lines (no face fill possible), and Solid, which is based on the Painter's algorithm, and is capable of rendering faces filled with their shape color. However, it is much slower and can fail in many situations. The image below illustrates the difference between the two rendering modes:

  • Only the base line of Arch Pipes is rendered, not the full volume of the tube:

Properties

  • DataSource: The section plane object to be displayed
  • DataAll On: If hidden objects must be shown or not. If False, only objects that are visible in the 3D view are rendered
  • DataRender Mode: The render mode to use, Solid or Wireframe
  • DataShow Hidden: If the hidden geometry (the part of the geometry that lies behind the section plane) is shown or not. It will be rendered in dashed line, which can be configured in the Arch preferences.
  • DataShow Fill: If cut areas must be filled with a grey color or not
  • DataLine Width: The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences
  • DataFont Size: The size of all texts that appear in this view

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

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

dv = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewArch','TestArch')
dv.Source = mySectionPlane
rc = page.addView(dv)