bumo 0.1.1

BUild123d Mutables Objects

Bumo

BUild123d Mutables Objects

An experimental package used to manage Build123d objects by applying mutations on them.

It can be used:

• just out of curiosity, because it's just a new way to build things;
• as a debug tool, using colors and debug mode;
• as a higher-level interface for Build123d;
• as a more object-oriented approach to build CAD parts.

Installation

poetry install bumo

or using pip:

pip install bumo

Getting started

Bumo is not a cad library on its own and does not aim to replace Build123d, you should take a look at the Build123d docs before using it.

Note: In the following examples we will use ocp vscode, but any other viewer should work.

Instantiating the builder

First things first, let's instanciate a Bumo builder and pass a Build123d part into it. Note that we must call the object (obj()) when passing it to the show function.

import build123d as _
from ocp_vscode import show_object
from bumo import Builder

obj = Builder(_.Box(12, 12, 2))

show_object(obj())

Adding mutations

When applying an operation, instead of returning a copy of the modified object, the builder mutates the object:

obj = Builder(_.Box(12, 12, 2))
obj.add(_.Box(8, 8, 4))
obj.sub(_.Cylinder(3, 4))

Adding colors

On each mutation you can pass a color, because coloring object faces is useful and funny:

obj = Builder(_.Box(12, 12, 2), "orange")
obj.add(_.Box(8, 8, 4), "green")
obj.sub(_.Cylinder(3, 4), "violet")

Moving objects

You can move objects with move(), all colors will be preserved. Note that you can still use the Build123d * operator before passing the object to the builder.

obj = Builder(_.Box(12, 12, 2), "orange")
obj.add(_.Box(8, 8, 4), "green")
obj.move(_.Location([-5, 2, 0]))
obj.sub(_.Rotation(25, 25, 0) * _.Cylinder(2.5, 10), "violet")

Reusing mutations

Instead of returning a copy of the object, mutations return a Mutation object that can be used to retrieve the altered faces and edges. Mutations can also be accessed by querrying a builder index (ie. obj[n]). This is useful with fillets and chamfers:

obj = Builder(_.Box(12, 12, 2), "orange")
obj.add(_.Box(8, 8, 4), "green")
obj.fillet(obj[-1].edges_added(), 0.4, color="yellow")
hole = obj.sub(_.Cylinder(3, 4), "violet")
obj.chamfer(hole.edges_added()[0], 0.3, color="blue")

Using the debug mode

You can turn one or several mutations in debug mode, so all the other faces will be translucent. Either by passing a debug attribute to mutations, or passing faces to the debug method:

obj = Builder(_.Box(12, 12, 2), "orange")
obj.add(_.Box(8, 8, 4), "green")
obj.fillet(obj[-1].edges_added(), 0.4, color="yellow")
obj.debug(obj[-1].faces_altered()[0], "red")
hole = obj.sub(_.Cylinder(3, 4), "violet")
obj.chamfer(hole.edges_added()[0], 0.3, color="blue", debug=True)

Configuring the builder

You can set builder attributes if necessary:

Builder.default_color = "grey"
Builder.debug_alpha = 0.5