TechDraw ActiveView: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(21 intermediate revisions by 3 users not shown)
Line 4: Line 4:
<!--T:19-->
<!--T:19-->
{{Docnav
{{Docnav
|[[TechDraw_BrokenView|BrokenView]]
|[[TechDraw_View|View]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_Workbench|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw View.svg
|IconL=TechDraw_BrokenView.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
Line 15: Line 15:
{{GuiCommand
{{GuiCommand
|Name=TechDraw ActiveView
|Name=TechDraw ActiveView
|MenuLocation=TechDraw → Insert Active View (3D View)
|MenuLocation=TechDraw → Views From Other Workbenches → Insert Active View (3D View)
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|Version=0.19
|Version=0.19
|SeeAlso=[[TechDraw_Symbol|TechDraw Symbol]]
|SeeAlso=[[TechDraw_Image|TechDraw Image]]
}}
}}


Line 24: Line 24:


<!--T:10-->
<!--T:10-->
The ActiveView tool inserts a copy of a 3D window into a drawing page.
The '''TechDraw ActiveView''' tool inserts a bitmap image of the active 3D window into a drawing page.


</translate>
</translate>
Line 30: Line 30:
<translate>
<translate>
<!--T:21-->
<!--T:21-->
{{Caption|A simple view from the 3D model that doesn't perform any complex calculation.}}
{{Caption|A simple view from the 3D model.}}


==Usage== <!--T:3-->
==Usage== <!--T:3-->
Line 36: Line 36:
<!--T:12-->
<!--T:12-->
# Navigate to the correct [[3D_view|3D view]].
# Navigate to the correct [[3D_view|3D view]].
# If there are multiple drawing pages in the document: optionally select the desired page in the [[Tree_view|Tree view]]. This is not optional for {{VersionMinus|0.19}}.
# If there are multiple drawing pages in the document: optionally select the desired page in the [[Tree_view|Tree view]].
# There are several ways to invoke the tool:
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:TechDraw_ActiveView.svg|16px]] [[TechDraw_ActiveView|Insert Active View (3D View)]]}} button.
#* Press the {{Button|[[Image:TechDraw_ActiveView.svg|16px]] [[TechDraw_ActiveView|Insert Active View (3D View)]]}} button.
#* Select the {{MenuCommand|TechDraw → [[Image:TechDraw_ActiveView.svg|16px]] Insert Active View (3D View)}} option from the menu.
#* Select the {{MenuCommand|TechDraw → Views From Other Workbenches → [[Image:TechDraw_ActiveView.svg|16px]] Insert Active View (3D View)}} 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}}
# 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}}
## Select the desired page.
## Select the desired page.
Line 46: Line 46:
# Press the {{Button|OK}} button.
# Press the {{Button|OK}} button.


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


<!--T:24-->
The following can be specified:
The following can be specified:


<!--T:25-->
* {{MenuCommand|Width}}: The width of the generated view.
* {{MenuCommand|Height}}: The height of the generated view.
* {{MenuCommand|Crop}}: Crop the generated bitmap.
* {{MenuCommand|Border}}: The amount of empty space to be left around the view (but within Width x Height).
* {{MenuCommand|Width}}: The width (in mm) to crop the generated view.
* {{MenuCommand|Background}}: If checked a background with the specified color is added.
* {{MenuCommand|Height}}: The height (in mm) to crop the generated view.
* {{MenuCommand|Line Width}}: The thickness of the lines in the view.
* {{MenuCommand|No Background}}: If checked, the generated bitmap will have a transparent background.
* {{MenuCommand|Render Mode}}: The available modes are:
* {{MenuCommand|Solid Background}}: If checked, the generated will have a background of the selected color.
* {{MenuCommand|Use 3d Background}}: If checked, the generated bitmap will use the background from the 3D window.
** {{Value|As is}}: Render primitives as they are.
** {{Value|Wireframe}}: Render polygons as wireframe.
** {{Value|Points}}: Render only the vertices of the polygons and lines.
** {{Value|Wireframe overlay}}: Render a wireframe overlay in addition to the {{Value|As is}} mode.
** {{Value|Hidden Line}}: As {{Value|Wireframe}}, but culls lines which would otherwise not be shown due to geometric culling.
** {{Value|Bounding box}}: Only show the bounding box of each object.


== Notes == <!--T:7-->
== Notes == <!--T:7-->
Line 67: Line 63:
<!--T:13-->
<!--T:13-->
* ActiveViews are static once generated, they are never updated with changes to the 3D model.
* ActiveViews are static once generated, they are never updated with changes to the 3D model.
* An ActiveView behind the scenes is a [[TechDraw_Symbol|Symbol]]. Its {{PropertyData|Scale Type}} is therefore always initialized as {{Value|Custom}}.
* An ActiveView behind the scenes is an [[TechDraw_Image|Image]]. Its {{PropertyData|Scale Type}} is therefore always initialized as {{Value|Custom}}.
* In {{VersionMinus|0.20}} ActiveView was a [[TechDraw_Symbol|Symbol]].
* This tool is still somewhat '''Experimental'''.


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


<!--T:22-->
<!--T:22-->
See [[TechDraw_Symbol|TechDraw Symbol]].
See [[TechDraw_Image#Properties|TechDraw Image]].

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

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

<!--T:16-->
The ActiveView tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:

</translate>
{{Code|code=
import TechDrawGui
TechDrawGui.copyActiveViewToSvgFile(Gui.ActiveDocument.ActiveView,"myFile.svg")
}}
<translate>




<!--T:20-->
<!--T:20-->
{{Docnav
{{Docnav
|[[TechDraw_BrokenView|BrokenView]]
|[[TechDraw_View|View]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_Workbench|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw View.svg
|IconL=TechDraw_BrokenView.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg

Latest revision as of 09:26, 8 April 2024

TechDraw ActiveView

Menu location
TechDraw → Views From Other Workbenches → Insert Active View (3D View)
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw Image

Description

The TechDraw ActiveView tool inserts a bitmap image of the active 3D window into a drawing page.

A simple view from the 3D model.

Usage

  1. Navigate to the correct 3D view.
  2. If there are multiple drawing pages in the document: optionally select the desired page in the Tree view.
  3. There are several ways to invoke the tool:
    • Press the Insert Active View (3D View) button.
    • Select the TechDraw → Views From Other Workbenches → Insert Active View (3D View) 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.
  5. The ActiveView to TD View task panel opens. See Options for more information.
  6. Press the OK button.

Options

The following can be specified:

  • Crop: Crop the generated bitmap.
  • Width: The width (in mm) to crop the generated view.
  • Height: The height (in mm) to crop the generated view.
  • No Background: If checked, the generated bitmap will have a transparent background.
  • Solid Background: If checked, the generated will have a background of the selected color.
  • Use 3d Background: If checked, the generated bitmap will use the background from the 3D window.

Notes

  • ActiveViews are static once generated, they are never updated with changes to the 3D model.
  • An ActiveView behind the scenes is an Image. Its DataScale Type is therefore always initialized as Custom.
  • In version 0.20 and below ActiveView was a Symbol.

Properties

See TechDraw Image.