Curve Workbench Macro: Curve to Freehand B-Spline

This Macro takes a selected curve and creates a freehand b-spline which follows its edge.  The macro is the start of creating a freeCAD version of the tween curve in Rhino3D for the Curves workbench.  The first hurdle is to convert a selected curve to a freehand b-spline.  I have decided that I just need to use the curve as an initial guide, so I don't want to connect the new bspline to it, but just follow the curvature.  The next steps would be to apply this to a ISO curve surface, creating multiple freehand b-spline for each edge.





Unlisted Video: https://youtu.be/fycOs-0Oy8M

The way I have tackled this is to take the selected curve and discretize the edge.  If you search for the meaning of this word then you will find numerous explanations, most of which are complicated and far too in depth to understand for the non-mathematical minded (or the average mathematical minded!).  I have found this a lot during my research, when authors explaining mathematical terms, it seems that the material is often consciously or unconsciously explained from the view point of someone who's ether studied or is in the process of studying towards some kind of qualification or degree.  The best and most direct explanation I could find is:

"The process of dividing geometry into finite elements often to prepare for analysis."

And this is exactly what we want to do, divide up the curve into points and assign the 3D coordinates of those points or vertices to the same number control points for a editable b-spline and finally discarding the original curve as we don't need it anymore.

TODO's and Limitations:

- Calculate the numberOfControlPoints automatically depending on the length of curve. If there are not enough, then the freehand b-spline doesn't follow the curve exactly.
- Allow for multi selection to create multiple b-splines.

The final macro from my research is as follows:

from freecad.Curves import gordon_profile_FP as GP 

#increase the points if dealing with more curves
numberOfControlPoints = 6 

#Get edge from selected
edge = Gui.Selection.getSelectionEx()[0].SubObjects[0] 

#Create the control points to add to the data
pts = edge.discretize(Number=numberOfControlPoints) 
typ = [0] * numberOfControlPoints 

#Create the bspline. Name will be appended with a unique extension if already exists
fp = FreeCAD.ActiveDocument.addObject("Part::FeaturePython", "Freehand BSpline") 
GP.GordonProfileFP(fp, [], pts, typ) 
GP.GordonProfileVP(fp.ViewObject) 
fp.recompute() 
Gui.runCommand('Std_ToggleVisibility',0)

Resources:

Chris G the creator of FreeCAD Curves workbench has kindly passed on some documented code to show how the b-spline can be created via python:


from freecad.Curves import gordon_profile_FP as GP
sub = []
# If the Spline is snapped to other shapes
# add a link to these shapes. For example :
# sub = [(obj1, ("Edge1",)), (obj2, ("Face1",))]

# the interpolation points
pts = [FreeCAD.Vector(0, 0, 0), FreeCAD.Vector(5, 0, 0), FreeCAD.Vector(10, 0, 0)]

# the type of each point.
# 0 = free point
# 1 = point snapped to a shape of the sub list
# For example, typ = [1, 0, 1]
# means that the first point will snap to the fist shape of the sub list
# and the third point will snap to the second shape
typ = [0, 0, 0]

fp = FreeCAD.ActiveDocument.addObject("Part::FeaturePython", "Freehand BSpline")
GP.GordonProfileFP(fp, [], pts, typ)
GP.GordonProfileVP(fp.ViewObject)
fp.recompute()

Future Macros

Convert ISO Curve to Editable B-Splines (to come)

Convert ISO Curves to Editable Surface (to Come)

Comments

Post a Comment

Popular posts from this blog

Reference Images For Beginners FreeCAD: Exercise 5.1 & 5.2

Image
Welcome to the total beginners course to FreeCAD 0.20. In this is a two part lesson we will practice our tracing skill in the form of a mini project. Using the below reference photos we will create a more complex part which will consist of repeating features. We will utilise the symmetry tools to ease construction in both FreeCAD sketcher and Part Design workbench. This project work will help teach the fundamentals of freeCAD allowing a understanding of the basics but delivering this information via teaching you different workflows. In this tutorial we will be tracing photos imported into FreeCAD via the image workbench https://wiki.freecadweb.org/Image_Workbench The story of this tutorial The idea and first attempt at creating this tutorial was back in FreeCAD 0.18.  The physical part itself, well, I have no idea what really it is, it looks like something from some flat pack furniture (I believe it was left over from a kitchen fit that was done) and it ended up in my in-tray for som
Read more

Beginner FreeCAD Tutorial 14: Reference Document for Exercise 1

Image
This tutorial focuses on modelling a deck eye plate. These items are normally made of stainless steel with some kind of galvanised coating to stop corrosion. They are used in many industries but are most commonly found around boats, ships, sail lofts and docks where they play an important part in marine industry. Finding their use in many applications, they are often wall mounted acting as lashing points for mooring and for tying down sails or canopies. They can even be used for domestic use around the house and garden, for example to anchor ropes, cords and lines. So if your into 3D printing your finished creations, you can make use of the finished result.   Disclaimer : The strength of the part will depend on the internal structure, settings of the slicer and the material it has been printed on.  This will limit its application as failure of the part, damage to property and injury is a possibility.  These items are normally made of steel and are tested to take a maximum weight bef
Read more

FreeCAD For Beginners: CAD Thinking Part 1

Image
Learning how to turn real life objects into CAD Models. Using FreeCAD we explain at a beginner level how to break down a physical object into its primitive shapes to digitise it into a 3D model, with this episode we are looking at a multi-part assembly, modelling each piece individually. The series aims to open your eyes and mind giving you the ground skills to pick the correct profiles, geometry and workflow when it comes to modelling your parts. This is not just for FreeCAD but for all CAD packages out there. Part  1 ,  2 ,  3  and  4  have been released.  Part 5 will be coming soon. Part 1: Click here for video part 1 In this video we are dealing with the first part of our latch assembly. We start to break down the part into its primitives and understand how we can use two different profiles from two different planes together to build the part. We will then look at fillets and chamfers and the problems that may occur when filleting this model Part of the Learning FreeCAD for Beginne
Read more