Draft Scale/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(47 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/de|Name=Draft Scale|Name/de=Skalieren|Workbenches=[[Draft Module/de|Draft]], [[Arch Module/de|Arch]]|MenuLocation=Draft → Scale|Shortcut=S C|SeeAlso=[[Draft Clone/de|Klonen]]}}


{{Docnav/de
==Description==
|[[Draft_Rotate/de|Drehen]]
|[[Draft_Mirror/de|Spiegeln]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_Rotate.svg
|IconR=Draft_Mirror.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand/de
This tool scales selected object(s) around a base point. If no object is selected, you will be invited to select one. It can also be used to mirror objects.
|Name=Draft Scale
|Name/de=Draft Skalieren
|MenuLocation=Änderung → Skalieren
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Shortcut={{KEY|S}} {{KEY|C}}
|SeeAlso=[[Draft_SubelementHighlight/de|Draft UnterelementHervorheben]], [[Draft_Clone/de|Draft Klonen]]
}}


<span id="Description"></span>
[[Image:Draft_Scale_example.jpg|400px]]
==Beschreibung==


Das Werkzeug [[Image:Draft_Scale.svg|24px]] '''Draft Skalieren''' skaliert oder kopiert ausgewählte Objekte von einem Basispunkt aus. Im Unterelement-Modus skaliert der Befehl ausgewählte Punkte und Kanten von [[Draft_Line/de|Draft Linien]] und [[Draft_Wire/de|Draft-Drähten]].
==How to use==


Der Befehl kann auf 2D-Formen angewendet werden, die mit den Arbeitsbereichen [[Draft Workbench/de|Draft]] oder [[Sketcher Workbench/de|Sketcher]] erstellt wurden, kann aber auch mit vielen Arten von 3D-Objekten benutzt werden, wie denen, die mit den Arbeitsbereichen [[Part Workbench/de|Part]] oder [[Arch Workbench/de|Arch]] erzeugt wurden.
# Select objects you wish to scale
# Press the {{KEY|[[Image:Draft Scale.png|16px]] [[Draft Scale]]}} button, or press {{KEY|S}} then {{KEY|C}} keys
# Click a first point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
# Click another point on the 3D view, or type a [[Draft_Coordinates|coordinate]]


[[Image:Draft_Scale_example.png|400px]]
==Options==
{{Caption|Skalieren eines Objekts von einen Basispunkt aus}}


<span id="Usage"></span>
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
==Anwendung==
* The x, y and z components of the second point define the scale factor. For example, (1,1,1) would do nothing, (2,2,2) would scale 2x in all directions, (-1,1,1) would mirror in x direction.
* Pressing {{KEY|ALT}} or {{KEY|C}} or clicking the {{KEY|'''Copy'''}} button will make a copy of the objects, instead of scaling the original. If you keep {{KEY|ALT}} pressed after clicking the second point, you will be able to place more copies, until you release the {{KEY|ALT}} key.
* Press {{KEY|CTRL}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Pressing {{KEY|SHIFT}} will lock x and y values together, so the shape is not deformed.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current command.
* The resulting object is a [[Draft Clone]], which allows you to change the scale values after it has been created.
* Mirroring objects works by inverting the sign of one of the directions. For example, (-1,1,1) mirrors horizontally (on the X axis), and (1,-1,1) vertically (on the Y axis).


Siehe auch: [[Draft_Snap/de|Draft Fangen]] und [[Draft_Constrain/de|Draft Beschränken]].
==Scripting==


# Optionally select one or more objects, or one or more subelements of [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]].
The Scale tool can by used in [[macros]] and from the python console by using the following function:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Scale.svg|16px]] [[Draft_Scale|Scale]]}} button.
#* Select the {{MenuCommand|Modification → [[Image:Draft_Scale.svg|16px]] Scale}} option from the menu.
#* Use the keyboard shortcut: {{KEY|S}} then {{KEY|C}}.
# If you have not yet selected an object: select an object in the [[3D_view|3D view]].
# The {{MenuCommand|Scale}} task panel opens. See [[#Options|Options]] for more information.
# If subelements have been selected: check the {{MenuCommand|Modify subelements}} checkbox to switch on subelement mode.
# Pick the base point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button.
# Enter the X, Y and Z scale factors.
# Press {{KEY|Enter}} or the {{Button|OK}} button to finish the command.

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

===First task panel===

The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts.

