Draft Label/de: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Emphasis|Hinweis:}} die Richtung des horizontalen geraden Segments, nach rechts oder links, richtet den Text automatisch in die entgegengesetzte Richtung aus. Wenn die Führ...")
No edit summary
 
(85 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
{{Docnav/de
|[[Draft_CubicBezCurve/de|KubischeBezKurve]]
|[[Draft_Dimension/de|Maß]]
|[[Draft_AnnotationStyleEditor/de|BeschriftungsstilEditor]]
|[[Draft_Move/de|Bewege]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Draft]]
IconL=Draft CubicBezCurve.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}
}}


{{GuiCommand/de
{{GuiCommand/de
|Name=Draft Label
|Name=Draft Label
|Name/de=Entwurf Etikett
|Name/de=Draft Hinweis
|MenuLocation=EntwurfEtikett
|MenuLocation=AnmerkungBezeichnung
|Workbenches=[[Draft_Module/de|Entwurf]], [[Arch_Module/de|Arch]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Shortcut={{KEY|D}} {{KEY|L}}
|Shortcut={{KEY|D}} {{KEY|L}}
|SeeAlso=[[Draft_Text/de|Entwurf Text]], [[Draft_ShapeString/de|Entwurf FormZeichenfolge]]
|Version=0.17
|Version=0.17
|SeeAlso=[[Draft_Text/de|Draft Text]], [[Draft_ShapeString/de|Draft Textform]]
}}
}}


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


Der Befehl [[Image:Draft_Label.svg|24px]] '''Draft Hinweis''' erstellt einen mehrzeiligen Text an einer zweiteiligen Hinweislinie mit Pfeilspitze.
Das Etikettenwerkzeug fügt ein mehrzeiliges Textfeld mit einer 2-teiligen Führungslinie und einem Pfeil ein. Wenn beim Starten des Befehls ein Objekt oder ein Unterelement (Fläche, Kante oder Scheitelpunkt) ausgewählt wird, kann das Etikett veranlasst werden, ein bestimmtes Attribut des ausgewählten Elements anzuzeigen, einschließlich Position, Länge, Fläche, Volumen oder Material.


Wenn ein Objekt oder ein Teilelement (Fläche, Kante oder Knotenpunkt) ausgewählt ist, wenn der Befehl aufgerufen wird, kann der Text dazu verwendet werden ein oder zwei Attribute des ausgewählten Elements darzustellen, einschließlich Position, Länge, Flächeninhalt, Volumen und Material. Der Text ist dann mit den Attributen verknüpft und wird aktualisiert, wenn sie ihre Werte ändern.
Um ein einfacheres Textelement ohne Pfeil einzufügen, verwende [[Draft Text/de|Entwurf Text]]. Um feste Textformen zu erstellen, verwende [[Draft ShapeString/de|Entwurf FormZeichenfolge]] mit [[Part Extrude/de|Part extrudieren]].

Um stattdessen ein Textelement ohne Hinweispfeil zu erstellen, verwendet man den Befehl [[Draft_Text|Draft Text]].


[[Image:Draft_Label_example.jpg|400px]]
[[Image:Draft_Label_example.jpg|400px]]
{{Caption|Verschiedene Etiketten mit unterschiedlichen Ausrichtungen, Hinweissymbolen und Informationen}}
{{Caption|Verschiedene Hinweise mit unterschiedlichen Ausrichtungen, Hinweispfeilen und Informationen}}


<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 die {{Button|[[Image:Draft_Label.svg|16px]] [[Draft Label/de|Entwurf Etikett]]}} Schaltfläche oder drücke {{KEY|D}} und dann {{KEY|L}} Schaltflächen.
# Klicke auf einen ersten Punkt in der 3D Ansicht oder gib eine [[Draft_Coordinates/de|Koordinate]] ein und drücke die {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}} Schaltfläche. Dieser Punkt gibt das Ziel (Pfeilspitze) an. Dies kann überall sein, es muss kein Element sein.
# Klicke auf einen zweiten Punkt in der 3D Ansicht, oder gib eine [[Draft_Coordinates/de|Koordinate]] ein, und drücke die {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}} Schaltfläche. Dieser Punkt zeigt den Beginn einer horizontalen oder vertikalen Führungslinie an.
# Klicke auf einen dritten Punkt in der 3D Ansicht, oder gib eine [[Draft_Coordinates/de|Koordinate]] ein, und drücke die {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}} Schaltfläche. Dieser Punkt gibt den Basispunkt des Textes an.


# Wahlweise ein Objekt oder ein Unterelement (Knotenpunkt, Kante oder Fläche) auswählen, dessen Attribute man anzeigen möchte.
{{Emphasis|Hinweis:}} die Richtung des horizontalen geraden Segments, nach rechts oder links, richtet den Text automatisch in die entgegengesetzte Richtung aus. Wenn die Führungslinie vertikal nach oben geht, wird der Text nach links ausgerichtet; wenn sie vertikal nach unten geht, wird sie nach rechts ausgerichtet.
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:

#* Die Schaltfläche {{Button|[[Image:Draft_Label.svg|16px]] [[Draft_Label/de|Bezeichnung]]}} drücken.
{{emphasis|Note 2:}} by pre-selecting an object, or a sub-element (vertex, edge or face), before pressing the tool button, the label will become parametric, that is, it will remember which object it is bound to, and it will be able to display a particular attribute of that object. If the attributes of the object change later on, the label will adjust the displayed information.
#* Den Menüeintrag {{MenuCommand|Anmerkung → [[Image:Draft_Label.svg|16px]] Bezeichnung}} auswählen.
#* Das Tastaturkürzel {{KEY|D}} dann {{KEY|L}}.
# Der Aufgaben-Bereich {{MenuCommand|Beschriftung}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informationen.
# Wenn ein Element ausgewählt wurde: Einen Eintrag aus dem Ausklappmenü {{MenuCommand|Labeltyp}} auswählen. Siehe [[#Hinweisarten|Hinweisarten]] weiter unten.
# Den ersten Punkt in der [[3D_view/de|3D-Ansicht]] auswählen oder Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} drücken. Dieser Punkt bestimmt das Ziel (Pfeilspitze). Es kann irgendwo liegen und muss sich nicht auf einem Element befinden.
# Den zweiten Punkt in der [[3D_view/de|3D-Ansicht]] auswählen oder Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} drücken. Dieser Punkt bestimmt den Beginn des horizontalen bzw. vertikalen Abschnitts der Hinweislinie.
#Den dritten Punkt in der [[3D_view/de|3D-Ansicht]] auswählen oder Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} drücken. Dieser Punkt bestimmt den Basispunkt des Texts.


<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.
* Click on {{Button|Label type}} to select the type of information to display, including "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", and "Material". (See explanation of [[#Label_types|Label types]] below)
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have the desired values to insert the point.
* Hold {{KEY|Ctrl}} while placing the label to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Press {{KEY|Esc}} or the {{button|Close}} button to abort the current command.


* Zur manuellen Eingabe der Koordinaten, werden die X-, Y- und Z-Komponenten einzeln eingegeben und jeweils mit {{KEY|Enter}} bestätigt. Es kann auch die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} gedrückt werden, wenn die gewünschten Werte vorhanden sind. Es ist ratsam den Mauszeiger aus der [[3D_view/de|3D-Ansicht]] heraus zu bewegen, bevor Koordinaten eingegeben werden.
* {{KEY|R}} drücken oder die Checkbox {{MenuCommand|Relativ}} aktivieren, um den Relativmodus ein- bzw. auszuschalten. Bei aktiviertem Relativmodus haben Koordinaten einen Bezug zum letzten Punkt, wenn vorhanden, andernfalls beziehen sie sich auf den Ursprung des Koordinatensystems.
* {{KEY|G}} drücken oder die Checkbox {{MenuCommand|Global}} aktivieren, um den Globalmodus ein- bzw. auszuschalten. Bei aktiviertem Globalmodus haben Koordinaten einen Bezug zum globalen Koordinatensystem, andernfalls beziehen sich Koordinaten auf das Koordinatensystem der [[Draft_SelectPlane/de|Arbeitsebene]]. {{Version/de|0.20}}
* {{KEY|S}} drücken, um [[Draft_Snap|Draft Fangen]] ein- oder auszuschalten.
* {{KEY|Esc}} oder die Schaltfläche {{Button|Schließen}} drücken, um den Befehl abzubrechen.

<span id="Label_types"></span>
==Hinweisarten==

Die folgenden Arten von Hinweisen stehen zur Verfügung:

* {{Value|Benutzerdefiniert}} (Custom): zeigt den Inhalt der {{PropertyData/de|Custom Text}} an.
* {{Value|Name}}: zeigt den internen Namen des Zielobjekts an; der interne Name wird dem Objekt bei seiner Erstellung zugewiesen und ist während der gesamten Existenz des Objekts unveränderlich.
* {{Value|Benennung}} (Label): zeigt die Benennung des Zielobjekts an; die Benennung eines Objekts kann jederzeit vom Benutzer geändert werden.
* {{Value|Position}}: zeigt die Koordinaten des Basispunktes des Zielobjekts, des Zielknotenpunktes oder des Schwerpunktes des Ziel-Teilelements an, falls vorhanden.
* {{Value|Length}}: zeigt die Länge des Zielobjekts oder des Unterelements an, falls vorhanden.
* {{Value|Area}}: zeigt den Flächeninhalt des Zielobjekts oder des Unterelements an, falls vorhanden.
* {{Value|Volume}}: zeigt das Volumen des Zielobjekts an, falls vorhanden.
* {{Value|Kennzeichen}} (Tag): zeigt das Attribut {{incode|Tag}} des Zielobjekts an, falls vorhanden. Objekte, die mit dem Arbeitsbereich [[Arch_Workbench/de|Arch]] erstellt wurden, können dieses Attribut besitzen.
* {{Value|Material}}: zeigt die Benennung des Materials des Zielobjekts an, falls vorhanden
* {{Value| Benennung + Position}}
* {{Value| Benennung + Länge}}
* {{Value| Benennung + Flächeninhalt}}
* {{Value| Benennung + Volumen}}
* {{Value| Benennung + Material}}

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

* Die Richtung des zweiten Abschnitts der Hinweislinie bestimmt die Ausrichtung des Textes. Wenn der Abschnitt horizontal ist und nach rechts zeigt, wird der Text links (-bündig) ausgerichtet und umgekehrt. Wenn der zweite Abschnitt vertikal nach oben zeigt, wird der Text links ausgerichtet. Zeigt er vertikal nach unten, wird der Text rechts ausgerichtet.
* Draft-Notizen, die mit [[Release_notes_0.21/de|FreeCAD Version 0.21]] erstellt oder gespeichert werden, sind nicht abwärtskompatibel.

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


Siehe auch: [[Property_editor/de|Eigenschafteneditor]].
=== Data ===
* {{PropertyData|Label Type}}: specifies the type of information shown by this label (see [[#Label_types|Label types]] below).
* {{PropertyData|Custom Text}}: specifies the text block to display when {{PropertyData|Label Type}} is set to "Custom", or the label is not parametric. The text is given as a list of strings; each element on the list, separated by a comma, indicates a new line of text.
* {{PropertyData|Text}}: (read-only) indicates the actual text displayed by the label, depending on the {{PropertyData|Label Type}}.
* {{PropertyData|Target Point}}: specifies the position of the tip of the leader.
* {{PropertyData|Straight Direction}}: specifies the direction of the straight segment of the leader, either horizontal or vertical.
* {{PropertyData|Straight Distance}}: specifies the length of the straight segment of the leader, starting from the base point of the text. If the distance is positive, the leader starts from the right side of the text, and the text aligns to the right; otherwise, the leader starts from the left side of the text, and the text aligns to the left.
* {{PropertyData|Position}}: specifies the base point of the first line of the text block; it also influences how the leader is drawn.
* {{PropertyData|Angle}}: specifies the rotation of the baseline of the first line of the text block; it also influences how the leader is drawn, as it will no longer be horizontal or vertical.
* {{PropertyData|Axis}}: specifies the axis to use for the rotation.


Ein Draft-Hinweis (Label-Objekt) ist von einem [[App_FeaturePython/de|App FeaturePython]]-Objekt abgeleitet und erbt alle seine Eigenschaften. Die folgenden sind, wenn nicht anders angegeben, zusätzliche Eigenschaften:
==== Etikettentypen ====


<span id="Data"></span>
* {{Emphasis|Custom:}} displays the contents of {{PropertyData|Custom Text}}.
===Daten===
* {{Emphasis|Name:}} displays the internal name of the target object; the internal name is assigned to the object at its creation time, and remains fixed throughout the existence of the object.
* {{Emphasis|Label:}} displays the label of the target object; the label of the object can be changed by the user at any time.
* {{Emphasis|Position:}} displays the coordinates of the base point of the target object, of the target vertex, or of the center of mass of the target sub-element, if applicable.
* {{Emphasis|Length:}} displays the length of the target sub-element, if applicable.
* {{Emphasis|Area:}} displays the area of the target sub-element, if applicable.
* {{Emphasis|Volume:}} displays the volume of the target object, if applicable.
* {{Emphasis|Tag:}} displays the {{incode|Tag}} attribute of the target object, if the object has such property, for example, objects created with the [[Arch Workbench]].
* {{Emphasis|Material:}} displays the label of the material of the target object, if the target object has such property.


{{TitleProperty|Label}}
=== View ===
* {{PropertyView|Text Font}}: specifies the font to use to draw the text. It can be a font name, such as "Arial", a default style such as "sans", "serif" or "mono", a family such as "Arial,Helvetica,sans" or a name with a style such as "Arial:Bold". If the given font is not found on the system, a generic one is used instead.
* {{PropertyView|Text Size}}: specifies the size of the text. If the label object is created in the tree view but no text is visible in the 3D view, increase the size of the text until it is visible.
* {{PropertyView|Text Alignment}}: specifies the vertical alignment of the baseline of the text with respect to the leader. It can be top, middle or bottom.
* {{PropertyView|Text Color}}: specifies the color of the text in an RGB tuple (R, G, B).
* {{PropertyView|Line Width}}: specifies the width of the leader.
* {{PropertyView|Line Color}}: specifies the color of the leader.
* {{PropertyView|Arrow Size}}: specifies the size of the symbol displayed at the tip of the leader.
* {{PropertyView|Arrow Type}}: specifies the type of symbol displayed at the tip of the leader, which can be dot, circle, arrow, or tick.
* {{PropertyView|Frame}}: if it is "Rectangle" it will draw a frame around the text.
* {{PropertyView|Line}}: if it is {{TRUE}} the leader line will be displayed; otherwise only the text and the symbol at the tip will be displayed.
* {{PropertyView|Display Mode}}: if it is "3D text" the text will be aligned to the scene axes, initially lying on the XY plane; if it is "2D text" the text will always face the camera.


* {{PropertyData/de|Custom Text|StringList}}: bestimmt den Inhalt des Textes, wenn die {{PropertyData/de|Label Type}} auf {{Value|Custom}} gesetzt ist. Jedes Element der Liste stellt eine neue Textzeile dar.
==Scripting==
* {{PropertyData/de|Label Type|Enumeration}}: bestimmt die Art der von der Notiz dargestellten Information. Siehe [[#Notizarten|Notizarten]].
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].
* {{PropertyData/de|Placement|Placement}}: bestimmt die Position des Textes in der [[3D view/de|3D-Ansicht]] und, solange die {{PropertyData/de|Straight Direction}} nicht auf {{Value|Custom}} gesetzt ist, auch die des ersten Abschnitts der Hinweislinie, an dem der Text befestigt ist. Siehe [[Placement/de|Positionierung]].
* {{PropertyData/de|Text|StringList}}: (read-only) bestimmt den Inhalt des Textes, der aktuell dargestellt wird. Jedes Element der Liste stellt eine neue Textzeile dar.


{{TitleProperty|Leader}}
The Label tool can be used in [[macros]] and from the [[Python]] console by using the following function:
{{Code|code=
Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
}}


* {{PropertyData/de|Points|VectorList}}: Bestimmt die Punkte der Hinweislinie.
* Creates a {{incode|Label}} object, with the leader pointing to {{incode|targetpoint}}, and linking to the {{incode|target}} object which must be a {{incode|DocumentObject}} ({{emphasis|Editor:}} or a SelectionObject? This is unclear).
* {{PropertyData/de|Straight Direction|Enumeration}}: Bestimmt die Richtung des ersten Abschnitts der HInweislinie: {{Value|Custom}}, {{Value|Horizontal}} oder {{Value|Vertikal}}.
* {{incode|direction}} is either "Horizontal", "Vertical", or "Custom".
* {{PropertyData/de|Straight Distance|Distance}}: Bestimmt die Länge des ersten Abschnitts der Hinweislinie. Wird nur verwendet, wenn die {{PropertyData/de|Straight Direction}} auf {{Value|Horizontal}} oder {{Value|Vertical}} gesetzt wurde. Wenn der Abstand positiv ist, startet die Hinweislinie auf der rechten Seite des Textes und der Text wird nach rechts ausgerichtet. Andernfalls startet die Hinweislinie von der linken Seite des Textes und der Text wird nach links ausgerichtet
* {{incode|distance}} is the distance from the base point of the text to the leader.
* {{incode|labeltype}} is one of "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", or "Material".
* If a {{incode|placement}} is given, it is used for the base point of the text; otherwise the text is created at the origin.


{{TitleProperty|Target}}
Change the custom text by overwriting the {{incode|CustomText}} attribute. A list of strings can be used; each element will be displayed in its own line.


* {{PropertyData/de|Target|LinkSub}} (Ziel): Gibt das Objekt und wahlweise das Unterelement an, mit dem der Hinweis verknüpft ist .
The view properties of {{incode|Label}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.TextSize}} with the new size in millimeters.
* {{PropertyData/de|Target Point|Vector}} (Zielpunkt): Gibt die Position der Spitze der Hinweislinie an, d.h. wo der Pfeil befestigt wird.

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

{{TitleProperty|Annotation}}

* {{PropertyView/de|Annotation Style|Enumeration}}: Gibt den Beschriftungsstil an, der für den Hinweis verwewendet wird. Siehe [[Draft_AnnotationStyleEditor/de|Draft BeschriftungsstilEditor]].
* {{PropertyView/de|Scale Multiplier|Float}}: Gibt den allgemeinen Skalierungsfaktor an, der für den Hinweis verwewendet wird. Siehe

{{TitleProperty|Display Options}}

* {{PropertyView/de|Display Mode|Enumeration}}: Gibt an, wie der Text angezeigt wird. Ist es {{value|World}}, wird der Text auf einer Ebene angezeigt, die durch die {{PropertyData/de|Placement}} des Hinweises festgelegt wird. Ist es {{value|Screen}}, wird der Text immer in Richtung Bildschirm angezeigt. Dies ist eine übernommene Eigenschaft. Die genannten Optionen sind die umbenannten Optionen ({{Version/de|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView/de|Arrow Size|Length}}: Legt die Größe des Symbols fest, das der Spitze der Hinweislinie angezeigt wird.
* {{PropertyView/de|Arrow Type|Enumeration}}: Legt die Art des Symbols fest, das der Spitze der Hinweislinie angezeigt wird und die Werte {{value|Dot}} (Punkt), {{value|Circle}} (Ring), {{value|Arrow}} (Pfeil), {{value|Tick}} (Schrägstrich) oder {{value|Tick-2}} (Schrägstrich-2) annehmen kann.
* {{PropertyView/de|Frame|Enumeration}}: Legt fest, welche Art Rahmen um den Text herum gezeichnet wird. Die Optionen sind zurzeit {{Value|None}} (keiner) oder {{Value|Rectangle}} (Rechteck).
* {{PropertyView/de|Line|Bool}}: Legt fest, ob die Hinweislinie angezeigt wird. Auf {{FALSE}} gesetzt, werden nur der Pfeil und der Text angezeigt.
* {{PropertyView/de|Line Color|Color}}: Legt die Farbe von Hinweislinie und Pfeil fest. Diese wird auch für den Rahmen verwendet ({{Version/de|0.20}}).
* {{PropertyView/de|Line Width|Float}}: Legt die Breite der Hinweisliie fest. Diese wird auch für den Rahmen verwendet ({{Version/de|0.20}}).

{{TitleProperty|Text}}

* {{PropertyView/de|Font Name|Font}}: Bestimmt die Schriftart, die zum Zeichnen des Textes verwendet wird. Dies kann ein Schriftname sein, wie {{value|Arial}}, eine Stilbezeichnung, wie {{value|sans}}, {{value|serif}} oder {{value|mono}}, eine Familie, wie {{value|Arial,Helvetica,sans}}, oder ein Name mit Stilangabe, wie {{value|Arial:Bold}}. Wird die angegebene Schriftart im System nicht gefunden, wird stattdessen eine Standardschrift verwendet. {{Version/de|0.21}}
* {{PropertyView/de|Font Size|Length}}: Bestimmt die Größe der Buchstaben. Der Text kann in der [[3D_view/de|3D-Ansicht]] unsichtbar sein, wenn dieser Wert sehr klein ist. {{Version/de|0.21}}
* {{PropertyView/de|Justification|Enumeration}}: Bestimmt die horizontale Ausrichtung des Textes: {{value|Left}} (links), {{value|Center}} (Mitte) oder {{value|Right}} (rechts). Wird nur verwendet, wenn {{PropertyData/de|Straight Direction}} auf {{Value|Custom}} gesetzt ist. Andernfalls basiert die horizontale Ausrichtung auf dem Vorzeichen (positiv oder negativ) der {{PropertyData/de|Straight Distance}}.
* {{PropertyView/de|Line Spacing|Float}}: Bestimmt den Faktor, der für den Standardzeilenhöhe des Textes verwendet wird.
* {{PropertyView/de|Max Chars|Integer}}: Bestimmt die maximale Anzahl von Schriftzeichen in jeder Zeile des Textes.
* {{PropertyView/de|Text Alignment|Enumeration}}: Bestimmt die vertikale Ausrichtung des Textes: {{value|Top}} (oben), {{value|Middle}} (Mitte) oder {{value|Bottom}} (unten).
* {{PropertyView/de|Text Color|Color}}: Bestimmt die Farbe des Textes.

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

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

Das Werkzeug Draft-Hinweis kann in [[macros/de|Makros]] und aus der [[Python/de|Python]]-Konsole heraus mit der folgenden Funktion verwendet werden:

{{Code|code=
label = make_label(target_point=App.Vector(0, 0, 0),
placement=App.Vector(30, 30, 0),
target_object=None, subelements=None,
label_type="Custom", custom_text="Label",
direction="Horizontal", distance=-10,
points=None)
}}


Beispiel:
Beispiel:

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


doc = App.newDocument()
Rectangle = Draft.makeRectangle(4000, 1000)


p1 = FreeCAD.Vector(-200, 1000, 0)
rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()
place1 = FreeCAD.Placement(FreeCAD.Vector(-1000, 1300, 0), FreeCAD.Rotation())


p1 = App.Vector(-200, 1000, 0)
Label1 = Draft.makeLabel(p1, Rectangle, "Horizontal", 500, "Label", place1)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())
Label1.ViewObject.TextSize = 200


label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
p2 = FreeCAD.Vector(-200, 0, 0)
label1.ViewObject.TextSize = 200
place2 = FreeCAD.Placement(FreeCAD.Vector(-1000, -300, 0), FreeCAD.Rotation())


p2 = App.Vector(-200, 0, 0)
Label2 = Draft.makeLabel(p2, Rectangle, "Horizontal", 500, "Custom", place2)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())
Label2.CustomText = ["Beware of the", "sharp edges"]
Label2.ViewObject.TextSize = 200
FreeCAD.ActiveDocument.recompute()


label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
p3 = FreeCAD.Vector(1000, 1200, 0)
custom_text="Beware of the sharp edges")
place3 = FreeCAD.Placement(FreeCAD.Vector(2000, 1800, 0), FreeCAD.Rotation())
label2.ViewObject.TextSize = 200


p3 = App.Vector(1000, 1200, 0)
Label3 = Draft.makeLabel(p3, Rectangle, "Horizontal", -500, "Area", place3)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())
Label3.ViewObject.TextSize = 200

FreeCAD.ActiveDocument.recompute()
label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.TextSize = 200

doc.recompute()
}}
}}



