Draft Offset/de: Difference between revisions

From FreeCAD Documentation
(Created page with "==Skripten== {{Emphasis|Siehe auch:}} Draft API und FreeCAD Grundlagen Skripten.")
No edit summary
 
(41 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
{{Docnav/de
|[[Draft_Rotate|Drehen]]
|[[Draft_Mirror/de|Spiegeln]]
|[[Draft_Trimex|Stutzen/Verlängern (Trimex)]]
|[[Draft_Trimex/de|Trimex]]
|[[Draft_Workbench/de|Draft]]
|[[Draft_Module|Entwurf]]
|IconL=Draft_Rotate.svg
|IconL=Draft_Mirror.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Trimex.svg
|IconR=Draft_Trimex.svg
|IconC=Workbench_Draft.svg
}}
}}


{{GuiCommand/de
{{GuiCommand/de
|Name=Entwurf Versetzen
|Name=Draft Offset
|Name/de=Draft Versatz
|MenuLocation=Entwurf → Versetzen
|MenuLocation=Änderung → Versatz
|Workbenches=[[Draft Module/de|Entwurf]], [[Arch Module/de|Arch]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Shortcut={{KEY|O}} {{KEY|S}}
|Shortcut={{KEY|O}} {{KEY|S}}
|SeeAlso=[[Part_Offset2D/de|Part 2D Versatz]]
|SeeAlso=[[Part_Offset2D/de|Part 2DVersatz]]
}}
}}


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


Das Werkzeug [[Image:Draft_Offset.svg|24px]] '''Draft Versatz''' verschiebt jedes Teilstück eines ausgewählten Objekts um einen gegebenen Abstand oder erstellt eine versetzte Kopie des ausgewählten Objekts.
Das Versatzwerkzeug verschiebt das ausgewählte Objekt um einen bestimmten Abstand (Versatz) senkrecht zu sich selbst.

Typischerweise wird dieses Werkzeug im Kopiermodus verwendet, um versetzte Kopien eines Basisdrahtes zu erstellen, wobei dieser Draht an der gleichen Stelle belassen wird. Die versetzten Kopien sind skalierte Versionen des Originalobjekts. Um andere skalierte Kopien zu erstellen, verwende [[Draft Scale/de|Entwurf Maßstab]]. Um exakte Kopien zu erstellen, die um einen bestimmten Abstand verschoben sind, verwende [[Draft Move/de|Entwurf verschieben]].


[[Image:Draft_Offset_example.jpg|400px]]
[[Image:Draft_Offset_example.jpg|400px]]
{{Caption|Versetzen eines Drahtes um einen bestimmten Abstand von einer seiner Kanten}}
{{Caption|Versetzen eines Draft-Drahtes}}


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


Siehe auch: [[Draft_Snap/de|Draft Einrasten]] und [[Draft_Constrain/de|Draft Beschränken]].
# Wähle das Objekt aus, das du versetzen möchtest.
# Drücke die {{Button|[[Image:Draft_Offset.svg|16px]] [[Draft Offset/de|Entwurf Versetzen]]}} Schaltfläche oder drücke {{KEY|O}} und dann {{KEY|S}} Tasten. Wenn kein Objekt ausgewählt ist, wirst du aufgefordert, eines auszuwählen.
# Klicke auf einen Punkt in der 3D Ansicht, oder gib einen Abstand ein.


# Wahlweise ein Objekt auswählen. Das Objekt muß auf der aktuellen [[Draft_SelectPlane/de|Draft Arbeitsebene]] liegen.
Der Abstand, der zur Erzeugung des Versatzes verwendet wird, steht je nach Position des Zeigers senkrecht zu einer der Kanten der ursprünglichen Form. Wenn der Zeiger näher an eine andere Kante bewegt wird, wird diese Kante nun zur Referenz für den Abstand. Halte die {{KEY|Shift}} Taste gedrückt, um die aktuelle Referenzkante beizubehalten, obwohl der Zeiger näher an andere Kanten bewegt wird.
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
#* Die Schaltfläche {{Button|[[Image:Draft_Offset.svg|16px]] [[Draft Offset/de|Versetzen]]}} drücken.
#* Den Menüeintrag {{MenuCommand|Änderung → [[Image:Draft_Offset.svg|16px]] Versetzen}} auswählen.
#* Das Tastaturkürzel {{KEY|O}} dann {{KEY|S}}.
# Wurde noch kein Objekt ausgewählt: Ein Objekt in der [[3D_view/de|3D-Ansicht]] auswählen.
# Der Aufgaben-Bereich {{MenuCommand|Versatz}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informtionen.
# Zum Festlegen des Versatzabstands gibt es folgende Möglichkeiten:
#* Einen Punkt in der [[3D_view/de|3D-Ansicht]] auswählen.
#* Eine Zahl eingeben:
#*# Der Zeiger muß sich auf der richtigen Seite des Objektes in der [[3D_view/de|3D-Ansicht]] befinden.
#*# Der Zeiger darf nicht aus der [[3D_view/de|3D-Ansicht]] heraus bewegt werden.
#*# Einen {{MenuCommand|Abstand}} eingeben.
#*# Die Taste {{KEY|Enter}} drücken, um die Anweisung abzuschließen.


<span id="Options"></span>
==Optionen==
==Optionen==


Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe [[Draft_Preferences/de|Draft-Einstellungen]]. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).
* Drücke {{KEY|P}} oder klicke auf das Kontrollkästchen, um den Kopiermodus umzuschalten. Wenn der Kopiermodus eingeschaltet ist, behält das Versatzwerkzeug die ursprüngliche Form an ihrer Stelle, erstellt aber eine skalierte Kopie an der gewählten Stelle.
* Halte {{KEY|Alt}} gedrückt, während du den Punkt auswählst, um ebenfalls den Kopiermodus umzuschalten. Die {{KEY|Alt}} gedrückt halten, erlaubt dir versetzte Kopien platzieren; loslassen {{KEY|Alt}}, um den Vorgang abzuschließen und alle versetzten Formen zu sehen.
* Klicke auf das "OCC-Stil" Kontrollkästchen, um den Modus "OCC" umzuschalten. Dadurch wird ein Versatz von beiden Seiten eines Liniensegments erzeugt, wodurch eine besonders geschlossene Form mit abgerundeten Kanten an den Enden der Segmente entsteht.
:{{Emphasis|Hinweis:}} Bei diesem Stil werden die Originalsegmente entfernt, verwende also den Kopiermodus, um die Originalkanten zu erhalten.
* Halte {{KEY|Ctrl}} während des Versatzes gedrückt, um [[Draft_Snap/de|Fangen]] deinen Punkt unabhängig vom Abstand an die nächstgelegene Fangposition zu zwingen.
* Halte {{KEY|Shift}} gedrückt, um den Versatzabstand in Bezug auf das aktuelle Segment beizubehalten und zu vermeiden, dass ein anderer Bezug gewählt wird.
* Drücke {{KEY|Esc}} oder die {{button|Close}} Schaltfläche , um den aktuellen Befehl abzubrechen; bereits platzierte Offset-Kopien bleiben erhalten.


