Skip to content

3D modeling in Python, built for LLMs.

3.8 KB
Raw Blame
"""Every solid starts at z = 0, centred in x and y."""
import unittest

import sand3d as s3d
from harness import _object_digest, world
from test_regressions import shells
from test_solids import closed_volume

#: Each maker, called as a program would.
SOLIDS = {"box": lambda: s3d.box("s", 40, 30, 20), "cylinder": lambda: s3d.cylinder("s", 20, 30),
          "tube": lambda: s3d.tube("s", 30, 20, 10), "cone": lambda: s3d.cone("s", 30, 40),
          "frustum": lambda: s3d.cone("s", 30, 40, 10), "sphere": lambda: s3d.sphere("s", 30),
          "wedge": lambda: s3d.wedge("s", 40, 20, 30, 10), "torus": lambda: s3d.torus("s", 40, 6),
          "gear": lambda: s3d.gear("s", 20, 2, 10, bore=8), "dome": lambda: s3d.dome("s", 15, 3),
          "extrude": lambda: s3d.extrude("s", s3d.rect(40, 30), 20),
          "revolve": lambda: s3d.revolve("s", s3d.at(s3d.rect(5, 30), x=12.5, y=15)),
          "thread": lambda: s3d.thread("s", 10, 20, 1.5), "knurl": lambda: s3d.knurl("s", 20, 10)}
HEIGHTS = {"box": 20, "cylinder": 30, "tube": 10, "cone": 40, "frustum": 40, "sphere": 30, "wedge": 30, "torus": 6,
           "gear": 10, "dome": 3, "extrude": 20, "revolve": 30, "thread": 20, "knurl": 10}


def points(ob):
    return [world(ob) @ v.co for v in ob.data.vertices]


class Origin(unittest.TestCase):

    def setUp(self):
        s3d.empty_scene()

    def test_every_solid_starts_at_z_0_centred_in_x_and_y(self):
        for name, make in SOLIDS.items():
            co = points(make())
            with self.subTest(name):
                self.assertEqual((min(c.z for c in co), max(c.z for c in co)), (0, HEIGHTS[name]))
                if name != "thread":                    # a helix is not symmetric about its axis
                    self.assertAlmostEqual(sum(c.x for c in co) / len(co), 0, delta=1e-6)
                    self.assertAlmostEqual(sum(c.y for c in co) / len(co), 0, delta=1e-6)

    def test_a_box_is_the_extrusion_of_its_rectangle(self):
        """To the bit, names included: one origin for both ways of writing it."""
        pairs = [(s3d.box("b", 40, 30, 20), s3d.extrude("b", s3d.rect(40, 30), 20)),
                 (s3d.cylinder("c", 20, 30), s3d.extrude("c", s3d.circle(20), 30)),
                 (s3d.tube("t", 30, 20, 10), s3d.extrude("t", s3d.circle(30) - s3d.circle(20), 10))]
        for solid, extruded in pairs:
            with self.subTest(solid["s3d_name"]):
                self.assertEqual(_object_digest(solid), _object_digest(extruded))

    def test_both_centres_on_z_0(self):
        """`extrude(both=True)` is how a solid is centred on its plane, as box was before 1.0."""
        co = points(s3d.extrude("c", s3d.rect(40, 30), 20, both=True))
        self.assertEqual((min(c.z for c in co), max(c.z for c in co)), (-10, 10))

    def test_a_part_stands_on_a_face_without_anchor(self):
        plate = s3d.box("plate", 60, 40, 8)
        peg = s3d.at(s3d.cylinder("peg", 4, 10), on=plate.face("top"), x=5)
        self.assertEqual(min(c.z for c in points(peg)), 8)
        s3d.join(plate, peg)
        self.assertTrue(closed_volume(plate)[0])
        self.assertEqual(shells(plate), 1)

    def test_a_side_face_is_the_extrusions(self):
        """A face's frame has its origin where the parent's origin projects onto the face:
        on a side face, at z = 0, its foot — as on an extrusion. `.move(y=h / 2)` goes up
        to its middle (the face's Y is the world's Z on a side)."""
        box = s3d.box("b", 40, 30, 20)
        extruded = s3d.extrude("e", s3d.rect(40, 30), 20)
        for side in ("+X", "-X", "+Y", "-Y"):
            with self.subTest(side):
                self.assertEqual(box.face(side).matrix, extruded.face(side).matrix)
                self.assertEqual(box.face(side).origin.z, 0)
                self.assertEqual(box.face(side).move(y=10).origin.z, 10)


if __name__ == "__main__":
    unittest.main()