{{Docnav/de
{{Docnav/de
|[[Draft_CubicBezCurve/de|KubischeBezKurve]]
|[[Draft_Dimension/de|Maß]]
|[[Draft_AnnotationStyleEditor/de|BeschriftungsstilEditor]]
|[[Draft_Move/de|Bewege]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Draft]]
IconL=Draft CubicBezCurve.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}
}}


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

Latest revision as of 19:08, 5 January 2024

Draft Hinweis

Menüeintrag
Anmerkung → Bezeichnung
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
D L
Eingeführt in Version
0.17
Siehe auch
Draft Text, Draft Textform

Beschreibung

Der Befehl Draft Hinweis erstellt einen mehrzeiligen Text an einer zweiteiligen Hinweislinie mit Pfeilspitze.

Wenn ein Objekt oder ein Teilelement (Fläche, Kante oder Knotenpunkt) ausgewählt ist, wenn der Befehl aufgerufen wird, kann der Text dazu verwendet werden ein oder zwei Attribute des ausgewählten Elements darzustellen, einschließlich Position, Länge, Flächeninhalt, Volumen und Material. Der Text ist dann mit den Attributen verknüpft und wird aktualisiert, wenn sie ihre Werte ändern.

Um stattdessen ein Textelement ohne Hinweispfeil zu erstellen, verwendet man den Befehl Draft Text.

