TechDraw ProjectionGroup/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
{{Docnav/de
|[[TechDraw_ActiveView/de|AktiveAnsicht]]
|[[TechDraw_ActiveView/de|AktiveAnsicht]]
Line 12: Line 13:
|Name=TechDraw ProjectionGroup
|Name=TechDraw ProjectionGroup
|Name/de=TechDraw Ansichtengruppe
|Name/de=TechDraw Ansichtengruppe
|MenuLocation=TechDraw → Ansichtengruppe einfügen
|MenuLocation=TechDraw→ TechDraw Ansichten → Ansichtengruppe einfügen
|Workbenches=[[TechDraw_Workbench/de|TechDraw]]
|Workbenches=[[TechDraw_Workbench/de|TechDraw]]
|SeeAlso=[[TechDraw_View/de|TechDraw Ansicht einfügen]], [[TechDraw_SectionView/de|TechDraw Schnitt Ansicht einfügen]]
|SeeAlso=[[TechDraw_View/de|TechDraw Ansicht einfügen]], [[TechDraw_SectionView/de|TechDraw Schnittansicht einfügen]]
}}
}}


<span id="Description"></span>
==Beschreibung==
==Beschreibung==


Das Werkzeug [[Image:TechDraw ProjectionGroup.svg|24px]] [[TechDraw_ProjectionGroup/de|Ansichtengruppe]] erstellt eine Mehrtafelprojektion eines oder mehrerer 3D-Objekte (Siehe [https://de.wikipedia.org/wiki/Normalprojektion Normalprojektion]).
Das Werkzeug '''TechDraw Ansichtengruppe''' erstellt eine Mehrtafelprojektion eines oder mehrerer 3D-Objekte (Siehe [https://de.wikipedia.org/wiki/Normalprojektion Normalprojektion]).
Die isometrischen Ansichten der vier Frontecken können ebenfalls enthalten sein.
Die isometrischen Ansichten der vier vorderen Ecken können ebenfalls enthalten sein.


Soll nur eine einzige Ansicht erzeugt werden, bringt die Verwendung von Ansichtengruppe keinen Vorteil; stattdessen sollte man [[TechDraw_View/de|Ansicht]] verwenden.
Soll nur eine einzige Ansicht erzeugt werden, bringt die Verwendung von Ansichtengruppe keinen Vorteil; stattdessen sollte man [[TechDraw_View/de|Ansicht]] verwenden.
Wenn man nicht die herkömmliche europäische Projektion: Erster Winkel (engl. [https://en.wikipedia.org/wiki/Multiview_orthographic_projection#First-angle_projection first-angle projection]) bzw. amerikanische Projektion: Dritter Winkel (engl. [https://en.wikipedia.org/wiki/Multiview_orthographic_projection#Third-angle_projection third-angle projection]) verwenden möchte, sollte man mehrmals [[TechDraw_View/de|Ansichten]] anstelle von ''ProjektionsGruppe'' verwenden.
Wenn man nicht die herkömmliche europäische Projektion: Erster Winkel (engl. [https://en.wikipedia.org/wiki/Multiview_orthographic_projection#First-angle_projection first-angle projection]) bzw. amerikanische Projektion: Dritter Winkel (engl. [https://en.wikipedia.org/wiki/Multiview_orthographic_projection#Third-angle_projection third-angle projection]) verwenden möchte, sollte man mehrmals [[TechDraw_View/de|Ansicht]] anstelle von ''Ansichtengruppe'' verwenden.


[[Image:TechDraw_ProjGroup_example.png|400px]]
[[Image:TechDraw_ProjGroup_example.png|400px]]
{{Caption|Drei orthogonale Ansichten und eine isometrische Ansicht eines Festkörperobjekts}}
{{Caption|Drei orthogonale Ansichten und eine isometrische Ansicht eines Festkörperobjekts}}


<span id="Usage"></span>
==Anwendung==
==Anwendung==


# Wahlweise die [[3D_view/de|3D-Ansicht]] zurechtdrehen. Die Blickrichtung der Kamera in der [[3D_view/de|3D-Ansicht]] legt den Anfangswert der {{MenuCommand|Hauptrichtung}} der Ansichtengruppe (die {{PropertyData/de|Direction}} der zentralen Ansicht).
# Wahlweise die [[3D_view/de|3D-Ansicht]] zurechtdrehen. Die Blickrichtung der Kamera in der [[3D_view/de|3D-Ansicht]] legt den Anfangswert der {{MenuCommand|Hauptrichtung}} der Ansichtengruppe (die {{PropertyData/de|Direction}} der zentralen Ansicht) fest.
# Ein oder mehrere Objekte in der [[3D_view/de|3D-Ansicht]] oder [[Tree_view/de|Baumansicht]] auswählen.
# Ein oder mehrere Objekte in der [[3D_view/de|3D-Ansicht]] oder [[Tree_view/de|Baumansicht]] auswählen.
# Wenn das Dokument mehrere Zeichnungsblätter enthält, kann das gewünschte Blatt wahlweise zur Auswahl hinzugefügt werden, indem es in der [[Tree_view/de|Baumansicht]] auswählt wird. Dies ist ein Muss für {{VersionMinus/de|0.19}}.
# Wenn das Dokument mehrere Zeichnungsblätter enthält, kann das gewünschte Blatt wahlweise zur Auswahl hinzugefügt werden, indem es in der [[Tree_view/de|Baumansicht]] auswählt wird.
# Es gibt mehrere Möglichkeiten das Werkzeug aufzurufen:
# Es gibt mehrere Möglichkeiten das Werkzeug aufzurufen:
#* Die Schaltfläche {{Button|[[Image:TechDraw_ProjectionGroup.svg|16px]] [[TechDraw_ProjectionGroup/de|Ansichtengruppe einfügen]]}} drücken.
#* Die Schaltfläche {{Button|[[Image:TechDraw_ProjectionGroup.svg|16px]] [[TechDraw_ProjectionGroup/de|Ansichtengruppe einfügen]]}} drücken.
#* Den Menüeintrag {{MenuCommand|TechDraw → [[Image:TechDraw_ProjectionGroup.svg|16px]] Ansichtengruppe einfügen}} auswählen.
#* Den Menüeintrag {{MenuCommand|TechDraw → TechDraw Views → [[Image:TechDraw_ProjectionGroup.svg|16px]] Ansichtengruppe einfügen}} auswählen.
# Wenn das Dokument mehrere Zeichnungsblätter enthält und noch kein Blatt ausgewählt wurde, öffnet sich der {{MenuCommand|Seitenauswahl}}-Dialog {{Version/de|0.20}}:
# Wenn das Dokument mehrere Zeichnungsblätter enthält und noch kein Blatt ausgewählt wurde, öffnet sich der Dialog {{MenuCommand|Blattauswahl}} {{Version/de|0.20}}:
## Die gewünscht Seite auswählen.
## Die gewünscht Seite auswählen.
## Die Schaltfläche {{Button|OK}} drücken.
## Die Schaltfläche {{Button|OK}} drücken.
Line 48: Line 51:
{{Caption|[[Task_panel/de|Aufgabenbereich]] Ansichtengruppe. Das Feld ''Anpassen der Hauptrichtung'' zeigt die aktuelle Blickrichtung an.}}
{{Caption|[[Task_panel/de|Aufgabenbereich]] Ansichtengruppe. Das Feld ''Anpassen der Hauptrichtung'' zeigt die aktuelle Blickrichtung an.}}


<span id="Properties"></span>
==Eigenschaften==
==Eigenschaften==


<span id="Data"></span>
* {{PropertyData/de|Anchor}}: Die zentrale Ansicht in der Ansichtengruppe. Normalerweise die Vorderansicht.
===Daten===
* {{PropertyData/de|Projection Type}}: "Erster Winkel" (europäisch) oder "Dritter Winkel" (amerikanisch).

* {{PropertyData/de|Auto Distribute}}: Wenn TRUE, werden die einzelnen Ansichten automatisch positioniert. Zur manuellen Positionierung schaltet man auf FALSE um.
{{TitleProperty|Basis}}
* {{PropertyData/de|spacing X}}: Horizontaler Abstand zwischen den Ansichten bei automatischer Positionierung. Man beachte, dass auch der Maßstab und die Größe der anderen Ansichten in der Gruppe den Abstand beeinflussen.

* {{PropertyData/de|Spacing Y}}: Vertikaler Abstand zwischen den Ansichten bei automatischer Anordnung.
* {{PropertyData|Source|LinkList}}: Links to the drawable objects to be depicted.
* {{PropertyData|XSource|XLinkList}}: Links to the drawable objects in an external file.
* {{PropertyData|Anchor|Link}}: The central view in the group. Normally the Front view.
* {{PropertyData|ProjectionType|Enumeration}}: {{Value|First Angle}} or {{Value|Third Angle}}.

For the other properties in this group see [[TechDraw_View#Properties|TechDraw View]].

{{TitleProperty|Collection}}

* {{PropertyData|Views|LinkList}}: Links to the views in this ProjectionGroup.

{{TitleProperty|Distribute}}

* {{PropertyData|Auto Distribute|Bool}}: If {{TRUE}}, space out individual views automatically. Use {{FALSE}} to position manually.
* {{PropertyData|spacing X|Length}}: Horizontal space between views when automatically positioned. Note that Scale and the size of other views in the group also influence the spacing.
* {{PropertyData|spacing Y|Length}}: Vertical space between views when automatically positioned.

=== View ===

{{TitleProperty|Basis}}

Siehe [[TechDraw_View/de#Eigenschaften|TechDraw Ansicht]]

<span id="Notes"></span>
==Hinweise==


Die Ansichtengruppe als Ganzes erbt X, Y, Scale Type, Scale und Rotation aus der Basisansicht.
Die Ansichtengruppe als Ganzes erbt X, Y, Scale Type, Scale und Rotation aus der Basisansicht.


Einzelne Ansichten innerhalb der Gruppe erben alle Teilansichtseigenschaften, aber das ProjektionsGruppen Objekt steuert den Maßstab aller seiner Mitgliedsansichten.
Einzelne Ansichten innerhalb der Gruppe erben alle Eigenschaften der Part-Ansicht, aber das Proj(ektion)Group-Objekt steuert den Maßstab aller seiner Elementansichten.


Die Eigenschaft des Drehvectors jeder einzelnen Ansicht innerhalb der Gruppe ist veraltet seit v0.19. Verwende stattdessen XRichtung.
Die Eigenschaft RotationVector einzelner Ansichten innerhalb der Gruppe ist veraltet seit v0.19. Stattdessen wird XDirection verwendet.


Beachte, dass der mittlere Kasten die aktuelle Projektionsrichtung der primären Ansicht anzeigt. Sie kann nicht dazu benutzt werden, die Richtung zu ändern.
Beachte, dass der mittlere Kasten die aktuelle Projektionsrichtung der primären Ansicht anzeigt. Sie kann nicht dazu benutzt werden, die Richtung zu ändern.


<span id="Scripting"></span>
==Skripten==
==Skripten==


{{Emphasis|Siehe auch:}} [[TechDraw_API/de|TechDraw API]] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].
Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].


A Projection Group can be created with [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:
Das NeueProjGruppe Werkzeug kann in [[Macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus verwendet werden. Ein vollständiges Skript ist in der Quellverteilung in "source-dir/src/Mod/TechDraw/TDTest/DProjGroupTest.py" verfügbar.


{{Code|code=
{{Code|code=
import FreeCAD as App
#make a page
print("making a page")
page = FreeCAD.ActiveDocument.addObject('TechDraw::DrawPage','Page')
FreeCAD.ActiveDocument.addObject('TechDraw::DrawSVGTemplate','Template')
FreeCAD.ActiveDocument.Template.Template = templateFileSpec
FreeCAD.ActiveDocument.Page.Template = FreeCAD.ActiveDocument.Template


doc = App.ActiveDocument
#make projection group
group = FreeCAD.ActiveDocument.addObject('TechDraw::DrawProjGroup','ProjGroup')
cyl = doc.addObject("Part::Cylinder", "Cylinder")
doc.recompute()
rc = page.addView(group)
group.Source = [fusion]


page = doc.addObject("TechDraw::DrawPage", "Page")
#add Front(Anchor) view
template = doc.addObject("TechDraw::DrawSVGTemplate", "Template")
frontView = group.addProjection("Front") ##need an Anchor
template.Template = App.getResourceDir() + "Mod/TechDraw/Templates/A4_LandscapeTD.svg"
page.Template = template


# Toggle the visibility of the page to ensure its width and height are updated (hack):
#update group
page.Visibility = False
group.Anchor.Direction = FreeCAD.Vector(0,0,1)
page.Visibility = True
group.Anchor.RotationVector = FreeCAD.Vector(1,0,0)


group = doc.addObject("TechDraw::DrawProjGroup", "ProjGroup")
#add more projections
page.addView(group)
leftView = group.addProjection("Left")
group.Source = [cyl]
topView = group.addProjection("Top")
group.ProjectionType = "Third Angle"
rightView = group.addProjection("Right")
rearView = group.addProjection("Rear")
BottomView = group.addProjection("Bottom")


front_view = group.addProjection("Front") # First projection will become the Anchor.
#remove a view from projection group
group.Anchor.Direction = (0, 1, 0)
iv = group.removeProjection("Left")
group.Anchor.RotationVector = (1, 0, 0)


left_view = group.addProjection("Left")
top_view = group.addProjection("Top")

group.X = page.PageWidth / 2
group.Y = page.PageHeight / 2

doc.recompute()
}}
}}

Programmierhinweis: Die Projektionsgruppe sollte immer zur Seite hinzugefügt werden (z.B. page.addView(group), bevor Projektionen zur Gruppe hinzugefügt werden. Dies ermöglicht es der Projektionsgruppe, von der übergeordneten Seite abgeleitete Standardparameterwerte zu verwenden.
Hinweis: Die Ansichtengruppe sollte immer zum Zeichnungsblatt hinzugefügt werden,{{Incode|page.addView(group)}}, bevor Ansichten zur Gruppe hinzugefügt werden. Dies ermöglicht es der Ansichtengruppe, von der übergeordneten Seite übernommene Parameterwerte als Vorgaben zu verwenden.



{{Docnav/de
{{Docnav/de
Line 114: Line 148:
{{TechDraw Tools navi{{#translation:}}}}
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 16:52, 25 July 2023

TechDraw Ansichtengruppe

Menüeintrag
TechDraw→ TechDraw Ansichten → Ansichtengruppe einfügen
Arbeitsbereich
TechDraw
Standardtastenkürzel
Keiner
Eingeführt in Version
-
Siehe auch
TechDraw Ansicht einfügen, TechDraw Schnittansicht einfügen

Beschreibung

Das Werkzeug TechDraw Ansichtengruppe erstellt eine Mehrtafelprojektion eines oder mehrerer 3D-Objekte (Siehe Normalprojektion). Die isometrischen Ansichten der vier vorderen Ecken können ebenfalls enthalten sein.

Soll nur eine einzige Ansicht erzeugt werden, bringt die Verwendung von Ansichtengruppe keinen Vorteil; stattdessen sollte man Ansicht verwenden. Wenn man nicht die herkömmliche europäische Projektion: Erster Winkel (engl. first-angle projection) bzw. amerikanische Projektion: Dritter Winkel (engl. third-angle projection) verwenden möchte, sollte man mehrmals Ansicht anstelle von Ansichtengruppe verwenden.

Drei orthogonale Ansichten und eine isometrische Ansicht eines Festkörperobjekts

Anwendung

  1. Wahlweise die 3D-Ansicht zurechtdrehen. Die Blickrichtung der Kamera in der 3D-Ansicht legt den Anfangswert der Hauptrichtung der Ansichtengruppe (die Daten-EigenschaftDirection der zentralen Ansicht) fest.
  2. Ein oder mehrere Objekte in der 3D-Ansicht oder Baumansicht auswählen.
  3. Wenn das Dokument mehrere Zeichnungsblätter enthält, kann das gewünschte Blatt wahlweise zur Auswahl hinzugefügt werden, indem es in der Baumansicht auswählt wird.
  4. Es gibt mehrere Möglichkeiten das Werkzeug aufzurufen:
    • Die Schaltfläche Ansichtengruppe einfügen drücken.
    • Den Menüeintrag TechDraw → TechDraw Views → Ansichtengruppe einfügen auswählen.
  5. Wenn das Dokument mehrere Zeichnungsblätter enthält und noch kein Blatt ausgewählt wurde, öffnet sich der Dialog Blattauswahl eingeführt mit Version 0.20:
    1. Die gewünscht Seite auswählen.
    2. Die Schaltfläche OK drücken.
  6. Der Aufgabenbereich Ansichtengruppe wird geöffnet.
  7. Die Ansichten, die zur Ansichtengruppe hinzugefügt werden sollen sowie den Maßstab der Ansichtengruppe und andere Parameter auswählen.
  8. Die Schaltfläche OK drücken.
  9. Wahlweise kann die Ansichtengruppe, durch Ziehen der zentralen Ansicht, bewegt werden.
  10. Wahlweise können die anderen Ansichten der Ansichtengruppe relativ zu der zentralen Ansicht bewegt werden, indem man sie jeweils einzeln zieht.

Aufgabenbereich Ansichtengruppe. Das Feld Anpassen der Hauptrichtung zeigt die aktuelle Blickrichtung an.

Eigenschaften

Daten

Basis

  • DatenSource (LinkList): Links to the drawable objects to be depicted.
  • DatenXSource (XLinkList): Links to the drawable objects in an external file.
  • DatenAnchor (Link): The central view in the group. Normally the Front view.
  • DatenProjectionType (Enumeration): First Angle or Third Angle.

For the other properties in this group see TechDraw View.

Collection

  • DatenViews (LinkList): Links to the views in this ProjectionGroup.

Distribute

  • DatenAuto Distribute (Bool): If true, space out individual views automatically. Use false to position manually.
  • Datenspacing X (Length): Horizontal space between views when automatically positioned. Note that Scale and the size of other views in the group also influence the spacing.
  • Datenspacing Y (Length): Vertical space between views when automatically positioned.

View

Basis

Siehe TechDraw Ansicht

Hinweise

Die Ansichtengruppe als Ganzes erbt X, Y, Scale Type, Scale und Rotation aus der Basisansicht.

Einzelne Ansichten innerhalb der Gruppe erben alle Eigenschaften der Part-Ansicht, aber das Proj(ektion)Group-Objekt steuert den Maßstab aller seiner Elementansichten.

Die Eigenschaft RotationVector einzelner Ansichten innerhalb der Gruppe ist veraltet seit v0.19. Stattdessen wird XDirection verwendet.

Beachte, dass der mittlere Kasten die aktuelle Projektionsrichtung der primären Ansicht anzeigt. Sie kann nicht dazu benutzt werden, die Richtung zu ändern.

Skripten

Siehe auch: Autogenerierte API Dokumentation und FreeCAD Grundlagen Skripten.

A Projection Group can be created with macros and from the Python console by using the following functions:

import FreeCAD as App

doc = App.ActiveDocument
cyl = doc.addObject("Part::Cylinder", "Cylinder")
doc.recompute()

page = doc.addObject("TechDraw::DrawPage", "Page")
template = doc.addObject("TechDraw::DrawSVGTemplate", "Template")
template.Template = App.getResourceDir() + "Mod/TechDraw/Templates/A4_LandscapeTD.svg"
page.Template = template

# Toggle the visibility of the page to ensure its width and height are updated (hack):
page.Visibility = False
page.Visibility = True

group = doc.addObject("TechDraw::DrawProjGroup", "ProjGroup")
page.addView(group)
group.Source = [cyl]
group.ProjectionType = "Third Angle"

front_view = group.addProjection("Front") # First projection will become the Anchor.
group.Anchor.Direction = (0, 1, 0)
group.Anchor.RotationVector = (1, 0, 0)

left_view = group.addProjection("Left")
top_view = group.addProjection("Top")

group.X = page.PageWidth / 2
group.Y = page.PageHeight / 2

doc.recompute()

Hinweis: Die Ansichtengruppe sollte immer zum Zeichnungsblatt hinzugefügt werden,page.addView(group), bevor Ansichten zur Gruppe hinzugefügt werden. Dies ermöglicht es der Ansichtengruppe, von der übergeordneten Seite übernommene Parameterwerte als Vorgaben zu verwenden.