TechDraw ArchView: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(8 intermediate revisions by 4 users not shown)
Line 3: Line 3:
<!--T:22-->
<!--T:22-->
{{Docnav
{{Docnav
|[[TechDraw_DraftView|Insert Draft Workbench Object]]
|[[TechDraw_DraftView|Draft View]]
|[[TechDraw_SpreadsheetView|Insert Spreadsheet View]]
|[[TechDraw_SpreadsheetView|Spreadsheet View]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Module|TechDraw]]
|IconL=TechDraw DraftView.svg
|IconL=TechDraw_DraftView.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_SpreadsheetView.svg
|IconR=TechDraw_SpreadsheetView.svg
|IconC=Workbench_TechDraw.svg
}}
}}


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]]
|SeeAlso=[[Arch Workbench|Arch Workbench]], [[Arch SectionPlane|Arch Section Plane]]
|SeeAlso=[[Arch_SectionPlane|Arch Section Plane]]
}}
}}


Line 22: Line 22:


<!--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 32: Line 32:
# Select an Arch section plane in the 3D view or in the tree
# Select an Arch section plane in the 3D view or in the tree
# If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
# If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
# Press the {{KEY|[[Image:TechDraw ArchView.svg|24px]] [[TechDraw_ArchView|Insert Arch Workbench Object]]}} button
# Press the {{KEY|[[Image:TechDraw_ArchView.svg|24px]] [[TechDraw_ArchView|Insert Arch Workbench Object]]}} button
# A view of the objects seen by the section plane will appear on the page.
# A view of the objects seen by the section plane will appear on the page.


Line 38: Line 38:


<!--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 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 53: Line 53:


<!--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 64: Line 64:
* {{PropertyData|All On}}: If hidden objects must be shown or not. If False, only objects that are visible in the 3D view are rendered
* {{PropertyData|All On}}: If hidden objects must be shown or not. If False, only objects that are visible in the 3D view are rendered
* {{PropertyData|Render Mode}}: The render mode to use, Solid or Wireframe
* {{PropertyData|Render Mode}}: The render mode to use, Solid or Wireframe
* {{PropertyData|Show Hidden}}: If the hidden geometry (the part of the goemetry 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.
* {{PropertyData|Show 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.
* {{PropertyData|Show Fill}}: If cut areas must be filled with a grey color or not
* {{PropertyData|Show Fill}}: If cut areas must be filled with a grey color or not
* {{PropertyData|Line Width}}: The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences
* {{PropertyData|Line Width}}: The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences
Line 72: Line 72:


<!--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-->
The New Arch tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following functions:
The New Arch tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:


</translate>
</translate>
Line 87: Line 87:
<!--T:23-->
<!--T:23-->
{{Docnav
{{Docnav
|[[TechDraw_DraftView|Insert Draft Workbench Object]]
|[[TechDraw_DraftView|Draft View]]
|[[TechDraw_SpreadsheetView|Insert Spreadsheet View]]
|[[TechDraw_SpreadsheetView|Spreadsheet View]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Module|TechDraw]]
|IconL=TechDraw DraftView.svg
|IconL=TechDraw_DraftView.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_SpreadsheetView.svg
|IconR=TechDraw_SpreadsheetView.svg
|IconC=Workbench_TechDraw.svg
}}
}}



Revision as of 12:44, 3 January 2021

TechDraw ArchView

Menu location
TechDraw → Insert Arch Workbench Object
Workbenches
TechDraw, Arch
Default shortcut
None
Introduced in version
-
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)