Verschiedene Hinweise mit unterschiedlichen Ausrichtungen, Hinweispfeilen und Informationen

Anwendung

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

  1. Wahlweise ein Objekt oder ein Unterelement (Knotenpunkt, Kante oder Fläche) auswählen, dessen Attribute man anzeigen möchte.
  2. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Bezeichnung drücken.
    • Den Menüeintrag Anmerkung → Bezeichnung auswählen.
    • Das Tastaturkürzel D dann L.
  3. Der Aufgaben-Bereich Beschriftung wird geöffnet. Siehe Optionen für weitere Informationen.
  4. Wenn ein Element ausgewählt wurde: Einen Eintrag aus dem Ausklappmenü Labeltyp auswählen. Siehe Hinweisarten weiter unten.
  5. Den ersten Punkt in der 3D-Ansicht auswählen oder Koordinaten eingeben und die Schaltfläche Punkt eingeben drücken. Dieser Punkt bestimmt das Ziel (Pfeilspitze). Es kann irgendwo liegen und muss sich nicht auf einem Element befinden.
  6. Den zweiten Punkt in der 3D-Ansicht auswählen oder Koordinaten eingeben und die Schaltfläche Punkt eingeben drücken. Dieser Punkt bestimmt den Beginn des horizontalen bzw. vertikalen Abschnitts der Hinweislinie.
  7. Den dritten Punkt in der 3D-Ansicht auswählen oder Koordinaten eingeben und die Schaltfläche Punkt eingeben drücken. Dieser Punkt bestimmt den Basispunkt des Texts.

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.

  • Zur manuellen Eingabe der Koordinaten, werden die X-, Y- und Z-Komponenten einzeln eingegeben und jeweils mit Enter bestätigt. Es kann auch die Schaltfläche Punkt eingeben gedrückt werden, wenn die gewünschten Werte vorhanden sind. Es ist ratsam den Mauszeiger aus der 3D-Ansicht heraus zu bewegen, bevor Koordinaten eingegeben werden.
  • R drücken oder die Checkbox Relativ aktivieren, um den Relativmodus ein- bzw. auszuschalten. Bei aktiviertem Relativmodus haben Koordinaten einen Bezug zum letzten Punkt, wenn vorhanden, andernfalls beziehen sie sich auf den Ursprung des Koordinatensystems.
  • G drücken oder die Checkbox Global aktivieren, um den Globalmodus ein- bzw. auszuschalten. Bei aktiviertem Globalmodus haben Koordinaten einen Bezug zum globalen Koordinatensystem, andernfalls beziehen sich Koordinaten auf das Koordinatensystem der Arbeitsebene. eingeführt mit Version 0.20
  • S drücken, um Draft Fangen ein- oder auszuschalten.
  • Esc oder die Schaltfläche Schließen drücken, um den Befehl abzubrechen.

