Surface ExtendFace
|
|
| Menu location |
|---|
| Surface → Extend Face |
| Workbenches |
| Surface |
| Default shortcut |
| None |
| Introduced in version |
| 0.17 |
| See also |
| None |
Description[edit | edit source]
The Surface ExtendFace tool extrapolates an existing face or surface at its boundaries with its local U and V parameters.
Left: original face. Right: extended face.
Usage[edit | edit source]
- Make sure you have an object that has faces. The object could be created with the
Surface Workbench but it could also be any other object, for example, created with
Part or
PartDesign.
- Select the face to extend by clicking on it on the 3D View.
- There are several ways to invoke the tool:
- Press the
Extend Face button.
- Select the Surface →
Extend Face option from the menu.
- Press the
Options[edit | edit source]
This command doesn't have any options. Either it works with the selection or not.
Properties[edit | edit source]
A Surface Extend object (Surface::Extend 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 Extend object has the following properties in the Property View.
Data[edit | edit source]
Base
- DataFace (
LinkSub): the subelement from an object that will be extended; it must be a face. - DataTolerance (
FloatConstraint): it defaults to0.1.
- DataExtend UNeg (
FloatConstraint): it defaults to0.05. The ratio of the local U parameter that will be extended in the negative direction. - DataExtend UPos (
FloatConstraint): it defaults to0.05. The ratio of the local U parameter that will be extended in the positive direction. - DataExtend USymetric (
Bool): it defaults totrue, in which case DataExtend UNeg and DataExtend UPos will have the same value.
- DataExtend VNeg (
FloatConstraint): it defaults to0.05. The ratio of the local V that will be extended in the negative direction. - DataExtend VPos (
FloatConstraint): it defaults to0.05. The ratio of the local V direction that will be extended in the positive direction. - DataExtend VSymetric (
Bool): it defaults totrue, in which case DataExtend VNeg and DataExtend VPos will have the same value.
- DataSampleU (
IntegerConstraint): it defaults to32. - DataSampleV (
IntegerConstraint): it defaults to32.
View[edit | edit source]
Base
- ViewControl Points (
Bool): it defaults tofalse; if set totrue, it will show an overlay with the control points of the surface.
Scripting[edit | edit source]
See also: FreeCAD Scripting Basics.
The Surface Extend tool can be used in macros and from the Python Console by adding the Surface::Extend object.
- The face to extend must be assigned as a LinkSub to the
Faceproperty of the object. It must contain only a single face.
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)
points = [a, App.Vector(-20, -8, 0), b, c,
App.Vector(37, 4, 0), d,
App.Vector(-2, -18, 0), a]
obj = Draft.make_bspline(points)
doc.recompute()
if App.GuiUp:
obj.ViewObject.Visibility = False
surf = doc.addObject("Surface::Filling", "Surface")
surf.BoundaryEdges = [(obj, "Edge1")]
doc.recompute()
# ---------------------------------------------------------
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)
doc.recompute()
surf.UnboundEdges = [(aux_edge, "Edge1")]
doc.recompute()
# ---------------------------------------------------------
surf_extended = doc.addObject("Surface::Extend", "Surface")
surf_extended.Face = [surf, "Face1"]
doc.recompute()
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub