triview 0.0.1__tar.gz

triview-0.0.1/PKG-INFO

@@ -0,0 +1,3 @@
+Metadata-Version: 2.4
+Name: triview
+Version: 0.0.1

triview-0.0.1/README.md

@@ -0,0 +1,107 @@
+# Triview
+A lightweight GUI-based Python library that renders .obj 3D models and polygon meshes entirely on the CPU without using a GPU or OpenGL. Built with Tkinter, it provides basic real-time 3D transformations, perspective projection, and interactive camera control.
+
+Standard Libraries used :- tkinter (GUI), math (Math Operations)
+
+## Features
+- CPU-based 3D rendering (no GPU required)
+- OBJ file loader (.obj support)
+- Perspective projection system
+- Camera movement (x, y, z)
+- Yaw and pitch rotation
+- Simple polygon mesh rendering
+- Lightweight and easy to embed into projects
+
+## API
+### Class 
+```python
+class TRIVIEW:
+```
+### Class Functions
+```python
+def initialize(self, window, bg, polygon_outline, polygon_fill, camera, zoom, yaw, pitch): # Initializes the Canvas for rendering
+def project_vertices(self, vertices): # Takes 3D points and returns 2D screen points
+def render_mesh(self, projected, faces): # Renders screen points as per faces
+def load_obj(self, name): # Loads an obj file and returns [vertices, faces]
+```
+
+## Example of a Rotating Cube
+```python
+import tkinter as tk
+import math
+from triview import TRIVIEW
+
+vertices = [
+    [-1, -1, -1],
+    [ 1, -1, -1],
+    [ 1,  1, -1],
+    [-1,  1, -1],
+    [-1, -1,  1],
+    [ 1, -1,  1],
+    [ 1,  1,  1],
+    [-1,  1,  1],
+]
+
+faces = [
+    [2, 1, 0], [3, 2, 0],
+    [6, 5, 4], [7, 6, 4],
+    [5, 1, 0], [4, 5, 0],
+    [7, 3, 2], [6, 7, 2],
+    [6, 2, 1], [5, 6, 1],
+    [7, 0, 3], [4, 7, 0],
+]
+
+def rotate_vertex(v, yaw, pitch):
+    x, y, z = v
+    x1 = x * math.cos(yaw) - z * math.sin(yaw)
+    z1 = x * math.sin(yaw) + z * math.cos(yaw)
+    y2 = y * math.cos(pitch) - z1 * math.sin(pitch)
+    z2 = y * math.sin(pitch) + z1 * math.cos(pitch)
+
+    return [x1, y2, z2]
+
+window = tk.Tk()
+window.geometry("600x500")
+window.title("TRIVIEW - Rotating Cube")
+
+tv = TRIVIEW()
+tv.initialize(
+    window=window,
+    bg="gray15",
+    polygon_outline="white",
+    polygon_fill="",
+    camera=[0, 0, -6],
+    zoom=500,
+    yaw=0,
+    pitch=0
+)
+
+angle = 0
+FPS = 60
+
+def update():
+    global angle
+
+    rotated = [
+        rotate_vertex(v, angle, angle * 0.5)
+        for v in vertices
+    ]
+
+    projected = tv.project_vertices(rotated)
+    tv.render_mesh(projected, faces)
+
+    angle += 0.02
+    window.after(int(1000/FPS), update)
+
+update()
+window.mainloop()
+```
+
+## Limitations
+- CPU-based rendering only → performance depends on system power
+- Best suited for low-poly models (under ~2500 faces)
+- No advanced lighting or shading (flat color only)
+- No clipping system yet (can cause distortion at extreme angles)
+
+## License
+MIT LICENSED @2026

triview-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

triview-0.0.1/setup.py

@@ -0,0 +1,17 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='triview',
+    version='0.0.1',
+    packages=find_packages(),
+    install_requires=[
+    ],
+    package_data={
+        "triview": ["models/*"],
+    },
+    entry_points={
+        "console_scripts": [
+            "triview = triview:main",
+        ],
+    },
+)

triview-0.0.1/triview/__init__.py

@@ -0,0 +1,2 @@
+# __init__.py
+from .triview import TRIVIEW

triview-0.0.1/triview/__main__.py