Hinweisarten

Die folgenden Arten von Hinweisen stehen zur Verfügung:

  • Benutzerdefiniert (Custom): zeigt den Inhalt der Daten-EigenschaftCustom Text an.
  • Name: zeigt den internen Namen des Zielobjekts an; der interne Name wird dem Objekt bei seiner Erstellung zugewiesen und ist während der gesamten Existenz des Objekts unveränderlich.
  • Benennung (Label): zeigt die Benennung des Zielobjekts an; die Benennung eines Objekts kann jederzeit vom Benutzer geändert werden.
  • Position: zeigt die Koordinaten des Basispunktes des Zielobjekts, des Zielknotenpunktes oder des Schwerpunktes des Ziel-Teilelements an, falls vorhanden.
  • Length: zeigt die Länge des Zielobjekts oder des Unterelements an, falls vorhanden.
  • Area: zeigt den Flächeninhalt des Zielobjekts oder des Unterelements an, falls vorhanden.
  • Volume: zeigt das Volumen des Zielobjekts an, falls vorhanden.
  • Kennzeichen (Tag): zeigt das Attribut Tag des Zielobjekts an, falls vorhanden. Objekte, die mit dem Arbeitsbereich Arch erstellt wurden, können dieses Attribut besitzen.
  • Material: zeigt die Benennung des Materials des Zielobjekts an, falls vorhanden
  • Benennung + Position
  • Benennung + Länge
  • Benennung + Flächeninhalt
  • Benennung + Volumen
  • Benennung + Material

