DistanceBolt.py

Go to the documentation of this file.

"""
An example for a high-level cutsom feature object to form a full-parametric distance bolt.

***************************************************************************
*   Copyright (c) 2010 Werner Mayer <wmayer[at]users.sourceforge.net>     *
*                                                                         *
*   This file is part of the FreeCAD CAx development system.              *
*                                                                         *
*   This program is free software; you can redistribute it and/or modify  *
*   it under the terms of the GNU General Public License (GPL)            *
*   as published by the Free Software Foundation; either version 2 of     *
*   the License, or (at your option) any later version.                   *
*   for detail see the LICENCE text file.                                 *
*                                                                         *
*   FreeCAD is distributed in the hope that it will be useful,            *
*   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
*   GNU Library General Public License for more details.                  *
*                                                                         *
*   You should have received a copy of the GNU Library General Public     *
*   License along with FreeCAD; if not, write to the Free Software        *
*   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
*   USA                                                                   *
*                                                                         *
***************************************************************************
"""

__author__ = "Werner Mayer <wmayer@users.sourceforge.net>"

import FreeCAD, Part, math
from FreeCAD import Base

class DistanceBolt:
        def __init__(self, obj):
                ''' Add the properties: Length, Edges, Radius, Height '''
                obj.addProperty("App::PropertyInteger","Edges","Bolt","Number of edges of the outline").Edges=6
                obj.addProperty("App::PropertyLength","Length","Bolt","Length of the edges of the outline").Length=10.0
                obj.addProperty("App::PropertyLength","Radius","Bolt","Radius of the inner circle").Radius=4.0
                obj.addProperty("App::PropertyLength","Height","Bolt","Height of the extrusion").Height=20.0
                obj.Proxy = self

        def onChanged(self, fp, prop):
                if prop == "Edges" or prop == "Length" or prop == "Radius" or prop == "Height":
                        self.execute(fp)

        def execute(self, fp):
                edges = fp.Edges
                if edges < 3:
                        edges = 3
                length = fp.Length
                radius = fp.Radius
                height = fp.Height

                m=Base.Matrix()
                m.rotateZ(math.radians(360.0/edges))

                # create polygon
                polygon = []
                v=Base.Vector(length,0,0)
                for i in range(edges):
                        polygon.append(v)
                        v = m.multiply(v)
                polygon.append(v)
                wire = Part.makePolygon(polygon)

                # create circle
                circ=Part.makeCircle(radius)

                # Create the face with the polygon as outline and the circle as hole
                face=Part.Face([wire,Part.Wire(circ)])

                # Extrude in z to create the final solid
                extrude=face.extrude(Base.Vector(0,0,height))
                fp.Shape = extrude

def makeDistanceBolt():
        doc = FreeCAD.activeDocument()
        if doc == None:
                doc = FreeCAD.newDocument()
        bolt=doc.addObject("Part::FeaturePython","Distance_Bolt")
        bolt.Label = "Distance bolt"
        DistanceBolt(bolt)
        bolt.ViewObject.Proxy=0