Skip to content

Latest commit

 

History

History
124 lines (76 loc) · 4.31 KB

Draft_Facebinder.md

File metadata and controls

124 lines (76 loc) · 4.31 KB
Raw
Error in user YAML: (<unknown>): did not find expected alphabetic or numeric character while scanning an alias at line 5 column 14
---
 GuiCommand:
   Name: Draft Facebinder
   MenuLocation: Drafting , Facebinder
   Workbenches: Draft_Workbench, Arch_Workbench
   Shortcut: **F** **F**
   Version: 0.14
---

Draft Facebinder

Description

The Draft Facebinder command creates a surface object from selected faces. A Draft Facebinder is parametric, it will update if you modify its source object(s).

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*

Usage

  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

{{TitleProperty|Draft}}

  • Area|Area: (read-only) specifies the total area of the linked faces of the facebinder.

  • Extrusion|Distance: specifies the extrusion thickness of the facebinder.

  • Faces|LinkSubList: specifies the linked faces of the facebinder.

  • Offset|Distance: specifies an offset distance to apply between the facebinder and the original faces, prior to extrusion.

  • Remove Splitter|Bool: Specifies whether to remove splitter lines that divide co-planar faces of the facebinder.

  • Sew|Bool: Specifies whether to perform a topological sewing operation on the facebinder.

View

{{TitleProperty|Draft}}

  • Pattern|Enumeration: specifies the Draft Pattern with which to fill the faces of the facebinder. This property only works if Display Mode is {{value|Flat Lines}}.

  • Pattern 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 ((v0.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()

⏵ documentation index > Draft > Draft Facebinder