Hinweise

  • Die Richtung des zweiten Abschnitts der Hinweislinie bestimmt die Ausrichtung des Textes. Wenn der Abschnitt horizontal ist und nach rechts zeigt, wird der Text links (-bündig) ausgerichtet und umgekehrt. Wenn der zweite Abschnitt vertikal nach oben zeigt, wird der Text links ausgerichtet. Zeigt er vertikal nach unten, wird der Text rechts ausgerichtet.
  • Draft-Notizen, die mit FreeCAD Version 0.21 erstellt oder gespeichert werden, sind nicht abwärtskompatibel.

Eigenschaften

Siehe auch: Eigenschafteneditor.

Ein Draft-Hinweis (Label-Objekt) ist von einem App FeaturePython-Objekt abgeleitet und erbt alle seine Eigenschaften. Die folgenden sind, wenn nicht anders angegeben, zusätzliche Eigenschaften:

Daten

Label

  • Daten-EigenschaftCustom Text (StringList): bestimmt den Inhalt des Textes, wenn die Daten-EigenschaftLabel Type auf Custom gesetzt ist. Jedes Element der Liste stellt eine neue Textzeile dar.
  • Daten-EigenschaftLabel Type (Enumeration): bestimmt die Art der von der Notiz dargestellten Information. Siehe Notizarten.
  • Daten-EigenschaftPlacement (Placement): bestimmt die Position des Textes in der 3D-Ansicht und, solange die Daten-EigenschaftStraight Direction nicht auf Custom gesetzt ist, auch die des ersten Abschnitts der Hinweislinie, an dem der Text befestigt ist. Siehe Positionierung.
  • Daten-EigenschaftText (StringList): (read-only) bestimmt den Inhalt des Textes, der aktuell dargestellt wird. Jedes Element der Liste stellt eine neue Textzeile dar.

