|
Ubicación en el Menú |
---|
Draft → Label |
Entornos de trabajo |
Draft, Arch |
Atajo de teclado por defecto |
D L |
Introducido en versión |
- |
Ver también |
Ninguno |
Esta herramienta inserta una etiqueta, que es un fragmento de texto con una línea de 2 segmentos y una flecha, en el documento activo. Si se selecciona un objeto o un subelemento (cara, borde o vértice) al iniciar el comando, se puede hacer que la Etiqueta muestre automáticamente un determinado atributo del elemento seleccionado.
If an object or a sub-element (face, edge or vertex) is selected when starting the command, the text can be made to display one or two attributes of the selected element, including position, length, area, volume and material. The text will then be linked to the attributes and will update if their values change.
To insert a text element without an arrow use the Draft Text command instead.
See also: Draft Tray, Draft Snap and Draft Constrain.
The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.
The following label types are available:
Custom
: displays the contents of DatosCustom Text.Name
: displays the internal name of the target object. The internal name is assigned when an object is created and remains fixed throughout the existence of the object.Label
: displays the label of the target object. The label of an object can be changed by the user.Position
: displays the coordinates of the base point of the target object or of the target vertex.Length
: displays the length of the target object or subelement.Area
: displays the area of the target object or subelement.Volume
: displays the volume of the target object.Tag
: displays the Tag
attribute of the target object. Objects created with the BIM Workbench can have this attribute.Material
: displays the label of the material of the target object.Label + Position
Label + Length
Label + Area
Label + Volume
Label + Material
See also: Property editor.
A Draft Label object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated:
Label
StringList
): specifies the contents of the text if DatosLabel Type is Custom
. Each item in the list represents a new text line.Enumeration
): specifies the type of information displayed by the label. See Label types.Placement
): specifies the position of the text in the 3D view and, unless DatosStraight Direction is Custom
, also of the first leader segment, which is the segment where the text is attached. See Placement.StringList
): (read-only) specifies the contents of the text that is actually displayed. Each item in the list represents a new text line.Leader
VectorList
): specifies the points of the leader.Enumeration
): specifies the direction of the first leader segment: Custom
, Horizontal
or Vertical
.Distance
): specifies the length of the first leader segment. Only used if DatosStraight Direction is Horizontal
or Vertical
. 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.Target
LinkSub
): specifies the object and optional subelement the label is linked to.Vector
): specifies the position of the tip of the leader, which is where the arrow is attached.Annotation
Enumeration
): specifies the annotation style applied to the label. See Draft AnnotationStyleEditor.Float
): specifies the general scaling factor applied to the label.Display Options
Enumeration
): specifies how the text is displayed. If it is World
the text will be displayed on a plane defined by the DatosPlacement of the label. If it is Screen
the text will always face the screen. This is an inherited property. The mentioned options are the renamed options (introduced in version 0.21).Graphics
Length
): specifies the size of the symbol displayed at the tip of the leader.Enumeration
): specifies the type of symbol displayed at the tip of the leader, which can be Dot
, Circle
, Arrow
, Tick
or Tick-2
.Enumeration
): specifies what type of frame is drawn around the text. The current options are None
or Rectangle
.Bool
): specifies whether to display the leader line. If it is false
only the arrow and the text are displayed.Color
): specifies the color of the leader and the arrow. This is also used for the frame.Float
): specifies the width of the leader. This is also used for the frame.Text
Font
): specifies the font used 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 default font is used instead. introduced in version 0.21Length
): specifies the size of the letters. The text can be invisible in the 3D view if this value is very small. introduced in version 0.21Enumeration
): specifies the horizontal alignment of the text: Left
, Center
or Right
. Only used if DatosStraight Direction is Custom
. Otherwise the horizontal alignment is based on the sign (positive or negative) of DatosStraight Distance.Float
): specifies the factor applied to the default line height of the text.Integer
): specifies the maximum number of characters on each line of the text.Enumeration
): specifies the vertical alignment of the text: Top
, Middle
or Bottom
.Color
): specifies the color of the text.See also: Autogenerated API documentation and FreeCAD Scripting Basics.
To create a Draft Label use the make_label
method (introduced in version 0.19) of the Draft module. This method replaces the deprecated makeLabel
method.
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)
Ejemplo:
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.FontSize= 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.FontSize= 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.FontSize= 200
doc.recompute()