Draft Facebinder/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Draft_Point|Point]]
|[[Draft_ShapeString|ShapeString]]
|[[Draft_ShapeString|ShapeString]]
|[[Draft_Workbench|Draft]]
|[[Draft_BezCurve|Bezier Curve]]
|IconL=Draft_Point.svg
|[[Draft_Module|Draft]]
|IconL=Draft_ShapeString.svg
|IconR=Draft_ShapeString.svg
|IconR=Draft_BezCurve.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/es
{{GuiCommand/es|Name=Draft Facebinder|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft → Facebinder|Shortcut=F F}}
|Name=Draft Facebinder
|Name/es=Draft Facebinder
|Workbenches=[[Draft_Workbench/es|Draft]], [[Arch_Workbench/es|Arch]]
|MenuLocation=Draft → Facebinder
|Shortcut=F F}}
</div>
</div>


<span id="Description"></span>
==Descripción==
==Descripción==


Line 19: Line 26:
</div>
</div>


It can be used to create an extrusion from a collection of faces from other objects. A typical use is in architectural design to build an object that covers several walls, for example, a wall paper, or wall finish.
It can be used to create an extrusion from a collection of faces. This extrusion can for example represent a wall finish in architectural design.


[[Image:Draft facebinder example.jpg|400px]]
[[Image:Draft_facebinder_example.jpg|400px]]
{{Caption|Facebinder created from the faces of solid walls}}
{{Caption|Facebinder created from the faces of walls}}


<span id="Usage"></span>
==Utilización==
==Utilización==


# Pick one face, or hold {{KEY|Ctrl}} and pick several faces, from solid objects.
# Select one or more faces.
# There are several ways to invoke the command:
# Press the {{Button|[[Image:Draft_Facebinder.svg|16px]] [[Draft_Facebinder|Facebinder]]}} button, or press {{KEY|F}} then {{KEY|F}} keys.
#* Press the {{Button|[[Image:Draft_Facebinder.svg|16px]] [[Draft_Facebinder|Facebinder]]}} button.
#* Select the {{MenuCommand|Drafting → [[Image:Draft_Facebinder.svg|16px]] Facebinder}} option from the menu.
#* Use the keyboard shortcut: {{KEY|F}} then {{KEY|F}}.


== Properties ==
The Facebinder can be edited by double clicking on the element in the tree view. Then you can change the faces that are part of the object.
* To add a face, click on a face of a solid object in the 3D view, and then click on the {{Button|[[Image:Arch_Add.svg|16px]] Add}} button.
* To remove a face, select one of the sub-elements in the list, and then click on the {{Button|[[Image:Arch_Remove.svg|16px]] Remove}} button.
* Press {{KEY|Esc}} or the {{Button|OK}} button to complete the edition.


See also: [[Property_editor|Property editor]].
== Options ==
This object has no options when it's being created. Only selected faces will be used to create the Facebinder object.


A Draft Facebinder object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:
== Properties ==

=== Data ===
===Data===
* {{PropertyData|Extrusion}}: specifies an extrusion thickness to apply to all faces of the shape.

* {{PropertyData|Remove Splitter}}: if it is {{TRUE}} it tries to fuse the internal intersections of the Facebinder when it extruded.
{{TitleProperty|Draft}}
* {{PropertyData|Sew}}: if it is {{TRUE}} it tries to perform a topological sewing operation on the Facebinder when it extruded.

* {{PropertyData|Offset}}: specifies an offset distance to apply betweenthe facebinder and the original faces, prior to extrusion.
* {{PropertyData|Area}}: the total area of this facebinder.
* {{PropertyData|Area|Area}}: (read-only) specifies the total area of the linked faces of the facebinder.
* {{PropertyData|Extrusion|Distance}}: specifies the extrusion thickness of the facebinder.
* {{PropertyData|Faces|LinkSubList}}: specifies the linked faces of the facebinder.
* {{PropertyData|Offset|Distance}}: specifies an offset distance to apply between the facebinder and the original faces, prior to extrusion.
* {{PropertyData|Remove Splitter|Bool}}: Specifies whether to remove splitter lines that divide co-planar faces of the facebinder.
* {{PropertyData|Sew|Bool}}: Specifies whether to perform a topological sewing operation on the facebinder.


