/openscad-py

Python OOP precompiler for OpenSCAD's language

Primary LanguagePythonMIT LicenseMIT

openscad-py

A Python OOP precompiler for OpenSCAD's language

OpenSCAD ( https://openscad.org/ ) uses a functional scripting language to define solid 3D CAD models. As such, it is a prefix language (modifiers go before the things they modify).

OpenSCADPy allows one to write OpenSCAD scripts using an object representation, which uses method calls to describe modifications. This way, modifications are written after the objects they modify in a postfix fashion, more closely resembling a procedural ordering of steps in the creation of the models. It also contains convenience functions to define a wider range of primitives, as well as some vector operations.

Example

Cube([1, 1, 2]).move([0, 0, 1]).render()

returns

translate(v=[0, 0, 1]) { cube(size=[1, 1, 2], center=false); }

Notable convenience functions

Usual computational geometry functions on the Point class that work in an arbitrary number of dimensions. Overloads for algebraic operators.

distance = (Point((0, 0, 1)) - Point((1, 0, 1))).length()
angle_between = Point((0, 0, 1) * 2).angle(Point((1, 0, 1)))

Cylinder.from_ends() constructs a cylinder between two given points in space

openscad_code = Cylinder.from_ends(radius=2, p1=(0, 0, 1), p2=(1, 0, 2)).render()

Polyhedron.tube() creates a tube-like or toroid polyhedron from a 2D array of points

PathTube creates a tube-like or toroid polyhedron from an arbitrary path

PathTube(
    points=[(0,0,0), (0,0,1), (1,0,2), (1,1,0), (0,.5,0)],
    radius=.2,
    fn=4
)

PathTube example

Polyhedron.render_stl() export a polyhedra into STL directly