* Ist die Checkbox {{MenuCommand|OCC-style offset}} aktiviert, wird ein besonderer Versatzstil verwendet: Offene [[Draft_Wire/de|Draft Polylinien]] werden zu beiden Seiten versetzt und die neuen Kanten werden mit gerundeten Ecken verbunden. Dies funktioniert nur mit ebenen Objekten mit mindestens zwei Kanten. Dabei ist zu beachten, dass mit diesem Stil ein neues nicht parametrisches Objekt erstellt wird und, wenn der Modus Kopieren deaktiviert ist, das Originalobjekt entfernt wird.
* {{KEY|C}} drücken oder die Checkbox {{MenuCommand|Kopieren}} aktivieren, um den Kopieren-Modus umzuschalten. Ist der Kopieren-Modus aktiviert, erstellt der Befehl eine versetzte Kopie anstatt das Originalobjekt zu (v)ersetzen.
* Wird {{KEY|Alt}} gedrückt gehalten, bevor Punkte in der [[3D_view/de|3D-Ansicht]] ausgewählt werden, wird auch der Kopieren-Modus umgeschaltet. Während {{KEY|Alt}} gedrückt gehalten wird, können mehrere Versatzpunkte ausgewählt werden. {{KEY|Alt}} loslassen, um den Befehl zu beenden und die erstellten Kopien anzuzeigen.
* {{KEY|Shift}} gedrückt halten, um den Versatzabstand mit dem aktuellen Abschnitt verknüpft zu lassen.
* {{KEY|S}}Drücken, um [[Draft_Snap/de|Draft Einrasten]] ein- bzw. auszuschalten.
* {{KEY|Esc}} oder die Schaltfläche {{Button|Close}} drücken, um den Befehl abzubrechen.

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