@@ -0,0 +1,89 @@
+# __main__.py
+import tkinter as tk
+from tkinter import messagebox
+from triview import TRIVIEW
+import os
+
+ask = messagebox.askyesno("Triview", f"Are You Sure You Want to Load teapot.obj ?\n This can be very Laggy\n")
+if not ask:
+    quit()
+    
+window = tk.Tk()
+window.geometry("600x500")
+window.resizable(False, False)
+window.title("Triview")
+render_frame = tk.Frame(window)
+render_frame.pack(side="top", expand = True, fill = "both")
+controls_frame = tk.Frame(window, height=20)
+controls_frame.pack(side="bottom", expand = True, fill = "x")
+controls_frame_left = tk.Frame(controls_frame)
+controls_frame_left.pack(side="left", expand = True, fill = "x")
+controls_frame_right = tk.Frame(controls_frame)
+controls_frame_right.pack(side="right", expand = True, fill = "x")
+tv = TRIVIEW()
+tv.initialize(render_frame, "gray20", "white", "gray20", [0,1.5,-15], 1000,0,0)
+BASE_DIR = os.path.dirname(__file__)
+path = os.path.join(BASE_DIR, "models", "teapot.obj")
+model = tv.load_obj(path)
+if model is None:
+    print("Error : Cannot Load Model")
+    quit()
+vertices, faces = model
+
+def change_x(amount):
+    tv.camera[0] += amount
+    projected = tv.project_vertices(vertices)
+    tv.render_mesh(projected, faces)
+
+def change_y(amount):
+    tv.camera[1] += amount
+    projected = tv.project_vertices(vertices)
+    tv.render_mesh(projected, faces)
+        
+def change_z(amount):
+    tv.camera[2] += amount
+    projected = tv.project_vertices(vertices)
+    tv.render_mesh(projected, faces)
+        
+def change_yaw(amount):
+    tv.yaw += amount
+    projected = tv.project_vertices(vertices)
+    tv.render_mesh(projected, faces)
+        
+def change_pitch(amount):
+    tv.pitch += amount
+    projected = tv.project_vertices(vertices)
+    tv.render_mesh(projected, faces)
+            
+window.update()  
+projected = tv.project_vertices(vertices)
+tv.render_mesh(projected, faces)
+
+tk.Label(controls_frame_left, text="W - Move Forward", font=('Arial', 15, "bold")).pack(anchor="w", padx=(40,0))
+tk.Label(controls_frame_left, text="A - Move Left", font=('Arial', 15, "bold")).pack(anchor="w", padx=(40,0))
+tk.Label(controls_frame_left, text="S - Move Backward", font=('Arial', 15, "bold")).pack(anchor="w", padx=(40,0))
+tk.Label(controls_frame_left, text="D - Move Right", font=('Arial', 15, "bold")).pack(anchor="w", padx=(40,0))
+
+tk.Label(controls_frame_right, text="Up - Move Neck up", font=('Arial', 15, "bold")).pack(anchor="w")
+tk.Label(controls_frame_right, text="Down - Move Neck down", font=('Arial', 15, "bold")).pack(anchor="w")
+tk.Label(controls_frame_right, text="Left - Move Neck Left", font=('Arial', 15, "bold")).pack(anchor="w")
+tk.Label(controls_frame_right, text="Right - Move Neck Right", font=('Arial', 15, "bold")).pack(anchor="w")
+
+window.bind("<space>", lambda e: change_y(0.1))
+window.bind("f",       lambda e: change_y(-0.1))
+
+window.bind("a",       lambda e: change_x(-0.1))
+window.bind("d",       lambda e: change_x(0.1))
+
+window.bind("w",       lambda e: change_z(0.1))
+window.bind("s",       lambda e: change_z(-0.1))
+        
+window.bind("<Up>", lambda e: change_pitch(0.01))
+window.bind("<Down>", lambda e: change_pitch(-0.01))
+
+window.bind("<Left>", lambda e: change_yaw(-0.01))
+window.bind("<Right>", lambda e: change_yaw(0.01))
+    
+window.bind("<Configure>", lambda e: tv.render_mesh(tv.project_vertices(vertices),faces))
+
+window.mainloop()