=== View ===
=== View ===

* {{PropertyView|Pattern}}: specifies a [[Draft Pattern|Draft Pattern]] with which to fill the face of the shape. This property only works if {{PropertyView|Display Mode}} is "Flat Lines".
{{TitleProperty|Draft}}
* {{PropertyView|Pattern Size}}: specifies the size of the [[Draft Pattern|Draft Pattern]].

* {{PropertyView|Pattern|Enumeration}}: specifies the [[Draft_Pattern|Draft Pattern]] with which to fill the faces of the facebinder. This property only works if {{PropertyView|Display Mode}} is {{value|Flat Lines}}.
* {{PropertyView|Pattern Size|Float}}: specifies the size of the [[Draft_Pattern|Draft Pattern]].


==Scripting==
==Scripting==
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
The Facebinder tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:

To create a Draft Facebinder use the {{incode|make_facebinder}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makeFacebinder}} method.

{{Code|code=
{{Code|code=
Facebinder = makeFacebinder(selectionset)
facebinder = make_facebinder(selectionset)
}}
}}

* Creates a {{incode|Facebinder}} object from the given {{incode|selectionset}}, which is a list of {{incode|SelectionObject}}s as returned by {{incode|FreeCADGui.Selection.getSelectionEx()}}. Only selected faces are taken into account.
* Creates a {{incode|facebinder}} object from the given {{incode|selectionset}}, which is a list of {{incode|SelectionObject}}s as returned by {{incode|FreeCADGui.Selection.getSelectionEx()}}. Only selected faces are taken into account.
** {{incode|selectionset}} can also be a {{incode|PropertyLinkSubList}}.
** {{incode|selectionset}} can also be a {{incode|PropertyLinkSubList}}.
Line 73: Line 91:


Example:
Example:

{{Code|code=
{{Code|code=
import FreeCAD
import FreeCAD as App
import FreeCADGui
import FreeCADGui as Gui
import Draft
import Draft

doc = App.newDocument()


# Insert a solid box
# Insert a solid box
Box = FreeCAD.ActiveDocument.addObject("Part::Box", "Box")
box = doc.addObject("Part::Box", "Box")
Box.Length = 2300
box.Length = 2300
Box.Width = 800
box.Width = 800
Box.Height = 1000
box.Height = 1000


# selection = FreeCADGui.Selection.getSelectionEx()
# selection = Gui.Selection.getSelectionEx()
selection = [(Box, ("Face1", "Face6"))]
selection = [(box, ("Face1", "Face6"))]
Facebinder = Draft.makeFacebinder(selection)
facebinder = Draft.make_facebinder(selection)
Facebinder.Extrusion = 50
facebinder.Extrusion = 50
FreeCAD.ActiveDocument.recompute()


doc.recompute()
Facebinder.Placement.Base = FreeCAD.Vector(1000, -1000, 100)

Facebinder.ViewObject.ShapeColor = (0.99, 0.99, 0.4)
facebinder.Placement.Base = App.Vector(1000, -1000, 100)
facebinder.ViewObject.ShapeColor = (0.99, 0.99, 0.4)

doc.recompute()
}}
}}