Leader

  • Daten-EigenschaftPoints (VectorList): Bestimmt die Punkte der Hinweislinie.
  • Daten-EigenschaftStraight Direction (Enumeration): Bestimmt die Richtung des ersten Abschnitts der HInweislinie: Custom, Horizontal oder Vertikal.
  • Daten-EigenschaftStraight Distance (Distance): Bestimmt die Länge des ersten Abschnitts der Hinweislinie. Wird nur verwendet, wenn die Daten-EigenschaftStraight Direction auf Horizontal oder Vertical gesetzt wurde. Wenn der Abstand positiv ist, startet die Hinweislinie auf der rechten Seite des Textes und der Text wird nach rechts ausgerichtet. Andernfalls startet die Hinweislinie von der linken Seite des Textes und der Text wird nach links ausgerichtet

Target

  • Daten-EigenschaftTarget (LinkSub) (Ziel): Gibt das Objekt und wahlweise das Unterelement an, mit dem der Hinweis verknüpft ist .
  • Daten-EigenschaftTarget Point (Vector) (Zielpunkt): Gibt die Position der Spitze der Hinweislinie an, d.h. wo der Pfeil befestigt wird.

Ansicht

Annotation

  • Ansicht EigenschaftAnnotation Style (Enumeration): Gibt den Beschriftungsstil an, der für den Hinweis verwewendet wird. Siehe Draft BeschriftungsstilEditor.
  • Ansicht EigenschaftScale Multiplier (Float): Gibt den allgemeinen Skalierungsfaktor an, der für den Hinweis verwewendet wird. Siehe