* To manually enter the coordinates for the base point enter the X, Y and Z component, and press {{KEY|Enter}} after each. Or you can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button when you have the desired values. It is advisable to move the pointer out of the [[3D_view|3D view]] before entering coordinates.
* Press {{KEY|G}} or click the {{MenuCommand|Global}} checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the [[Draft_SelectPlane|working plane]] coordinate system. {{Version|0.20}}
* Press {{KEY|S}} to switch [[Draft_Snap|Draft snapping]] on or off.
* Press the {{Button|Close}} button to abort the command.

===Second task panel===

* Enter the X, Y and Z factors to define the scaling. The values must be larger than zero.
* Check the {{MenuCommand|Uniform scaling}} checkbox to lock the X, Y and Z factors to the same value.
* If the {{MenuCommand|Working plane orientation}} checkbox is checked the scale factors are relative to the [[Draft_SelectPlane|working plane]] coordinate system, else they are relative to the global coordinate system.
* If the {{MenuCommand|Copy}} checkbox is checked a scaled copy of the original object is created. This only works for Draft objects that have a {{PropertyData|Points}} property, such as [[Draft_Wire|Draft Wires]].
* If the {{MenuCommand|Modify subelements}} checkbox is checked the command will use the selected subelements instead of the whole objects. The subelements must belong to [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]].
* If the {{MenuCommand|Create a clone}} checkbox is checked scaled [[Draft_Clone|clones]] of the original objects are created. This works for all object types. For objects that are not Draft objects, or for Draft objects that do not have a {{PropertyData|Points}} property, this option {{Emphasis|must}} be selected.
* Press the {{Button|Pick from/to points}} button and pick two additional points in the [[3D_view|3D view]] to calculate the scale factors. This will automatically check the {{MenuCommand|Uniform scaling}} checkbox. The X, Y and Z scale factors will therefore be equal and will be set to the distance between the base point and the 'from' point, divided by the distance between the base point and the 'to' point.
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the command.

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

* Der Befehl kann auch [[Image_CreateImagePlane/de|Bildebenen]] skalieren, aber nicht im Klon-Modus.

<span id="Preferences"></span>
==Einstellungen==

Siehe auch: [[Preferences_Editor/de|Voreinstellungseditor]] und [[Draft_Preferences/de|Draft Einstellungen]].

* To reselect the base objects after copying objects: {{MenuCommand|Edit → Preferences... → Draft → General → Select base objects after copying}}.

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

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

Zum skalieren von Objekten wird die Methode {{incode|scale}} des Draft-Moduls verwendet.


{{Code|code=
{{Code|code=
scaled_list = scale(objectslist, scale=Vector(1,1,1), center=Vector(0,0,0), copy=False)
scale (objects,vector,[center,copy,legacy])
}}
}}


* {{incode|objectslist}} contains the objects to be scaled. It is either a single object or a list of objects.
* Scales the objects contained in objects (that can be a list of objects or an object) of the given scale factors defined by the given vector (in X, Y and Z directions) around the given center.
* {{incode|scale}} is the vector that specifies by the X, Y and Z scale factors.
* If legacy is True, direct (old) mode is used, otherwise a parametric copy is made.
* {{incode|center}} is the center point of the scaling operation.
* If copy is True, the actual objects are not moved, but copies are created instead.
* If {{incode|copy}} is {{incode|True}} copies are created instead of scaling the original objects.
* The objects (or their copies) are returned.
* {{incode|scaled_list}} is returned with the original scaled objects, or with the new copies. It is either a single object or a list of objects, depending on {{incode|objectslist}}.


Beispiel:
Example:


{{Code|code=
{{Code|code=
import FreeCAD,Draft
import FreeCAD as App
import Draft
Draft.scale(FreeCAD.ActiveDocument.ActiveObject,FreeCAD.Vector(2,2,2))

doc = App.newDocument()

pts = [App.Vector(0, 0, 0), App.Vector(500, 500, 0), App.Vector(600, 0, 0)]
wire1 = Draft.make_wire(pts, closed=True)
doc.recompute()

scale1 = App.Vector(2.3, 0.75, 0)
wire2 = Draft.scale(wire1, scale1, copy=True)
doc.recompute()

scale2 = App.Vector(-2, -1.5, 0)
wires = Draft.scale([wire1, wire2], scale2, copy=True)
doc.recompute()
}}
}}



