TechDraw ArchView: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:22-->
<!--T:22-->
{{Docnav
{{Docnav
|[[TechDraw_DraftView|Insert Draft Workbench Object]]
|[[TechDraw_DraftView|DraftView]]
|[[TechDraw_SpreadsheetView|Insert Spreadsheet View]]
|[[TechDraw_SpreadsheetView|SpreadsheetView]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|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 14: Line 15:
{{GuiCommand
{{GuiCommand
|Name=TechDraw ArchView
|Name=TechDraw ArchView
|MenuLocation=TechDraw → Insert Arch Workbench Object
|MenuLocation=TechDraw → Views From Other Workbenches → Insert Arch Workbench Object
|Workbenches=[[TechDraw_Module|TechDraw]], [[Arch_Workbench|Arch Workbench]]
|Workbenches=[[TechDraw_Workbench|TechDraw]], [[Arch_Workbench|Arch]]
|Version=0.19
|SeeAlso=[[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 '''TechDraw ArchView''' tool inserts a view of an {{KEY|[[Image:Arch_SectionPlane.svg|16px]] [[Arch_SectionPlane|Arch SectionPlane]]}} on a [[TechDraw_PageDefault|TechDraw page]].


</translate>
<!--T:8-->
[[Image:TechDraw Arch example.jpg]]
[[Image:TechDraw Arch example.jpg]]
<translate>


==Usage== <!--T:3-->
==Usage== <!--T:3-->


<!--T:16-->
<!--T:16-->
# Select an Arch section plane in the 3D view or in the tree
# Select a single Arch section plane in the [[3D_view|3D view]] or [[Tree_view|Tree view]].
# If you have multiple drawing pages in your document, you will need to select the desired page in the tree.
# If there are multiple drawing pages in the document: optionally add the desired page to the selection by selecting it in the [[Tree_view|Tree view]].
# There are several ways to invoke the tool:
# Press the {{KEY|[[Image:TechDraw ArchView.svg|24px]] [[TechDraw_ArchView|Insert Arch Workbench Object]]}} button
#* Press the {{Button|[[Image:TechDraw_ArchView.svg|16px]] [[TechDraw_ArchView|Insert Arch Workbench Object]]}} button.
# A view of the objects seen by the section plane will appear on the page.
#* Select the {{MenuCommand|TechDraw → Views From Other Workbenches → [[Image:TechDraw_ArchView.svg|16px]] Insert Arch Workbench Object}} option from the menu.

# If there are multiple drawing pages in the document and you have not yet selected a page, the {{MenuCommand|Page Chooser}} dialog box opens: {{Version|0.20}}
=== Limitations === <!--T:14-->
## Select the desired page.

## Press the {{Button|OK}} button.
<!--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.


==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_Workbench|Arch Workbench]].
* [[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:
* 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:
** Wireframe, which uses the OpenCasCade algorithms of the [[TechDraw_Workbench|TechDraw Workbench]], is fast and produces only lines (no face fill possible)
** 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:


</translate>
<!--T:10-->
[[Image:TechDraw Arch rendering.jpg]]
: [[Image:TechDraw Arch rendering.jpg]]
<translate>


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


</translate>
<!--T:12-->
[[Image:TechDraw Arch piping.jpg]]
: [[Image:TechDraw Arch piping.jpg]]
<translate>

==Notes== <!--T:27-->

<!--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.


==Properties== <!--T:5-->
==Properties== <!--T:5-->

<!--T:24-->
See also [[TechDraw_View#Properties|TechDraw View]].

=== Data === <!--T:25-->

<!--T:26-->
{{TitleProperty|Arch view}}


<!--T:13-->
<!--T:13-->
* {{PropertyData|Source}}: The section plane object to be displayed
* {{PropertyData|Source|Link}}: The section plane object to be displayed.
* {{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|Bool}}: 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|Enumeration}}: The render mode to use, {{Value|Solid}} or {{Value|Wireframe}}.
* {{PropertyData|Fill Spaces|Bool}}: If {{TRUE}}, Arch Spaces are shown as a colored area.
* {{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 Hidden|Bool}}: 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|Line Width}}: The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences
* {{PropertyData|Show Fill|Bool}}: If cut areas must be filled with a grey color or not.
* {{PropertyData|Font Size}}: The size of all texts that appear in this view
* {{PropertyData|Line Width|Float}}: The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences.
* {{PropertyData|Font Size|Float}}: The size of all texts that appear in this view.
* {{PropertyData|Cut Line Width|Float}}: Width of the cut lines in this view.
* {{PropertyData|Join Arch|Bool}}: If {{TRUE}}, walls and structures will be fused by material.


==Scripting== <!--T:6-->
==Scripting== <!--T:6-->


<!--T:18-->
<!--T:18-->
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] 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 ArchView tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:


</translate>
</translate>
Line 85: Line 106:
}}
}}
<translate>
<translate>



<!--T:23-->
<!--T:23-->
{{Docnav
{{Docnav
|[[TechDraw_DraftView|Insert Draft Workbench Object]]
|[[TechDraw_DraftView|DraftView]]
|[[TechDraw_SpreadsheetView|Insert Spreadsheet View]]
|[[TechDraw_SpreadsheetView|SpreadsheetView]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|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 99: Line 121:
{{TechDraw Tools navi{{#translation:}}}}
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 08:08, 26 July 2023

TechDraw ArchView

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

Description

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

Usage

  1. Select a single Arch section plane in the 3D view or Tree view.
  2. If there are multiple drawing pages in the document: optionally add the desired page to the selection by selecting it in the Tree view.
  3. There are several ways to invoke the tool:
    • Press the Insert Arch Workbench Object button.
    • Select the TechDraw → Views From Other Workbenches → Insert Arch Workbench Object option from the menu.
  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.

Options

  • The Arch View is rendered by the Arch Workbench.
  • 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 TechDraw Workbench, is fast and produces only lines (no face fill possible)
    • 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:

Notes

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.

Properties

See also TechDraw View.

Data

Arch view

  • DataSource (Link): The section plane object to be displayed.
  • DataAll On (Bool): If hidden objects must be shown or not. If false, only objects that are visible in the 3D view are rendered.
  • DataRender Mode (Enumeration): The render mode to use, Solid or Wireframe.
  • DataFill Spaces (Bool): If true, Arch Spaces are shown as a colored area.
  • DataShow Hidden (Bool): 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 (Bool): If cut areas must be filled with a grey color or not.
  • DataLine Width (Float): The width of the main lines. Cut lines and projected/2D line widths ratios can be configured in the Arch preferences.
  • DataFont Size (Float): The size of all texts that appear in this view.
  • DataCut Line Width (Float): Width of the cut lines in this view.
  • DataJoin Arch (Bool): If true, walls and structures will be fused by material.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

The ArchView 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)