Display Options

  • Ansicht EigenschaftDisplay Mode (Enumeration): Gibt an, wie der Text angezeigt wird. Ist es World, wird der Text auf einer Ebene angezeigt, die durch die Daten-EigenschaftPlacement des Hinweises festgelegt wird. Ist es Screen, wird der Text immer in Richtung Bildschirm angezeigt. Dies ist eine übernommene Eigenschaft. Die genannten Optionen sind die umbenannten Optionen (eingeführt mit Version 0.21).

Graphics

  • Ansicht EigenschaftArrow Size (Length): Legt die Größe des Symbols fest, das der Spitze der Hinweislinie angezeigt wird.
  • Ansicht EigenschaftArrow Type (Enumeration): Legt die Art des Symbols fest, das der Spitze der Hinweislinie angezeigt wird und die Werte Dot (Punkt), Circle (Ring), Arrow (Pfeil), Tick (Schrägstrich) oder Tick-2 (Schrägstrich-2) annehmen kann.
  • Ansicht EigenschaftFrame (Enumeration): Legt fest, welche Art Rahmen um den Text herum gezeichnet wird. Die Optionen sind zurzeit None (keiner) oder Rectangle (Rechteck).
  • Ansicht EigenschaftLine (Bool): Legt fest, ob die Hinweislinie angezeigt wird. Auf false gesetzt, werden nur der Pfeil und der Text angezeigt.
  • Ansicht EigenschaftLine Color (Color): Legt die Farbe von Hinweislinie und Pfeil fest. Diese wird auch für den Rahmen verwendet (eingeführt mit Version 0.20).
  • Ansicht EigenschaftLine Width (Float): Legt die Breite der Hinweisliie fest. Diese wird auch für den Rahmen verwendet (eingeführt mit Version 0.20).