<languages/>
{{Docnav/de
|[[Draft_Rotate/de|Drehen]]
|[[Draft_Mirror/de|Spiegeln]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_Rotate.svg
|IconR=Draft_Mirror.svg
|IconC=Workbench_Draft.svg
}}

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

Latest revision as of 05:06, 9 January 2024

Draft Skalieren

Menüeintrag
Änderung → Skalieren
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
S C
Eingeführt in Version
-
Siehe auch
Draft UnterelementHervorheben, Draft Klonen

Beschreibung

Das Werkzeug Draft Skalieren skaliert oder kopiert ausgewählte Objekte von einem Basispunkt aus. Im Unterelement-Modus skaliert der Befehl ausgewählte Punkte und Kanten von Draft Linien und Draft-Drähten.

Der Befehl kann auf 2D-Formen angewendet werden, die mit den Arbeitsbereichen Draft oder Sketcher erstellt wurden, kann aber auch mit vielen Arten von 3D-Objekten benutzt werden, wie denen, die mit den Arbeitsbereichen Part oder Arch erzeugt wurden.

Skalieren eines Objekts von einen Basispunkt aus

Anwendung

Siehe auch: Draft Fangen und Draft Beschränken.

  1. Optionally select one or more objects, or one or more subelements of Draft Lines or Draft Wires.
  2. There are several ways to invoke the command:
    • Press the Scale button.
    • Select the Modification → Scale option from the menu.
    • Use the keyboard shortcut: S then C.
  3. If you have not yet selected an object: select an object in the 3D view.
  4. The Scale task panel opens. See Options for more information.
  5. If subelements have been selected: check the Modify subelements checkbox to switch on subelement mode.
  6. Pick the base point in the 3D view, or type coordinates and press the Enter point button.
  7. Enter the X, Y and Z scale factors.
  8. Press Enter or the OK button to finish the command.

Optionen

First task panel

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.

  • To manually enter the coordinates for the base point enter the X, Y and Z component, and press Enter after each. Or you can press the Enter point button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
  • Press G or click the Global checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the working plane coordinate system. introduced in version 0.20
  • Press S to switch Draft snapping on or off.
  • Press the Close button to abort the command.

Second task panel

  • Enter the X, Y and Z factors to define the scaling. The values must be larger than zero.
  • Check the Uniform scaling checkbox to lock the X, Y and Z factors to the same value.
  • If the Working plane orientation checkbox is checked the scale factors are relative to the working plane coordinate system, else they are relative to the global coordinate system.
  • If the Copy checkbox is checked a scaled copy of the original object is created. This only works for Draft objects that have a DatenPoints property, such as Draft Wires.
  • If the Modify subelements checkbox is checked the command will use the selected subelements instead of the whole objects. The subelements must belong to Draft Lines or Draft Wires.
  • If the Create a clone checkbox is checked scaled clones of the original objects are created. This works for all object types. For objects that are not Draft objects, or for Draft objects that do not have a DatenPoints property, this option must be selected.
  • Press the Pick from/to points button and pick two additional points in the 3D view to calculate the scale factors. This will automatically check the Uniform scaling checkbox. The X, Y and Z scale factors will therefore be equal and will be set to the distance between the base point and the 'from' point, divided by the distance between the base point and the 'to' point.
  • Press Esc or the Cancel button to abort the command.

Hinweise

  • Der Befehl kann auch Bildebenen skalieren, aber nicht im Klon-Modus.

Einstellungen

Siehe auch: Voreinstellungseditor und Draft Einstellungen.

  • To reselect the base objects after copying objects: Edit → Preferences... → Draft → General → Select base objects after copying.

Skripten

Siehe auch: Autogenerierte API Dokumentation und FreeCAD Grundlagen Skripten.

Zum skalieren von Objekten wird die Methode scale des Draft-Moduls verwendet.

scaled_list = scale(objectslist, scale=Vector(1,1,1), center=Vector(0,0,0), copy=False)
  • objectslist contains the objects to be scaled. It is either a single object or a list of objects.
  • scale is the vector that specifies by the X, Y and Z scale factors.
  • center is the center point of the scaling operation.
  • If copy is True copies are created instead of scaling the original objects.
  • scaled_list is returned with the original scaled objects, or with the new copies. It is either a single object or a list of objects, depending on objectslist.

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

pts = [App.Vector(0, 0, 0), App.Vector(500, 500, 0), App.Vector(600, 0, 0)]
wire1 = Draft.make_wire(pts, closed=True)
doc.recompute()

scale1 = App.Vector(2.3, 0.75, 0)
wire2 = Draft.scale(wire1, scale1, copy=True)
doc.recompute()

scale2 = App.Vector(-2, -1.5, 0)
wires = Draft.scale([wire1, wire2], scale2, copy=True)
doc.recompute()