Draft Point/de: Difference between revisions

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

{{Docnav/de
|[[Draft_BezCurve/de|Bézierkurve]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_BezCurve.svg
|IconR=Draft_Facebinder.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/de
{{GuiCommand/de
|Name=Draft Point|Name/de=Draft Point
|Name=Draft Point
|MenuLocation=Entwurf → Punkt
|Name/de=Draft Punkt
|MenuLocation=Zeichnen → Punkt
|Workbenches=[[Draft Module/de|Draft]], [[Arch Module/de|Arch]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Shortcut={{KEY|P}} {{KEY|T}}
|Version=0.7
|Version=0.7
}}
}}


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


Der Befehl [[Image:Draft_Point.svg|24px]] '''Draft Punkt''' erstellt einen einfachen Punkt.
Das Punkt-Werkzeug erstellt einen einfachen Punkt in der aktuellen [[Draft SelectPlane/de|Arbeitsebene]], nützlich, um später bei der Platzierung von Linien, Linienzügen oder anderen Objekten als Referenz zu dienen. Es verwendet (nur) die bereits im [[Draft Tray/de|Draft Tray]] gesetzte [[Draft Linestyle/de|Farbe]].
Draft-Punkte können nützlich sein als Referenz für die Positionierung von Linien, Polylinien oder anderen Objekten.


[[Image:Draft_point_example.jpg|400px]]
[[Image:Draft_point_example.jpg|400px]]
{{Caption|Ein einzelner Punkt auf der Arbeitsebene}}


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


Siehe auch: [[Draft_Tray/de|Draft-Ablage]], [[Draft_Snap/de|Draft-Einrasten]] und [[Draft_Constrain/de|Draft-Beschränken]].
# Drücke den {{Button|[[Image:Draft Point.png|16px]] [[Draft Point/de|Punkt]]}}-Button oder drücke die Tasten {{KEY|P}}, dann {{KEY|T}}
# Klicke einen Punkt in der 3D-Ansicht oder tippe eine [[Draft_Coordinates/de|Koordinate]] und drücke den {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}}-Button.


# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
# Die Schaltfläche {{Button|[[Image:Draft_Point.svg|16px]] [[Draft_Point/de|Punkt]]}} drücken.
#* Den Menüeintrag {{MenuCommand|Zeichnen → [[Image:Draft_Point.svg|16px]] Punkt}} auswählen.
#* Der Aufgaben-Bereich {{MenuCommand|Punkt}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informationen.
# Einen Punkt in der [[3D_view/de|3D-Ansicht]] auswählen oder die Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} drücken.

<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).
* Um manuell Koordinaten einzugeben, trage einfach die Zahlen ein, drücke dann {{KEY|Enter}} zwischen jeder der X-, Y- und Z-Komponenten. Du kannst den {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}}-Button drücken, um den Punkt einzufügen, nachdem Du die gewünschten Werte eingeben hast.
* Drücke {{KEY|Alt}}+{{KEY|N}} oder klicke das Ankreuzkästchen zur Umschaltung des '''Nächstes''-Modus. Wenn der Fortsetzungsmodus eingeschaltet ist, wird das Punkt-Werkzeug nach der Eingabe des Punkts erneut starten, ohne dass Du den Werkzeug-Button nochmal drücken musst.
* Drücke {{KEY|Esc}} oder den {{KEY|'''Schließen'''}}-Button zum Abbruch des aktuellen Befehls.


* Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem {{KEY|Enter}} eingegeben. Oder man drückt die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}}, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der [[3D_view/de|3D-Ansicht]] heraus zu bewegen, bevor Koordinaten eingegeben werden.
* {{KEY|G}} drücken oder die Checkbox {{MenuCommand|Global}} aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der [[Draft_SelectPlane/de|Arbeitsebene]]. {{Version/de|0.20}}
* {{KEY|N}} drücken oder die Checkbox {{MenuCommand|Fortsetzen}} aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Punkten fortzufahren.
* {{KEY|S}} drücken, um [[Draft_Snap/de|Draft Einrasten]] ein- bzw. auszuschalten.
* {{KEY|Esc}} oder die Schaltfläche {{Button|Schließen}} drücken, um den Befehl abzubrechen.

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

* [[Image:Draft_Snap_Near.svg|16px]] [[Draft_Snap_Near/de|Draft EinrastenInDerNähe]] verwenden ({{VersionMinus/de|0.20}}) oder [[Image:Draft_Snap_Endpoint.svg|16px]] [[Draft_Snap_Endpoint|Draft EinrastenAufEndpunkt]] ({{VersionPlus/de|0.21}}), um an Draft-Punkten einzurasten.

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


Siehe auch: [[Property_editor/de|Eigenschafteneditor]].
* {{PropertyData/de|X}}: die X-Koordinate des Punktes.
* {{PropertyData/de|Y}}: die Y-Koordinate des Punktes.
* {{PropertyData/de|Z}}: die Z-Koordinate des Punktes.


Ein Draft-Punkt-Objekt wird von einem [[Part_Feature/de|Part-Formelement]] abgeleitet und erbt alle seine Eigenschaften. Außerdem hat es die folgenden zusätzlichen Eigenschaften:
<div class="mw-translate-fuzzy">

==Scripting==
<span id="Data"></span>
</div>
===Daten===

{{TitleProperty|Draft}}

* {{PropertyData/de|X|Abstand}}: gibt die X Koordinate des Punktes an.
* {{PropertyData/de|Y|Abstand}}: gibt die Y Koordinate des Punktes an.
* {{PropertyData/de|Z|Abstand}}: gibt die Z Koordinate des Punktes an.

<span id="View"></span>
===Ansicht===

{{TitleProperty|Draft}}

* {{PropertyView/de|Pattern|Enumeration}}: nicht verwendet.
* {{PropertyView/de|Pattern Size|Float}}: nicht verwendet.

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

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

Um einen Draft-Punkt zu erstellen, wird die Methode {{incode|make_point}} ({{Version/de|0.19}}) des Draft-Moduls verwendet. Diese Methode ersetzt die veraltete Methode {{incode|makePoint}}.


<div class="mw-translate-fuzzy">
Das Punkt-Werkzeug kann in [[macros/de|Makros]] und aus der Python-Konsole heraus durch folgende Funktion angesprochen werden:
</div>
{{Code|code=
{{Code|code=
Point = makePoint(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
point = make_point(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
Point = makePoint(point, Y=0, Z=0, color=None, name="Point", point_size=5)
point = make_point(point, Y=0, Z=0, color=None, name="Point", point_size=5)
}}
}}


* Erstellt ein {{incode|Punkt}}-Objekt an den angegebenen {{incode|X}}-, {{incode|Y}}- und {{incode|Z}}-Koordinaten mit Einheiten in mm. Falls keine Koordinaten angegeben werden, wird der Punkt bei (0,0,0) angelegt.
<div class="mw-translate-fuzzy">
** Falls {{incode|X}} ein durch einen {{incode|FreeCAD.Vector}} definierter {{incode|Punkt}} ist, wird dieser verwendet.
* erstellt einen Punkt an den angegebenen Koordinaten. Falls keine X-, Y- und Z-Koordinaten angegeben werden, wird der Punkt bei (0,0,0) angelegt. Liefert das neu erzeugte Objekt zurück.
* {{incode|color}} ist ein Tupel {{incode|(R, G, B)}}, das die Farbe des Punktes in der RGB-Farbskala angibt; jeder Wert des Tupels sollte im Bereich von {{incode|0}} bis {{incode|1}} liegen.
</div>
* {{incode|name}} ist der Name des Objekts.
* {{incode|point_size}} ist die Größe des Objekt in Pixeln, falls die grafische Benutzeroberfläche geladen ist


Beispiel:
Beispiel:

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


doc = App.newDocument()
Point1 = Draft.makePoint(1600, 1400, 0)


p2 = FreeCAD.Vector(-3200, 1800, 0)
point1 = Draft.make_point(1600, 1400, 0)
Point2 = Draft.makePoint(p2, color=(0.5, 0.3, 0.6), point_size=10)


p2 = App.Vector(-3200, 1800, 0)
# Make a loop and create ten points with random coordinates that extend
point2 = Draft.make_point(p2, color=(0.5, 0.3, 0.6), point_size=10)
# from -L to L on both X and Y. Also choose a random color and size.

doc.recompute()
}}

Beispiel:

Dieser Code erzeugt {{incode|N}} zufällige Punkte innerhalb eines Quadrats der Seitenlänge {{incode|2L}}. Er macht eine Schleife, die {{incode|N}} Punkte erzeugt, die überall von {{incode|-L}} bis {{incode|+L}} auf X und Y erscheinen können. Er wählt auch eine zufällige Farbe und Größe für jeden Punkt. Ändere {{incode|N}}, um die Anzahl der Punkte zu ändern, und ändere {{incode|L}}, um den von den Punkten abgedeckten Bereich zu ändern.

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

doc = App.newDocument()


# Change value to define the area covered by the points
L = 1000
L = 1000
centered = FreeCAD.Placement(FreeCAD.Vector(-L,-L,0), FreeCAD.Rotation())
centered = App.Placement(App.Vector(-L, -L, 0), App.Rotation())
Rectangle = Draft.makeRectangle(2*L, 2*L, placement=centered)
rectangle = Draft.make_rectangle(2*L, 2*L, placement=centered)


for i in range(10):
N = 10
for i in range(N):
x = 2*L*random.random() - L
x = 2*L*random.random() - L
y = 2*L*random.random() - L
y = 2*L*random.random() - L
Line 73: Line 135:
b = random.random()
b = random.random()
size = 15*random.random() + 5
size = 15*random.random() + 5
Draft.makePoint(x, y, z, color=(r, g, b), point_size=size)
Draft.make_point(x, y, z, color=(r, g, b), point_size=size)

doc.recompute()
}}


{{Docnav/de
|[[Draft_BezCurve/de|Bézierkurve]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_BezCurve.svg
|IconR=Draft_Facebinder.svg
|IconC=Workbench_Draft.svg
}}
}}


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

Latest revision as of 13:05, 9 January 2024

Draft Punkt

Menüeintrag
Zeichnen → Punkt
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
Keiner
Eingeführt in Version
0.7
Siehe auch
Keiner

Beschreibung

Der Befehl Draft Punkt erstellt einen einfachen Punkt. Draft-Punkte können nützlich sein als Referenz für die Positionierung von Linien, Polylinien oder anderen Objekten.

Anwendung

Siehe auch: Draft-Ablage, Draft-Einrasten und Draft-Beschränken.

  1. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
  2. Die Schaltfläche Punkt drücken.
    • Den Menüeintrag Zeichnen → Punkt auswählen.
    • Der Aufgaben-Bereich Punkt wird geöffnet. Siehe Optionen für weitere Informationen.
  3. Einen Punkt in der 3D-Ansicht auswählen oder die Koordinaten eingeben und die Schaltfläche Punkt eingeben drücken.

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).

  • Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem Enter eingegeben. Oder man drückt die Schaltfläche Punkt eingeben, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der 3D-Ansicht heraus zu bewegen, bevor Koordinaten eingegeben werden.
  • G drücken oder die Checkbox Global aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der Arbeitsebene. eingeführt mit Version 0.20
  • N drücken oder die Checkbox Fortsetzen aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Punkten fortzufahren.
  • S drücken, um Draft Einrasten ein- bzw. auszuschalten.
  • Esc oder die Schaltfläche Schließen drücken, um den Befehl abzubrechen.

Hinweise

Eigenschaften

Siehe auch: Eigenschafteneditor.

Ein Draft-Punkt-Objekt wird von einem Part-Formelement abgeleitet und erbt alle seine Eigenschaften. Außerdem hat es die folgenden zusätzlichen Eigenschaften:

Daten

Draft

  • Daten-EigenschaftX (Abstand): gibt die X Koordinate des Punktes an.
  • Daten-EigenschaftY (Abstand): gibt die Y Koordinate des Punktes an.
  • Daten-EigenschaftZ (Abstand): gibt die Z Koordinate des Punktes an.

Ansicht

Draft

  • Ansicht EigenschaftPattern (Enumeration): nicht verwendet.
  • Ansicht EigenschaftPattern Size (Float): nicht verwendet.

Skripten

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

Um einen Draft-Punkt zu erstellen, wird die Methode make_point (eingeführt mit Version 0.19) des Draft-Moduls verwendet. Diese Methode ersetzt die veraltete Methode makePoint.

point = make_point(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
point = make_point(point, Y=0, Z=0, color=None, name="Point", point_size=5)
  • Erstellt ein Punkt-Objekt an den angegebenen X-, Y- und Z-Koordinaten mit Einheiten in mm. Falls keine Koordinaten angegeben werden, wird der Punkt bei (0,0,0) angelegt.
    • Falls X ein durch einen FreeCAD.Vector definierter Punkt ist, wird dieser verwendet.
  • color ist ein Tupel (R, G, B), das die Farbe des Punktes in der RGB-Farbskala angibt; jeder Wert des Tupels sollte im Bereich von 0 bis 1 liegen.
  • name ist der Name des Objekts.
  • point_size ist die Größe des Objekt in Pixeln, falls die grafische Benutzeroberfläche geladen ist

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

point1 = Draft.make_point(1600, 1400, 0)

p2 = App.Vector(-3200, 1800, 0)
point2 = Draft.make_point(p2, color=(0.5, 0.3, 0.6), point_size=10)

doc.recompute()

Beispiel:

Dieser Code erzeugt N zufällige Punkte innerhalb eines Quadrats der Seitenlänge 2L. Er macht eine Schleife, die N Punkte erzeugt, die überall von -L bis +L auf X und Y erscheinen können. Er wählt auch eine zufällige Farbe und Größe für jeden Punkt. Ändere N, um die Anzahl der Punkte zu ändern, und ändere L, um den von den Punkten abgedeckten Bereich zu ändern.

import random
import FreeCAD as App
import Draft

doc = App.newDocument()

L = 1000
centered = App.Placement(App.Vector(-L, -L, 0), App.Rotation())
rectangle = Draft.make_rectangle(2*L, 2*L, placement=centered)

N = 10
for i in range(N):
    x = 2*L*random.random() - L
    y = 2*L*random.random() - L
    z = 0
    r = random.random()
    g = random.random()
    b = random.random()
    size = 15*random.random() + 5
    Draft.make_point(x, y, z, color=(r, g, b), point_size=size)

doc.recompute()