Surface Filling/hr

From FreeCAD Documentation
Jump to navigation Jump to search
This page is a translated version of the page Surface Filling and the translation is 13% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎română

Surface Filling.svg Surface Filling

Menu location
Surface → Filling
Default shortcut
Introduced in version
See also


Surface Filling.svg Surface Filling creates a surface from a series of connected boundary edges. The curvature of the surface can be additionally controlled by non-boundary edges and vertices, and a support surface.

The base geometry can belong to curves created with the Draft Workbench or the Sketcher Workbench, but can also belong to solid objects such as those created with the Part Workbench or the PartDesign Workbench.

Surface Filling example.png

Two filled surfaces delimited by four edges located on the XY plane. The surface on the right is additionally controlled by a non-boundary edge.

Kako koristiti

  1. Press the Surface Filling.svg Filling button.
  2. The Boundaries task panel opens. See Options.
  3. Select two or more edges in the 3D view:
    • There is no need to press the Add edge button in the Boundaries section at this time.
    • The edges must be selected in consecutive order.
    • The edges must be connected, but the complete boundary need not be closed.
    • The complete boundary should not self-intersect.
    • For a 360° circular boundary two semicircular edges can be selected.
  4. A preview of the final shape will be shown once enough valid geometry has been selected.
  5. Optionally select a Support surface. See Example.
  6. Optionally select one or more Edge constraints.
  7. Optionally select one or more Vertex constraints.
  8. Press OK button.


  • In the Boundaries section a support surface and boundary edges can specified:
    • Press the Support surface button and select a face in the 3D view to add a support surface.
      • Click the Edit-cleartext.svg icon to remove the support surface.
    • Press the Add edge button once to start selecting boundary edges in the 3D view.
    • There are several ways to deselect boundary edges:
      • Press the Remove edge button once to start deselecting edges in the 3D view.
      • Select an edge in the list and press Delete.
      • Right-click an edge in the list and select Remove from the context menu.
  • In the Edge constraints section non-boundary edges can be specified:
    • The selection options are similar to those for boundary edges.
  • In the Vertex constraints section non-boundary vertices can be specified:
    • The selection options are similar to those for boundary edges.
  • Press Esc or the Cancel button to abort the operation.


The Support surface acts as an additional constraint for the surface. The following simple example will give you an idea how this works:

  1. In the Workbench Part.svg Part Workbench create a Part Cylinder.svgcylinder and set its PodaciAngle to 180°.
  2. Switch to the Workbench Surface.svg Surface Workbench and press the Surface Filling.svg Filling button.
  3. Select the two semi-circular edges and the two straight edges that connect them.
  4. The result matches the four boundary edges, but the inner shape is quite different from the cylindrical face.
  5. Edit the Surface object and for the Support surface select the cylindrical face.
  6. The modified shape matches the cylindrical face much more closely.


A Surface Filling (Surface::Filling class) is derived from the basic Part Feature (Part::Feature class, through the Part::Spline subclass), therefore it shares all the latter's properties.

In addition to the properties described in Part Feature, the Surface Filling has the following properties in the property editor.



  • PodaciBoundary Edges (LinkSubList): boundary edges; C0 is required for edges without a corresponding face.
  • PodaciBoundary Faces (StringList):
  • PodaciBoundary Order (IntegerList): order of constraint on boundary faces; 0, 1, and 2 are possible.
  • PodaciUnbound Edges (LinkSubList): unbound constraint edges; C0 is required for edges without a corresponding face.
  • PodaciUnbound Faces (StringList):
  • PodaciUnbound Order (IntegerList): order of constraint on unbound faces; 0, 1, and 2 are possible.
  • PodaciFree Faces (LinkSubList): free constraint on a face.
  • PodaciFree Order (IntegerList): order of constraint on free faces.
  • PodaciPoints (LinkSubList): constraint points on surface.
  • PodaciInitial Face (LinkSub): initial surface to use.
  • PodaciDegree (Integer): starting degree, it defaults to 3.
  • PodaciPoints On Curve (Integer): number of points on an edge for constraint.
  • PodaciIterations (Integer): number of iterations, it defaults to 2.
  • PodaciAnisotropy (Bool): it defaults to false.
  • PodaciTolerance2d (Float): 2D tolerance, it defaults to 0.0.
  • PodaciTolerance3d (Float): 3D tolerance, it defaults to 0.0.
  • PodaciTol Angular (Float): G1 tolerance, it defaults to 0.01.
  • PodaciTol Curvature (Float): G2 tolerance, it defaults to 0.10.
  • PodaciMaximum Degree (Integer): maximum curve degree, it defaults to 8.
  • PodaciMaximum Segments (Integer): maximum number of segments, it defaults to 9.



  • PregledControl Points (Bool): it defaults to false; if set to true, it will show an overlay with the control points of the surface.


See also: FreeCAD Scripting Basics.

The Surface Filling tool can be used in macros and from the Python console by adding the Surface::Filling object.

  • The edges to be used to define the surface must be assigned as a LinkSubList to the BoundaryEdges property of the object.
  • Auxiliary edges and vertices must be assigned as a LinkSubLists to the UnboundEdges and Points properties of the object.
  • All objects with edges need to be computed before they can be used as input for the properties of the Filling object.
import FreeCAD as App
import Draft

doc = App.newDocument()

a = App.Vector(-20, -20, 0)
b = App.Vector(-18, 25, 0)
c = App.Vector(60, 26, 0)
d = App.Vector(33, -20, 0)

points1 = [a, App.Vector(-20, -8, 0), App.Vector(-17, 7, 0), b]
obj1 = Draft.make_bspline(points1)

points2 = [b, App.Vector(0, 25, 0), c]
obj2 = Draft.make_bspline(points2)

points3 = [c, App.Vector(37, 4, 0), d]
obj3 = Draft.make_bspline(points3)

points4 = [d, App.Vector(-2, -18, 0), a]
obj4 = Draft.make_bspline(points4)

surf = doc.addObject("Surface::Filling", "Surface")
surf.BoundaryEdges = [(obj1, "Edge1"),
                      (obj2, "Edge1"),
                      (obj3, "Edge1"),
                      (obj4, "Edge1")]

# ---------------------------------------------------------
points_spl = [App.Vector(-10, 0, 2),
              App.Vector(4, 0, 7),
              App.Vector(18, 0, -5),
              App.Vector(25, 0, 0),
              App.Vector(30, 0, 0)]
aux_edge = Draft.make_bspline(points_spl)

surf.UnboundEdges = [(aux_edge, "Edge1")]

# ---------------------------------------------------------
aux_v1 = Draft.make_line(App.Vector(-13, -12, 5),
                         App.Vector(-13, -12, -5))
aux_v2 = Draft.make_line(App.Vector(-3, 18, 5),
                         App.Vector(-3, 18, -5))

surf.Points = [(aux_v1, "Vertex2"),
               (aux_v2, "Vertex1")]