piecad_viewer 1.0.0__tar.gz

piecad_viewer-1.0.0/.gitignore

@@ -0,0 +1,12 @@
+dist
+.vscode
+lib
+bin
+share
+lib64
+.benchmarks
+include
+__pycache__
+test.py
+pyvenv.cfg
+*.obj

piecad_viewer-1.0.0/LICENSE

@@ -0,0 +1,30 @@
+The bulk of the code is covered by this license:
+
+The MIT License (MIT)
+
+Copyright (c) 2025 Brian Sturgill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+----
+
+The file `piecad/_poly_point_isect.py` has it's own license (located at the top of the file).
+
+----
+
+Fonts are covered by a separate license, see the License files in piecad/fonts for details.

piecad_viewer-1.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.1
+Name: piecad_viewer
+Version: 1.0.0
+Summary: "Viewer for Easy as Pie" CAD (Piecad)
+Author-email: Brian Sturgill <codersnext@gmail.com>
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: pyglet == 1.5.31
+Requires-Dist: trimesh >= 1.26.4
+Requires-Dist: glooey >= 0.3.6
+Requires-Dist: scipy >= 1.15.2
+Project-URL: Home, https://github.com/briansturgill/Piecad-Viewer

piecad_viewer-1.0.0/README.md

@@ -0,0 +1,24 @@
+# Viewer for "Easy as Pie" CAD (Piecad)
+
+[Piecad](https://github.com/briansturgill/Piecad) is a CAD API used to construct 3D models in [Python](https://www.python.org).
+Its primary focus is the creation of models for 3D printing.
+
+To use Piecad-Viewer, run `piecad-viewer` and then use the `view` function in Piecad,  which works like a 3d `print` (also does 2D).
+Piecad-Viewer allows you to see the output from multiple `view` calls.
+
+Type `h` in the Piecad-Viewer window for a list of commands.
+
+To install:
+
+```sh
+pip install piecad_viewer
+
+# This will install the script:
+piecad_viewer
+
+```
+
+## CREDITS
+
+Piecad viewer is based on [trimesh](https://github.com/mikedh/trimesh)'s viewer, which in
+turn is based on version 1 of [pyglet](https://github.com/pyglet/pyglet).

piecad_viewer-1.0.0/piecad_viewer/__init__.py

@@ -0,0 +1,215 @@
+import pyglet
+from . import server
+from threading import Thread, Lock
+import json
+import numpy as np
+import trimesh
+from trimesh.viewer import windowed
+import os
+
+view_lock = Lock()
+
+
+def display_help():
+    from tkinter import Tk, Label
+
+    text_l = [
+        "",
+        "Key        Action",
+        "---------------------------------------------",
+        "a            Toggle axis.",
+        "c            Toggle culling.",
+        "f            Toggle fullscreen.",
+        "g            Toggle grid.",
+        "h, ? or ESC  View/dismiss this help.",
+        "q            Quit CAD Viewer.",
+        "w            Toggle wireframe.",
+        "z            Reset view.",
+        "LEFT         Move to the previous object.",
+        "RIGHT        Move to the next object.",
+        "SHIFT-m      Launch meshlab on current object.",
+        "SHIFT-LEFT   Rotate image left.",
+        "SHIFT-RIGHT  Rotate image right.",
+        "SHIFT-UP     Rotate image up.",
+        "SHIFT-DOWN   Rotate image down.",
+        "",
+    ]
+    longest = 0
+    for t in text_l:
+        if longest < len(t):
+            longest = len(t)
+    root = Tk()
+
+    def keydown(e):
+        ch = e.char
+        if ch == "h" or ch == "?" or ord(ch) == 27 or ord(ch) == 13:
+            root.destroy()
+
+    root.bind("<KeyPress>", keydown)
+
+    x = (longest) * 14
+    y = (len(text_l) + 10) * 14
+    root.geometry(f"{x}x{y}")
+    root.title("CAD Viewer Help")
+    text = Label(
+        root,
+        height=len(text_l),
+        justify="left",
+        text="\n".join(text_l),
+        font=("Courier", 14, "bold"),
+    )
+    text.pack(padx=10, pady=10)
+    root.mainloop()
+
+
+display_needed = False
+cur_idx = 0
+meshes = []
+titles = []
+
+
+class MySceneViewer(trimesh.viewer.windowed.SceneViewer):
+    def __init__(self, scene, **kwargs):
+        super().__init__(scene, **kwargs)
+
+    def on_key_press(self, symbol, modifiers):
+        global cur_idx, meshes, display_needed
+        ctrl = modifiers & pyglet.window.key.MOD_CTRL
+        shift = modifiers & pyglet.window.key.MOD_SHIFT
+        if symbol == pyglet.window.key.W:
+            self.toggle_wireframe()
+        elif symbol == pyglet.window.key.Z:
+            self.reset_view()
+        elif symbol == pyglet.window.key.C:
+            self.toggle_culling()
+        elif symbol == pyglet.window.key.A:
+            self.toggle_axis()
+        elif symbol == pyglet.window.key.G:
+            self.toggle_grid()
+        elif symbol == pyglet.window.key.Q:
+            self.on_close()
+        elif symbol == pyglet.window.key.M:
+            if shift:
+                tmpfile = (
+                    "/tmp/cadviewer_tmp.obj"  # LATER surely I can do better for temp?
+                )
+                saved = False
+                view_lock.acquire()
+                if len(meshes) > 0:
+                    trimesh.exchange.export.export_mesh(meshes[cur_idx], tmpfile, "obj")
+                    saved = True
+                view_lock.release()
+                if saved:
+                    os.system("meshlab " + tmpfile)
+            return  # Doesn't really work right, supress.
+        elif symbol == pyglet.window.key.F:
+            self.toggle_fullscreen()
+        elif symbol == pyglet.window.key.H or symbol == pyglet.window.key.QUESTION:
+            Thread(target=display_help, daemon=True).start()
+
+        if symbol in [
+            pyglet.window.key.LEFT,
+            pyglet.window.key.RIGHT,
+            pyglet.window.key.DOWN,
+            pyglet.window.key.UP,
+        ]:
+            if ctrl or shift:
+                super().on_key_press(symbol, modifiers)
+                return
+            mlen = len(meshes)
+            if symbol == pyglet.window.key.LEFT:
+                if mlen > 1:
+                    view_lock.acquire()
+                    cur_idx = (cur_idx - 1) % mlen
+                    display_needed = True
+                    view_lock.release()
+            elif symbol == pyglet.window.key.RIGHT:
+                if mlen > 1:
+                    view_lock.acquire()
+                    cur_idx = (cur_idx + 1) % mlen
+                    display_needed = True
+                    view_lock.release()
+            elif symbol == pyglet.window.key.DOWN:
+                pass
+            elif symbol == pyglet.window.key.UP:
+                pass
+
+
+def _queue_handler():
+    global display_needed, meshes, titles, cur_idx
+    while True:
+        data = server.viewQueue.get()
+        view_lock.acquire()
+        try:
+            obj = json.loads(data)
+            if "clear" in obj:
+                meshes = []
+                titles = []
+                display_needed = True
+                cur_idx = 0
+            else:
+                display_needed = True
+                vertices = np.array(obj["vertices"], np.float64)
+                faces = np.array(obj["faces"], np.int64)
+                mesh = trimesh.Trimesh(vertices, faces)
+                mesh.visual.vertex_colors = obj["color"]
+                meshes.append(mesh)
+                titles.append(obj["title"])
+                cur_idx = len(meshes) - 1
+        except Exception as err:
+            print("Exception:", err)
+            pass
+        view_lock.release()
+
+
+server.start_server()
+Thread(target=_queue_handler, daemon=True).start()
+
+
+window = None
+
+cur_mesh = None
+
+
+def cb(scene: trimesh.Scene):
+    global display_needed, meshes, titles, cur_mesh, window
+    changed = False
+    view_lock.acquire()
+    if display_needed:
+        scene.delete_geometry(cur_mesh)
+        if len(meshes) > 0:
+            window.set_caption(
+                f"CAD Viewer - #{cur_idx+1} of {len(meshes)} - {titles[cur_idx]}"
+            )
+            mesh = meshes[cur_idx]
+            scene2 = trimesh.Scene(mesh)
+            window._initial_camera_transform = scene2.camera_transform
+            scene = window.scene = window._scene = scene2
+            cur_mesh = scene.add_geometry(mesh)
+            window.reset_view()
+            # window.view["ball"].scroll(-(mesh.bounds[1,1]-mesh.bounds[0,1])*0.2)
+            # window.scene.camera_transform = window.view["ball"].pose
+        else:
+            window.set_caption(f"CAD Viewer - #0 of 0")
+        changed = True
+        display_needed = False
+    view_lock.release()
+    return changed
+
+
+def main():
+    global cur_mesh, window
+    scene = trimesh.Scene()
+    cur_mesh = scene.add_geometry(trimesh.creation.box((100, 100, 100)))
+    window = MySceneViewer(
+        scene,
+        callback=cb,
+        callback_period=1.0,
+        start_loop=False,
+        background=(173, 216, 230, 255),
+        smooth=False,
+    )
+    scene.delete_geometry(cur_mesh)
+    window.set_caption(f"CAD Viewer - #0 of 0")
+
+    pyglet.app.run()

piecad_viewer-1.0.0/piecad_viewer/server.py

@@ -0,0 +1,47 @@
+from http.server import ThreadingHTTPServer, BaseHTTPRequestHandler
+from threading import Thread
+from queue import Queue
+
+addr = "127.0.0.1"
+port = 8037
+
+viewQueue = Queue()
+
+
+class CADViewerHandler(BaseHTTPRequestHandler):
+    def do_POST(self):
+        len = int(self.headers["Content-Length"])
+        print("Content-Length:", len)
+        data = self.rfile.read(len)
+        self.send_response(200)
+        self.end_headers()
+        try:
+            self.wfile.write(bytes("got it", "utf-8"))
+        except:
+            print("Exception writing response")
+            pass
+        viewQueue.put(data)
+
+
+def start_server():
+    Thread(target=_start_server, daemon=True).start()
+
+
+def _start_server():
+    print("Viewer server started on (", addr, port, ")")
+    httpd = ThreadingHTTPServer((addr, port), CADViewerHandler)
+    try:
+        httpd.serve_forever()
+    except KeyboardInterrupt:
+        pass
+    httpd.server_close()
+
+
+if __name__ == "__main__":
+    start_server()
+    print("^C to exit.")
+    while True:
+        try:
+            input("")
+        except KeyboardInterrupt:
+            break

piecad_viewer-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "piecad_viewer"
+description = '"Viewer for Easy as Pie" CAD (Piecad)'
+version = "1.0.0"
+authors = [{name = "Brian Sturgill", email = "codersnext@gmail.com"}]
+license = {file = "LICENSE"}
+classifiers = ["License :: OSI Approved :: MIT License"]
+dependencies = [
+    "pyglet == 1.5.31",
+    "trimesh >= 1.26.4",
+		"glooey >= 0.3.6",
+		"scipy >= 1.15.2"
+]
+
+[project.scripts]
+piecad-viewer = "piecad_viewer:main"
+
+[project.urls]
+Home = "https://github.com/briansturgill/Piecad-Viewer"
+
+[tool.flit.sdist]
+include = []
+exclude = []

piecad_viewer-1.0.0/setup

@@ -0,0 +1,6 @@
+rm -rf lib lib64 include bin share pyvenv.cfg __pycache__
+/usr/bin/python -m venv .
+. bin/activate
+pip install trimesh 'pyglet<2' glooey scipy 
+#sudo apt install libglu1-mesa python3-tk
+git checkout .gitignore