{{Docnav
{{Docnav
|[[Draft_Point|Point]]
|[[Draft_ShapeString|ShapeString]]
|[[Draft_ShapeString|ShapeString]]
|[[Draft_Workbench|Draft]]
|[[Draft_BezCurve|Bezier Curve]]
|IconL=Draft_Point.svg
|[[Draft_Module|Draft]]
|IconL=Draft_ShapeString.svg
|IconR=Draft_ShapeString.svg
|IconR=Draft_BezCurve.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 105: Line 130:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 19:31, 7 December 2023

Draft Facebinder

Ubicación en el Menú
Draft → Facebinder
Entornos de trabajo
Draft, Arch
Atajo de teclado por defecto
F F
Introducido en versión
-
Ver también
Ninguno

Descripción

El ”facebinder” un objeto muy simple construido a partir de caras seleccionadas de otros objetos. Es de tipo paramétrico, puede modificar el objeto original y las actualizaciones del objeto de faceta en consecuencia. Luego se puede usar, por ejemplo, para hacer una extrusión de una colección de caras de otros objetos. Un uso típico es en el diseño arquitectónico, para construir un objeto que cubre varias piezas de paredes. Puede mover y rotar el encuadernador después de su creación, todo permanecerá vinculado a las caras originales.

It can be used to create an extrusion from a collection of faces. This extrusion can for example represent a wall finish in architectural design.

Facebinder created from the faces of walls

Utilización

  1. Select one or more faces.
  2. There are several ways to invoke the command:
    • Press the Facebinder button.
    • Select the Drafting → Facebinder option from the menu.
    • Use the keyboard shortcut: F then F.

Properties

See also: Property editor.

A Draft Facebinder object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

Draft

  • DatosArea (Area): (read-only) specifies the total area of the linked faces of the facebinder.
  • DatosExtrusion (Distance): specifies the extrusion thickness of the facebinder.
  • DatosFaces (LinkSubList): specifies the linked faces of the facebinder.
  • DatosOffset (Distance): specifies an offset distance to apply between the facebinder and the original faces, prior to extrusion.
  • DatosRemove Splitter (Bool): Specifies whether to remove splitter lines that divide co-planar faces of the facebinder.
  • DatosSew (Bool): Specifies whether to perform a topological sewing operation on the facebinder.

View

Draft

  • VistaPattern (Enumeration): specifies the Draft Pattern with which to fill the faces of the facebinder. This property only works if VistaDisplay Mode is Flat Lines.
  • VistaPattern Size (Float): specifies the size of the Draft Pattern.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a Draft Facebinder use the make_facebinder method (introduced in version 0.19) of the Draft module. This method replaces the deprecated makeFacebinder method.

facebinder = make_facebinder(selectionset)
  • Creates a facebinder object from the given selectionset, which is a list of SelectionObjects as returned by FreeCADGui.Selection.getSelectionEx(). Only selected faces are taken into account.
    • selectionset can also be a PropertyLinkSubList.

A PropertyLinkSubList is a list of tuples; each tuple contains as first element an object, and as second element a list (or tuple) of strings; these strings indicate the names of the sub-elements (faces) of that object.

PropertyLinkSubList = [tuple1, tuple2, tuple3, ...]
PropertyLinkSubList = [(object1, list1), (object2, list2), (object3, list3), ...]
PropertyLinkSubList = [(object1, ['Face1', 'Face4', 'Face6']), ...]
PropertyLinkSubList = [(object1, ('Face1', 'Face4', 'Face6')), ...]

The thickness of the Facebinder can be added by overwriting its Extrusion attribute; the value is entered in millimeters.

The placement of the Facebinder can be changed by overwriting its Placement attribute, or by individually overwriting its Placement.Base and Placement.Rotation attributes.

Example:

import FreeCAD as App
import FreeCADGui as Gui
import Draft

doc = App.newDocument()

# Insert a solid box
box = doc.addObject("Part::Box", "Box")
box.Length = 2300
box.Width = 800
box.Height = 1000

# selection = Gui.Selection.getSelectionEx()
selection = [(box, ("Face1", "Face6"))]
facebinder = Draft.make_facebinder(selection)
facebinder.Extrusion = 50

doc.recompute()

facebinder.Placement.Base = App.Vector(1000, -1000, 100)
facebinder.ViewObject.ShapeColor = (0.99, 0.99, 0.4)

doc.recompute()