* Zum Erstellen einer Versetzte Version eines [[Draft_BSpline/de|Draft B-Splines]] werden seine Punkte einzeln versetzt und durch die neuen Punkte wird ein neuer Spline berechnet. Dieser neue Spline ist nicht parallel zum originalen Spline. Für eine exakt parallele Versatzkurve eines [[Draft_BSpline/de|Draft B-Splines]] sollte der Befehl [[Part_Offset2D/de|Part 2DVersatz]] eingesetzt werden.
* Der Befehl Draft Offset kann [[Draft_BezCurve/de|Draft Bézierkurve]] nicht bearbeiten. Dafür kann der Befehl [[Part_Offset2D/de|Part 2DVersatz]] verwendet werden.

<span id="Scripting"></span>
==Skripten==
==Skripten==
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft 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]].
The Offset tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:

Zum Versetzen von Objekten wird die Methode {{incode|offset}} des Draft-Moduls verwendet. Die Methode kann nur [[Draft_Wire/de|Draft Wires]], [[Draft_Circle/de|Draft Circles]], [[Draft_Rectangle/de|Draft Rectangles]], [[Draft_Polygon/de|Draft Polygons]] und [[Draft_BSpline/de|Draft BSplines]] verarbeiten.


{{Code|code=
{{Code|code=
Offsetobj = offset(obj, delta, copy=False, bind=False, sym=False, occ=False)
offset_obj = offset(obj, delta, copy=False, bind=False, sym=False, occ=False)
}}
}}


* {{incode|obj}} ist das zu versetzende Objekt.
* Offsets the given {{incode|obj}} wire by applying the given {{incode|delta}}, defined as a vector, to its first vertex.
* {{incode|delta}} enthält die Versatzinformationen:
* If {{incode|copy}} is {{incode|True}} another object is created instead of offsetting the original object.
** Für [[Draft_Wire/de|Draft-Polylinien]], [[Draft_Rectangle/de|Draft-Rechtecke]] und [[Draft_Polygon/de|Draft-Vielecke]] ist es ein Versatzvektor, der rechtwinklig auf dem ersten Abschnitt des Objekts steht.
* If {{incode|bind}} is {{incode|True}}, and provided the wire object is open, the original and the offset wire will be tied at their endpoints, forming a face.
** Für [[Draft_Circle/de|Draft Circles]] ist es der neue Radius.
** If {{incode|sym}} is {{incode|True}}, {{incode|bind}} must be {{incode|True}} as well, and the offset is made on both sides of the wire, the total width being the length of the given vector.
** Für [[Draft_BSpline/de|Draft BSplines]] ist es eine Liste von neuen Punkten.
* If {{incode|occ}} is {{incode|True}}, it will use OCC-style offsetting: it will offset from both sides, then tie the new wires together, and round the corners.
* {{incode|Offsetobj}} is returned with the original offset object, or with the new copy.
* Ist {{incode|copy}} auf {{incode|True}} gesetzt, wird das Originalobjekt behalten und ein neues Objekt erstellt.
* Ist {{incode|bind}} auf {{incode|True}} gesetzt, wird eine Fläche erstellt, indem die Form des Originalobjekts mit der Form seines Versatzobjekts verbunden wird. Dies funktioniert nur mit offenen [[Draft_Wire/de|Draft-Polylinien]].
* Sind {{incode|sym}} auf {{incode|True}} und auch {{incode|bind}} auf {{incode|True}} gesetzt, wird das Originalobjekt zu beiden Seiten versetzt; die Gesamtbreite entspricht der Länge des gegebenen Vektors. Dies funktioniert nur mit offenen [[Draft_Wire/de|Draft-Polylinien]].
* Ist {{incode|occ}} auf {{incode|True}} gesetzt, wird ein OCC-Style-Versatz verwendet. Siehe [[#Optionen|Optionen]]. Ist {{incode|occ}} auf {{incode|True}} gesetzt, werden die Argumente {{incode|bind}} und {{incode|sym}} ignoriert.
* {{incode|offset_obj}} wird mit dem originalen versetzten Objekt zurückgegeben oder mit dem neuen Objekt. Ist {{incode|bind}} auf {{incode|True}} gesetzt oder {{incode|occ}} auf {{incode|True}} gesetzt, wird das neue Objekt ein {{incode|[[Part_Feature|Part::Feature]]}}-Object.


Beispiel:
Example:


{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(1500, 2000, 0)
p3 = FreeCAD.Vector(4000, 0, 0)


Wire = Draft.makeWire([p1, p2, p3])
p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1500, 2000, 0)
p3 = App.Vector(4000, 0, 0)


vector = FreeCAD.Vector(0, 500, 0)
wire = Draft.make_wire([p1, p2, p3])
doc.recompute()
Offset_1 = Draft.offset(Wire, vector, copy=True)

Offset_2 = Draft.offset(Wire, 3*vector, copy=True)
vector = App.Vector(-200, 150, 0)
Offset_3 = Draft.offset(Wire, 6*vector, copy=True)
Offset_4 = Draft.offset(Wire, 9*vector, copy=True)
offset1 = Draft.offset(wire, vector, copy=True, bind=True, sym=True)
Offset_5 = Draft.offset(Wire, 1.5*vector, copy=True, occ=True)
offset2 = Draft.offset(wire, 3*vector, copy=True)
offset3 = Draft.offset(wire, 6*vector, copy=True)
offset4 = Draft.offset(wire, 9*vector, copy=True)
offset5 = Draft.offset(wire, 1.5*vector, copy=True, occ=True)

doc.recompute()
}}
}}



