Draft Label/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(71 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_Move.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 11: Line 12:
{{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 Knoten) 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|Hinweis 2:}} durch Vorauswahl eines Objekts oder eines Unterelements (Knoten, Kante oder Fläche) vor dem Drücken der Werkzeugschaltfläche wird die Beschriftung parametrisch, d. h. sie merkt sich, an welches Objekt sie gebunden ist, und kann ein bestimmtes Attribut dieses Objekts anzeigen. Wenn sich die Attribute des Objekts später ändern, passt das Etikett die angezeigten Informationen an.
#* 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.
* Klicke auf {{Button|Etikettentyp}}, um die Art der anzuzeigenden Informationen auszuwählen, einschließlich "Benutzerdefiniert", "Name", "Etikett", "Position", "Länge", "Bereich", "Volumen", "Tag" und "Material". (Siehe Erklärung der [[#Label_types/de|Labeltypen]] unten)
* Um Koordinaten manuell einzugeben, gib einfach die Zahlen ein und drücke dann {{KEY|Eingabe}} zwischen jeder X, Y und Z Komponente. Du kannst die {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}} Schaltfläche drücken wenn du die gewünschten Werte zum Einfügen des Punktes hast.
* Halte {{KEY|Strg}} gedrückt, während der Platzierung der Beschriftung, um [[Draft_Snap/de|Fang]] deinen Punkt unabhängig von der Entfernung an die nächstgelegene Fangposition zu zwingen.
* Drücke {{KEY|Esc}} oder die {{Button|Schließen}} Schaltfläche, um den aktuellen Befehl abzubrechen.


* 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:

<div class="mw-translate-fuzzy">
* {{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}}
</div>

<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.
* {{PropertyData/de|Label Type|Enumeration}}: bestimmt die Art der von der Notiz dargestellten Information. Siehe [[#Notizarten|Notizarten]].
* {{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}}

* {{PropertyData/de|Points|VectorList}}: Bestimmt die Punkte der Hinweislinie.
* {{PropertyData/de|Straight Direction|Enumeration}}: Bestimmt die Richtung des ersten Abschnitts der HInweislinie: {{Value|Custom}}, {{Value|Horizontal}} oder {{Value|Vertikal}}.
* {{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

{{TitleProperty|Target}}

* {{PropertyData/de|Target|LinkSub}} (Ziel): Gibt das Objekt und wahlweise das Unterelement an, mit dem der Hinweis verknüpft ist .
* {{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==
==Skripten==
{{Emphasis|Siehe auch:}} [[Draft API/de|Entwurf 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]].
Das Etikett Werkzeug kann in [[macros/de|Makros]] und aus der [[Python/de|Python]] Konsole mit der folgenden Funktion verwendet werden:

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=
{{Code|code=
label = make_label(target_point=App.Vector(0, 0, 0),
Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
placement=App.Vector(30, 30, 0),
target_object=None, subelements=None,
label_type="Custom", custom_text="Label",
direction="Horizontal", distance=-10,
points=None)
}}
}}


Beispiel:
* Erstellt ein {{incode|Etikett}} Objekt, wobei die Führung auf {{incode|Zielpunkt}} zeigt und auf das {{incode|Ziel}} Objekt verweist, das ein {{incode|DokumentObjekt}} sein muss. ({{Emphasis|Editor:}} oder ein AuswahlObjekt? Das ist unklar).
* {{incode|Richtung}} ist entweder "Horizontal", "Vertikal" oder "Benutzerdefiniert".
* {{incode|Abstand}} ist der Abstand vom Basispunkt des Textes bis zur Führung.
* {{incode|Etikettentype}} ist eines von "Benutzerdefiniert", "Name", "Etikett", "Position", "Länge", "Fläche", "Volumen", "Tag" oder "Material".
* Wenn eine {{incode|Positionierung}} angegeben wird, wird er für den Basispunkt des Textes verwendet; andernfalls wird der Text am Ursprung erstellt.


{{Code|code=
Ändere den benutzerdefinierten Text, durch überschreiben des {{incode|AngepassterText}} Attributs. Es kann eine Liste von Zeichenfolgen verwendet werden; jedes Element wird in einer eigenen Zeile angezeigt.
import FreeCAD as App
import Draft


doc = App.newDocument()
Die Ansichtseigenschaften von {{incode|Etikett}} können durch Überschreiben seiner Attribute geändert werden; z.B. überschreibe {{incode|ViewObject.TextSize}} mit der neuen Größe in Millimetern.


rectangle = Draft.make_rectangle(4000, 1000)
Beispiel:
doc.recompute()
{{Code|code=
import FreeCAD, Draft


Rectangle = Draft.makeRectangle(4000, 1000)
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")
p1 = FreeCAD.Vector(-200, 1000, 0)
label1.ViewObject.TextSize = 200
place1 = FreeCAD.Placement(FreeCAD.Vector(-1000, 1300, 0), FreeCAD.Rotation())


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


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


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


label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
p3 = FreeCAD.Vector(1000, 1200, 0)
label3.ViewObject.TextSize = 200
place3 = FreeCAD.Placement(FreeCAD.Vector(2000, 1800, 0), FreeCAD.Rotation())


doc.recompute()
Label3 = Draft.makeLabel(p3, Rectangle, "Horizontal", -500, "Area", place3)
Label3.ViewObject.TextSize = 200
FreeCAD.ActiveDocument.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_Move.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 141: Line 207:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 08:45, 28 March 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()