TechDraw ActiveView: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(46 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:19-->
<!--T:19-->
{{Docnav
{{Docnav
|[[TechDraw_BrokenView|BrokenView]]
|[[TechDraw_View|Insert View]]
|[[TechDraw_ProjectionGroup|Insert Projection Group]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw View.svg
|IconL=TechDraw_BrokenView.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconC=Workbench_TechDraw.svg
}}
}}


Line 14: 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 Module|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=
|Version=0.19
|Version=0.19
|SeeAlso=[[TechDraw_Image|TechDraw Image]]
}}
}}


Line 23: 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>
[[File:TechDraw_ActiveView_example.png]]
[[File:TechDraw_ActiveView_example.png]]
<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-->


<!--T:12-->
<!--T:12-->
# Navigate to the 3D window you wish to copy.
# Navigate to the correct [[3D_view|3D view]].
# If you have multiple drawing pages in your document, you will also need to select the desired page in the tree.
# 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:
# Press the {{Button|[[Image:TechDraw ActiveView.svg|16px]] [[TechDraw ActiveView|Insert Active View]]}} button
#* Press the {{Button|[[Image:TechDraw_ActiveView.svg|16px]] [[TechDraw_ActiveView|Insert Active View (3D View)]]}} button.
# A dialog will open to allow you to specify the size, border and background color of the copy.
#* 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}}
## Select the desired page.
## Press the {{Button|OK}} button.
# The {{MenuCommand|ActiveView to TD View}} task panel opens. See [[#Options|Options]] for more information.
# Press the {{Button|OK}} button.

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

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

<!--T:25-->
* {{MenuCommand|Crop}}: Crop the generated bitmap.
* {{MenuCommand|Width}}: The width (in mm) to crop the generated view.
* {{MenuCommand|Height}}: The height (in mm) to crop the generated view.
* {{MenuCommand|No Background}}: If checked, the generated bitmap will have a transparent background.
* {{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.


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


<!--T:13-->
<!--T:13-->
* Active views 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.
* ActiveView is a SymbolView behind the scenes. The ActiveView scale is therefore always initialized to Custom at creation.
* 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 [[Image:Techdraw-symbol.svg|16px]] [[TechDraw Symbol|Symbol]]
See [[TechDraw_Image#Properties|TechDraw Image]].



=== Dialog Fields === <!--T:14-->
* {{PropertyData|Width}}: The width of the generated view.
* {{PropertyData|Height}}: The height of the generated view.
* {{PropertyData|Border}}: The amount of empty space to be left around the view (but within Width x Height).
* {{PropertyData|Background}}: Show or hide a background.
* {{PropertyData|Background Color}}: Color to paint the background, if applicable.
* {{PropertyData|Line Width}}: Thickness of individual lines in the view.
* {{PropertyData|Render Mode}}: Various special effects. See Coin3d SoRenderManager for details.

==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|Insert View]]
|[[TechDraw_ProjectionGroup|Insert Projection Group]]
|[[TechDraw_ProjectionGroup|ProjectionGroup]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw View.svg
|IconL=TechDraw_BrokenView.svg
|IconR=TechDraw_ProjectionGroup.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_ProjectionGroup.svg
}}
}}


<!--T:17-->
{{TechDraw Tools navi}}

<!--T:18-->
{{Userdocnavi}}
</translate>
</translate>
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

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.