{{Docnav
{{Docnav/de
|[[Draft_Rotate|Rotate]]
|[[Draft_Mirror/de|Spiegeln]]
|[[Draft_Trimex|Trim/Extend (Trimex)]]
|[[Draft_Module|Draft]]
|[[Draft_Trimex/de|Trimex]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_Rotate.svg
|IconC=Workbench_Draft.svg
|IconL=Draft_Mirror.svg
|IconR=Draft_Trimex.svg
|IconR=Draft_Trimex.svg
|IconC=Workbench_Draft.svg
}}
}}


{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 19:41, 9 January 2024

Draft Versatz

Menüeintrag
Änderung → Versatz
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
O S
Eingeführt in Version
-
Siehe auch
Part 2DVersatz

Beschreibung

Das Werkzeug Draft Versatz verschiebt jedes Teilstück eines ausgewählten Objekts um einen gegebenen Abstand oder erstellt eine versetzte Kopie des ausgewählten Objekts.

Versetzen eines Draft-Drahtes

Anwendung

Siehe auch: Draft Einrasten und Draft Beschränken.

  1. Wahlweise ein Objekt auswählen. Das Objekt muß auf der aktuellen Draft Arbeitsebene liegen.
  2. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Versetzen drücken.
    • Den Menüeintrag Änderung → Versetzen auswählen.
    • Das Tastaturkürzel O dann S.
  3. Wurde noch kein Objekt ausgewählt: Ein Objekt in der 3D-Ansicht auswählen.
  4. Der Aufgaben-Bereich Versatz wird geöffnet. Siehe Optionen für weitere Informtionen.
  5. Zum Festlegen des Versatzabstands gibt es folgende Möglichkeiten:
    • Einen Punkt in der 3D-Ansicht auswählen.
    • Eine Zahl eingeben:
      1. Der Zeiger muß sich auf der richtigen Seite des Objektes in der 3D-Ansicht befinden.
      2. Der Zeiger darf nicht aus der 3D-Ansicht heraus bewegt werden.
      3. Einen Abstand eingeben.
      4. Die Taste Enter drücken, um die Anweisung abzuschließen.

Optionen

Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe Draft-Einstellungen. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).

  • Ist die Checkbox OCC-style offset aktiviert, wird ein besonderer Versatzstil verwendet: Offene Draft Polylinien werden zu beiden Seiten versetzt und die neuen Kanten werden mit gerundeten Ecken verbunden. Dies funktioniert nur mit ebenen Objekten mit mindestens zwei Kanten. Dabei ist zu beachten, dass mit diesem Stil ein neues nicht parametrisches Objekt erstellt wird und, wenn der Modus Kopieren deaktiviert ist, das Originalobjekt entfernt wird.
  • C drücken oder die Checkbox Kopieren aktivieren, um den Kopieren-Modus umzuschalten. Ist der Kopieren-Modus aktiviert, erstellt der Befehl eine versetzte Kopie anstatt das Originalobjekt zu (v)ersetzen.
  • Wird Alt gedrückt gehalten, bevor Punkte in der 3D-Ansicht ausgewählt werden, wird auch der Kopieren-Modus umgeschaltet. Während Alt gedrückt gehalten wird, können mehrere Versatzpunkte ausgewählt werden. Alt loslassen, um den Befehl zu beenden und die erstellten Kopien anzuzeigen.
  • Shift gedrückt halten, um den Versatzabstand mit dem aktuellen Abschnitt verknüpft zu lassen.
  • SDrücken, um Draft Einrasten ein- bzw. auszuschalten.
  • Esc oder die Schaltfläche Close drücken, um den Befehl abzubrechen.

Hinweise

  • Zum Erstellen einer Versetzte Version eines Draft B-Splines werden seine Punkte einzeln versetzt und durch die neuen Punkte wird ein neuer Spline berechnet. Dieser neue Spline ist nicht parallel zum originalen Spline. Für eine exakt parallele Versatzkurve eines Draft B-Splines sollte der Befehl Part 2DVersatz eingesetzt werden.
  • Der Befehl Draft Offset kann Draft Bézierkurve nicht bearbeiten. Dafür kann der Befehl Part 2DVersatz verwendet werden.

Skripten

Siehe auch: Autogenerierte API-Dokumentation und FreeCAD Grundlagen Skripten.

Zum Versetzen von Objekten wird die Methode offset des Draft-Moduls verwendet. Die Methode kann nur Draft Wires, Draft Circles, Draft Rectangles, Draft Polygons und Draft BSplines verarbeiten.

offset_obj = offset(obj, delta, copy=False, bind=False, sym=False, occ=False)
  • obj ist das zu versetzende Objekt.
  • delta enthält die Versatzinformationen:
  • Ist copy auf True gesetzt, wird das Originalobjekt behalten und ein neues Objekt erstellt.
  • Ist bind auf True gesetzt, wird eine Fläche erstellt, indem die Form des Originalobjekts mit der Form seines Versatzobjekts verbunden wird. Dies funktioniert nur mit offenen Draft-Polylinien.
  • Sind sym auf True und auch bind auf True gesetzt, wird das Originalobjekt zu beiden Seiten versetzt; die Gesamtbreite entspricht der Länge des gegebenen Vektors. Dies funktioniert nur mit offenen Draft-Polylinien.
  • Ist occ auf True gesetzt, wird ein OCC-Style-Versatz verwendet. Siehe Optionen. Ist occ auf True gesetzt, werden die Argumente bind und sym ignoriert.
  • offset_obj wird mit dem originalen versetzten Objekt zurückgegeben oder mit dem neuen Objekt. Ist bind auf True gesetzt oder occ auf True gesetzt, wird das neue Objekt ein Part::Feature-Object.

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1500, 2000, 0)
p3 = App.Vector(4000, 0, 0)

wire = Draft.make_wire([p1, p2, p3])
doc.recompute()

vector = App.Vector(-200, 150, 0)
offset1 = Draft.offset(wire, vector, copy=True, bind=True, sym=True)
offset2 = Draft.offset(wire, 3*vector, copy=True)
offset3 = Draft.offset(wire, 6*vector, copy=True)
offset4 = Draft.offset(wire, 9*vector, copy=True)
offset5 = Draft.offset(wire, 1.5*vector, copy=True, occ=True)

doc.recompute()