Text

  • Ansicht EigenschaftFont Name (Font): Bestimmt die Schriftart, die zum Zeichnen des Textes verwendet wird. Dies kann ein Schriftname sein, wie Arial, eine Stilbezeichnung, wie sans, serif oder mono, eine Familie, wie Arial,Helvetica,sans, oder ein Name mit Stilangabe, wie Arial:Bold. Wird die angegebene Schriftart im System nicht gefunden, wird stattdessen eine Standardschrift verwendet. eingeführt mit Version 0.21
  • Ansicht EigenschaftFont Size (Length): Bestimmt die Größe der Buchstaben. Der Text kann in der 3D-Ansicht unsichtbar sein, wenn dieser Wert sehr klein ist. eingeführt mit Version 0.21
  • Ansicht EigenschaftJustification (Enumeration): Bestimmt die horizontale Ausrichtung des Textes: Left (links), Center (Mitte) oder Right (rechts). Wird nur verwendet, wenn Daten-EigenschaftStraight Direction auf Custom gesetzt ist. Andernfalls basiert die horizontale Ausrichtung auf dem Vorzeichen (positiv oder negativ) der Daten-EigenschaftStraight Distance.
  • Ansicht EigenschaftLine Spacing (Float): Bestimmt den Faktor, der für den Standardzeilenhöhe des Textes verwendet wird.
  • Ansicht EigenschaftMax Chars (Integer): Bestimmt die maximale Anzahl von Schriftzeichen in jeder Zeile des Textes.
  • Ansicht EigenschaftText Alignment (Enumeration): Bestimmt die vertikale Ausrichtung des Textes: Top (oben), Middle (Mitte) oder Bottom (unten).
  • Ansicht EigenschaftText Color (Color): Bestimmt die Farbe des Textes.

Skripten

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

Das Werkzeug Draft-Hinweis kann in Makros und aus der Python-Konsole heraus mit der folgenden Funktion verwendet werden:

label = make_label(target_point=App.Vector(0, 0, 0),
                   placement=App.Vector(30, 30, 0),
                   target_object=None, subelements=None,
                   label_type="Custom", custom_text="Label",
                   direction="Horizontal", distance=-10,
                   points=None)

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()

p1 = App.Vector(-200, 1000, 0)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())

label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.TextSize = 200

p2 = App.Vector(-200, 0, 0)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())

label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
                          custom_text="Beware of the sharp edges")
label2.ViewObject.TextSize = 200

p3 = App.Vector(1000, 1200, 0)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())

label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.TextSize = 200

doc.recompute()