craphics 0.0.1__tar.gz

craphics-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moinak Debnath
+
+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.

craphics-0.0.1/PKG-INFO

@@ -0,0 +1,340 @@
+Metadata-Version: 2.4
+Name: craphics
+Version: 0.0.1
+Summary: A small Python Library for CPU - rendered graphics
+Author: Moinak Debnath
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/findstring/craphics
+Project-URL: Repository, https://github.com/findstring/craphics
+Project-URL: Issues, https://github.com/findstring/craphics/issues
+Keywords: graphics,cpu,rendering,tkinter,math
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Craphics
+
+A small and lightweight Python 3D graphics module built using Python's standard libraries **`tkinter`**, **`math`**, and **`time`**.
+
+Craphics provides basic 3D rendering with perspective projection, camera movement, mouse-controlled rotation, triangle rendering, and `.obj` model loading.
+
+> **Version:** `v0.0.1`
+
+## Features
+
+* 🖥️ Tkinter-based rendering
+* 📐 Basic 3D perspective projection
+* 🎥 Movable camera
+* 🖱️ Mouse-controlled camera rotation
+* 🔺 Triangle-based object rendering
+* 📦 Wavefront `.obj` file loading
+* 👁️ Near and far rendering planes
+* 🎨 Custom object fill and outline colors
+* 📊 Optional rendering logs
+* ⚙️ Configurable FPS and mouse sensitivity
+* 📚 Uses only Python standard libraries
+
+## Installation
+
+Install Craphics using `pip`:
+
+```bash
+pip install craphics
+```
+
+## Requirements
+
+Craphics is built using Python's standard library:
+
+* `tkinter`
+* `math`
+* `time`
+
+No additional Python dependencies are required.
+
+> **Note:** Your Python installation must have Tkinter available.
+
+## Quick Start
+
+```python
+import tkinter as tk
+from craphics import CRAPHICS
+
+window = tk.Tk()
+window.title("Craphics Demo")
+window.geometry("800x600")
+
+graphics = CRAPHICS(
+    window=window,
+    BG="black",
+    FOCAL_LENGTH=500,
+    CAMERA_DISTANCE=5,
+    RENDER_DISTANCE=1000,
+    SENSITIVITY=0.005,
+    FPS=60,
+    LOG=True
+)
+
+window.mainloop()
+```
+
+## Controls
+
+| Key / Input  | Action               |
+| ------------ | -------------------- |
+| `W`          | Move camera forward  |
+| `S`          | Move camera backward |
+| `A`          | Move camera left     |
+| `D`          | Move camera right    |
+| `Space`      | Move camera upward   |
+| `Left Shift` | Move camera downward |
+| Mouse        | Rotate camera        |
+
+The mouse cursor is hidden while using the Craphics canvas.
+
+## API
+
+### `CRAPHICS()`
+
+Creates a Craphics renderer inside the supplied Tkinter window.
+
+```python
+CRAPHICS(
+    window,
+    BG,
+    FOCAL_LENGTH,
+    CAMERA_DISTANCE,
+    RENDER_DISTANCE,
+    SENSITIVITY,
+    FPS,
+    LOG
+)
+```
+
+### Arguments
+
+| Argument          | Description                                                       |
+| ----------------- | ----------------------------------------------------------------- |
+| `window`          | Tkinter parent window in which the rendering canvas is created    |
+| `BG`              | Background color of the rendering canvas                          |
+| `FOCAL_LENGTH`    | Focal length used for perspective projection. Must not be `0`     |
+| `CAMERA_DISTANCE` | Initial distance of the camera along the Z axis. Must not be `0`  |
+| `RENDER_DISTANCE` | Maximum distance from the camera at which objects can be rendered |
+| `SENSITIVITY`     | Mouse rotation sensitivity                                        |
+| `FPS`             | Target rendering frames per second. Must be greater than `0`      |
+| `LOG`             | If `True`, prints rendering information to the console            |
+
+## Adding Objects
+
+### `add_object()`
+
+Adds a triangle-based 3D object to the scene.
+
+```python
+graphics.add_object(
+    name,
+    fill,
+    outline,
+    polygons
+)
+```
+
+### Arguments
+
+| Argument   | Description                               |
+| ---------- | ----------------------------------------- |
+| `name`     | Unique name used to identify the object   |
+| `fill`     | Fill color of the object's triangles      |
+| `outline`  | Outline color of the object's triangles   |
+| `polygons` | List of triangles that make up the object |
+
+Each triangle consists of three 3D vertices:
+
+```python
+polygons = [
+    [
+        [x1, y1, z1],
+        [x2, y2, z2],
+        [x3, y3, z3]
+    ]
+]
+```
+
+For example:
+
+```python
+triangle = [
+    [
+        [-1, -1, 0],
+        [1, -1, 0],
+        [0, 1, 0]
+    ]
+]
+
+graphics.add_object(
+    "Triangle",
+    "red",
+    "white",
+    triangle
+)
+```
+
+## Removing Objects
+
+### `remove_object()`
+
+Removes an object from the scene using its name.
+
+```python
+graphics.remove_object("Triangle")
+```
+
+## Loading `.obj` Models
+
+### `add_objfile()`
+
+Craphics can load geometry from a Wavefront `.obj` file.
+
+```python
+graphics.add_objfile(
+    name,
+    fill,
+    outline,
+    file
+)
+```
+
+### Arguments
+
+| Argument  | Description                      |
+| --------- | -------------------------------- |
+| `name`    | Name used to identify the object |
+| `fill`    | Fill color of the model          |
+| `outline` | Outline color of the model       |
+| `file`    | Path to the `.obj` file          |
+
+Example:
+
+```python
+graphics.add_objfile(
+    "Cube",
+    "blue",
+    "white",
+    "cube.obj"
+)
+```
+
+### `.obj` Support
+
+The current `.obj` loader supports:
+
+* Vertex definitions (`v`)
+* Triangle faces (`f`)
+* Vertex/texture/normal face formats such as `f 1/1/1 2/2/2 3/3/3`
+* Comments (`#`)
+* Vertex normals (`vn`) are ignored
+
+The current implementation expects faces to contain **three vertices**, meaning models should use triangular faces.
+
+## Rendering
+
+Craphics uses a basic perspective projection:
+
+```text
+screen_x = FOCAL_LENGTH × x / z
+screen_y = FOCAL_LENGTH × y / z
+```
+
+Objects are transformed according to the camera's:
+
+* Position
+* Yaw
+* Pitch
+
+Triangles outside the near and far clipping planes are skipped.
+
+The renderer also performs basic back-face culling, so triangles facing away from the camera are not rendered.
+
+## Camera
+
+The camera starts at:
+
+```python
+CAMERA_X = 0
+CAMERA_Y = 0
+CAMERA_Z = CAMERA_DISTANCE
+```
+
+Camera movement is controlled using the keyboard, while yaw and pitch are controlled by mouse movement.
+
+### Camera Parameters
+
+| Parameter         | Description                                        |
+| ----------------- | -------------------------------------------------- |
+| `CAMERA_DISTANCE` | Initial Z position of the camera                   |
+| `SENSITIVITY`     | Amount of camera rotation caused by mouse movement |
+| `RENDER_DISTANCE` | Maximum rendering range                            |
+
+## Rendering Logs
+
+Set `LOG=True` to display rendering information:
+
+```python
+graphics = CRAPHICS(
+    window,
+    "black",
+    500,
+    5,
+    1000,
+    0.005,
+    60,
+    True
+)
+```
+
+The console will display information such as:
+
+```text
+[CRAPHICS] Added Object : Cube
+[CRAPHICS] Rendered 1 objects | Render time: 2.31 ms | Render FPS: 432.9 | Target FPS: 60
+```
+
+Set `LOG=False` to disable these messages.
+
+## Limitations
+
+Craphics is currently intended to be a **simple and experimental 3D renderer**, rather than a full 3D engine.
+
+Current limitations include:
+
+* Triangle-based rendering
+* `.obj` faces should be triangles
+* No textures
+* No lighting system
+* No materials
+* No shadows
+* No perspective-correct texture mapping
+* Basic back-face culling
+* CPU-based rendering through Tkinter
+* Performance decreases with complex models
+
+## Version
+
+**Craphics v0.0.1**
+
+This is an early version of the project and the API may change in future releases.
+
+## License
+
+**MIT License © 2026**
+
+See the `LICENSE` file for the full license text.
+
+---
+
+Made with Python 🐍 and Tkinter.

craphics-0.0.1/README.md

@@ -0,0 +1,321 @@
+# Craphics
+
+A small and lightweight Python 3D graphics module built using Python's standard libraries **`tkinter`**, **`math`**, and **`time`**.
+
+Craphics provides basic 3D rendering with perspective projection, camera movement, mouse-controlled rotation, triangle rendering, and `.obj` model loading.
+
+> **Version:** `v0.0.1`
+
+## Features
+
+* 🖥️ Tkinter-based rendering
+* 📐 Basic 3D perspective projection
+* 🎥 Movable camera
+* 🖱️ Mouse-controlled camera rotation
+* 🔺 Triangle-based object rendering
+* 📦 Wavefront `.obj` file loading
+* 👁️ Near and far rendering planes
+* 🎨 Custom object fill and outline colors
+* 📊 Optional rendering logs
+* ⚙️ Configurable FPS and mouse sensitivity
+* 📚 Uses only Python standard libraries
+
+## Installation
+
+Install Craphics using `pip`:
+
+```bash
+pip install craphics
+```
+
+## Requirements
+
+Craphics is built using Python's standard library:
+
+* `tkinter`
+* `math`
+* `time`
+
+No additional Python dependencies are required.
+
+> **Note:** Your Python installation must have Tkinter available.
+
+## Quick Start
+
+```python
+import tkinter as tk
+from craphics import CRAPHICS
+
+window = tk.Tk()
+window.title("Craphics Demo")
+window.geometry("800x600")
+
+graphics = CRAPHICS(
+    window=window,
+    BG="black",
+    FOCAL_LENGTH=500,
+    CAMERA_DISTANCE=5,
+    RENDER_DISTANCE=1000,
+    SENSITIVITY=0.005,
+    FPS=60,
+    LOG=True
+)
+
+window.mainloop()
+```
+
+## Controls
+
+| Key / Input  | Action               |
+| ------------ | -------------------- |
+| `W`          | Move camera forward  |
+| `S`          | Move camera backward |
+| `A`          | Move camera left     |
+| `D`          | Move camera right    |
+| `Space`      | Move camera upward   |
+| `Left Shift` | Move camera downward |
+| Mouse        | Rotate camera        |
+
+The mouse cursor is hidden while using the Craphics canvas.
+
+## API
+
+### `CRAPHICS()`
+
+Creates a Craphics renderer inside the supplied Tkinter window.
+
+```python
+CRAPHICS(
+    window,
+    BG,
+    FOCAL_LENGTH,
+    CAMERA_DISTANCE,
+    RENDER_DISTANCE,
+    SENSITIVITY,
+    FPS,
+    LOG
+)
+```
+
+### Arguments
+
+| Argument          | Description                                                       |
+| ----------------- | ----------------------------------------------------------------- |
+| `window`          | Tkinter parent window in which the rendering canvas is created    |
+| `BG`              | Background color of the rendering canvas                          |
+| `FOCAL_LENGTH`    | Focal length used for perspective projection. Must not be `0`     |
+| `CAMERA_DISTANCE` | Initial distance of the camera along the Z axis. Must not be `0`  |
+| `RENDER_DISTANCE` | Maximum distance from the camera at which objects can be rendered |
+| `SENSITIVITY`     | Mouse rotation sensitivity                                        |
+| `FPS`             | Target rendering frames per second. Must be greater than `0`      |
+| `LOG`             | If `True`, prints rendering information to the console            |
+
+## Adding Objects
+
+### `add_object()`
+
+Adds a triangle-based 3D object to the scene.
+
+```python
+graphics.add_object(
+    name,
+    fill,
+    outline,
+    polygons
+)
+```
+
+### Arguments
+
+| Argument   | Description                               |
+| ---------- | ----------------------------------------- |
+| `name`     | Unique name used to identify the object   |
+| `fill`     | Fill color of the object's triangles      |
+| `outline`  | Outline color of the object's triangles   |
+| `polygons` | List of triangles that make up the object |
+
+Each triangle consists of three 3D vertices:
+
+```python
+polygons = [
+    [
+        [x1, y1, z1],
+        [x2, y2, z2],
+        [x3, y3, z3]
+    ]
+]
+```
+
+For example:
+
+```python
+triangle = [
+    [
+        [-1, -1, 0],
+        [1, -1, 0],
+        [0, 1, 0]
+    ]
+]
+
+graphics.add_object(
+    "Triangle",
+    "red",
+    "white",
+    triangle
+)
+```
+
+## Removing Objects
+
+### `remove_object()`
+
+Removes an object from the scene using its name.
+
+```python
+graphics.remove_object("Triangle")
+```
+
+## Loading `.obj` Models
+
+### `add_objfile()`
+
+Craphics can load geometry from a Wavefront `.obj` file.
+
+```python
+graphics.add_objfile(
+    name,
+    fill,
+    outline,
+    file
+)
+```
+
+### Arguments
+
+| Argument  | Description                      |
+| --------- | -------------------------------- |
+| `name`    | Name used to identify the object |
+| `fill`    | Fill color of the model          |
+| `outline` | Outline color of the model       |
+| `file`    | Path to the `.obj` file          |
+
+Example:
+
+```python
+graphics.add_objfile(
+    "Cube",
+    "blue",
+    "white",
+    "cube.obj"
+)
+```
+
+### `.obj` Support
+
+The current `.obj` loader supports:
+
+* Vertex definitions (`v`)
+* Triangle faces (`f`)
+* Vertex/texture/normal face formats such as `f 1/1/1 2/2/2 3/3/3`
+* Comments (`#`)
+* Vertex normals (`vn`) are ignored
+
+The current implementation expects faces to contain **three vertices**, meaning models should use triangular faces.
+
+## Rendering
+
+Craphics uses a basic perspective projection:
+
+```text
+screen_x = FOCAL_LENGTH × x / z
+screen_y = FOCAL_LENGTH × y / z
+```
+
+Objects are transformed according to the camera's:
+
+* Position
+* Yaw
+* Pitch
+
+Triangles outside the near and far clipping planes are skipped.
+
+The renderer also performs basic back-face culling, so triangles facing away from the camera are not rendered.
+
+## Camera
+
+The camera starts at:
+
+```python
+CAMERA_X = 0
+CAMERA_Y = 0
+CAMERA_Z = CAMERA_DISTANCE
+```
+
+Camera movement is controlled using the keyboard, while yaw and pitch are controlled by mouse movement.
+
+### Camera Parameters
+
+| Parameter         | Description                                        |
+| ----------------- | -------------------------------------------------- |
+| `CAMERA_DISTANCE` | Initial Z position of the camera                   |
+| `SENSITIVITY`     | Amount of camera rotation caused by mouse movement |
+| `RENDER_DISTANCE` | Maximum rendering range                            |
+
+## Rendering Logs
+
+Set `LOG=True` to display rendering information:
+
+```python
+graphics = CRAPHICS(
+    window,
+    "black",
+    500,
+    5,
+    1000,
+    0.005,
+    60,
+    True
+)
+```
+
+The console will display information such as:
+
+```text
+[CRAPHICS] Added Object : Cube
+[CRAPHICS] Rendered 1 objects | Render time: 2.31 ms | Render FPS: 432.9 | Target FPS: 60
+```
+
+Set `LOG=False` to disable these messages.
+
+## Limitations
+
+Craphics is currently intended to be a **simple and experimental 3D renderer**, rather than a full 3D engine.
+
+Current limitations include:
+
+* Triangle-based rendering
+* `.obj` faces should be triangles
+* No textures
+* No lighting system
+* No materials
+* No shadows
+* No perspective-correct texture mapping
+* Basic back-face culling
+* CPU-based rendering through Tkinter
+* Performance decreases with complex models
+
+## Version
+
+**Craphics v0.0.1**
+
+This is an early version of the project and the API may change in future releases.
+
+## License
+
+**MIT License © 2026**
+
+See the `LICENSE` file for the full license text.
+
+---
+
+Made with Python 🐍 and Tkinter.

craphics-0.0.1/craphics/__init__.py

@@ -0,0 +1 @@
+from .craphics import *

craphics-0.0.1/craphics/craphics.py

@@ -0,0 +1,202 @@
+import tkinter as tk
+import math
+import time
+
+CRAPHICS_VERSION = "0.0.1"
+
+class CRAPHICS:
+    def __init__(self, window, BG, FOCAL_LENGTH, CAMERA_DISTANCE, RENDER_DISTANCE, SENSITIVITY, FPS, LOG):
+        self.LOG = LOG
+        self.FPS = FPS
+        self.last_mouse_x = None
+        self.last_mouse_y = None
+        self.SENSITIVITY = SENSITIVITY
+        self.YAW = 0
+        self.PITCH = 0
+        self.NEAR_PLANE = 0.1
+        self.FAR_PLANE = self.NEAR_PLANE + RENDER_DISTANCE
+        self.RENDER_DISTANCE = RENDER_DISTANCE
+        self.CAMERA_X = 0
+        self.CAMERA_Y = 0
+        self.FOCAL_LENGTH = FOCAL_LENGTH
+        self.CAMERA_Z = CAMERA_DISTANCE
+        self.objects = {}
+        self.canvas = tk.Canvas(window, bg = BG)
+        self.canvas.pack(expand = True, fill = "both")
+        self.canvas.focus_set()
+        self.canvas.bind("<KeyPress-w>", lambda event: self._move_forward(0.1))
+        self.canvas.bind("<KeyPress-s>", lambda event: self._move_forward(-0.1))
+        self.canvas.bind("<KeyPress-a>", lambda event: self._move_right(-0.1))
+        self.canvas.bind("<KeyPress-d>", lambda event: self._move_right(0.1))
+        self.canvas.bind("<KeyPress-space>", lambda event: self._change_y(0.1))
+        self.canvas.bind("<KeyPress-Shift_L>", lambda event: self._change_y(-0.1))
+        self.canvas.bind("<Motion>", self._mouse_move)
+        self.canvas.config(cursor="none")
+        self._render()
+    
+    def _mouse_move(self, event):
+        if self.last_mouse_x is None:
+            self.last_mouse_x = event.x
+            self.last_mouse_y = event.y
+            return
+        
+        dx = event.x - self.last_mouse_x
+        dy = event.y - self.last_mouse_y
+        
+        self.YAW += dx * self.SENSITIVITY
+        self.PITCH -= dy * self.SENSITIVITY
+        
+        self.last_mouse_x = event.x
+        self.last_mouse_y = event.y
+        
+    def _change_y(self, amount):
+        self.CAMERA_Y += amount
+        
+    def _move_forward(self, amount):
+        self.CAMERA_X += math.sin(self.YAW) * amount
+        self.CAMERA_Z += math.cos(self.YAW) * amount
+
+    def _move_right(self, amount):
+        self.CAMERA_X += math.cos(self.YAW) * amount
+        self.CAMERA_Z -= math.sin(self.YAW) * amount
+    
+    def add_object(self, name, fill, outline, polygons):
+        self.objects[name] = (name, fill, outline, polygons)
+        if self.LOG:
+            print("[CRAPHICS] Added Object :", name)
+    
+    def remove_object(self, name):
+        if name in self.objects:
+            del self.objects[name]
+        if self.LOG:
+            print("[CRAPHICS] Removed Object :", name)
+    
+    def _get_projection(self,x,y,z):
+        x -= self.CAMERA_X
+        y -= self.CAMERA_Y
+        z -= self.CAMERA_Z
+        
+        x_new = x * math.cos(self.YAW) - z * math.sin(self.YAW)
+        z_new = x * math.sin(self.YAW) + z * math.cos(self.YAW)
+        
+        y_rot = y * math.cos(self.PITCH) - z_new * math.sin(self.PITCH)
+        z_rot = y * math.sin(self.PITCH) + z_new * math.cos(self.PITCH)
+        
+        y_new = y_rot
+        z_new = z_rot
+        
+        if z_new <= self.NEAR_PLANE or z_new >= self.FAR_PLANE:
+            return None
+        
+        x_new = float(self.FOCAL_LENGTH * x_new / z_new)
+        y_new = float(self.FOCAL_LENGTH * y_new / z_new)
+        return x_new, y_new
+
+    def _convert_coordinates(self,x,y):
+        x = x + self.canvas.winfo_width() / 2
+        y = -y + self.canvas.winfo_height() / 2
+        return x,y
+        
+    def add_objfile(self, name, fill, outline, file):
+        with open(file, "r") as f:
+            content = f.readlines()
+            vertices = []
+            polygons = []
+            
+            for line in content:
+                if line[0] == "#" or line[0] == "vn":
+                    continue
+                elif line[0] == "v":
+                    line = line.split()
+                    vertices.append([float(line[1]),float(line[2]),float(line[3])])
+                elif line[0] == "f":
+                    line.split()
+                    point1 = int(line.split()[1].split("/")[0])
+                    point2 = int(line.split()[2].split("/")[0])
+                    point3 = int(line.split()[3].split("/")[0])
+                    polygons.append([vertices[point1 - 1],vertices[point2 - 1],vertices[point3 - 1]])
+            
+            self.add_object(name, fill, outline, polygons)
+    
+    def _get_camera_z(self, x, y, z):
+        x -= self.CAMERA_X
+        y -= self.CAMERA_Y
+        z -= self.CAMERA_Z
+
+        x_new = x * math.cos(self.YAW) - z * math.sin(self.YAW)
+        z_new = x * math.sin(self.YAW) + z * math.cos(self.YAW)
+
+        y_rot = y * math.cos(self.PITCH) - z_new * math.sin(self.PITCH)
+        z_rot = y * math.sin(self.PITCH) + z_new * math.cos(self.PITCH)
+
+        return z_rot
+    
+    def _render(self):
+        start = time.perf_counter()
+        
+        self.canvas.update()
+        self.canvas.delete("all")
+        count = 0
+        for object in self.objects.values():
+            name = object[0]
+            fill = object[1]
+            outline = object[2]
+            polygons = object[3]
+            rendered = 0
+            
+            polygons = sorted(polygons, key=lambda polygon: sum(self._get_camera_z(*vertex) for vertex in polygon) / len(polygon),reverse=True)
+            
+            for polygon in polygons:
+                x1,y1,z1 = polygon[0]
+                x2,y2,z2 = polygon[1]
+                x3,y3,z3 = polygon[2]
+                
+                ax = x2 - x1
+                ay = y2 - y1
+                az = z2 - z1
+
+                bx = x3 - x1
+                by = y3 - y1
+                bz = z3 - z1
+
+                nx = ay * bz - az * by
+                ny = az * bx - ax * bz
+                nz = ax * by - ay * bx
+
+                vx = self.CAMERA_X - x1
+                vy = self.CAMERA_Y - y1
+                vz = self.CAMERA_Z - z1
+
+                dot = nx * vx + ny * vy + nz * vz
+
+                if dot <= 0:
+                    continue
+                
+                value1 = self._get_projection(x1,y1,z1)
+                value2 = self._get_projection(x2,y2,z2)
+                value3 = self._get_projection(x3,y3,z3)
+                
+                if not value1 or not value2 or not value3:
+                    continue
+                
+                x1,y1 = self._convert_coordinates(*value1)
+                x2,y2 = self._convert_coordinates(*value2)
+                x3,y3 = self._convert_coordinates(*value3)
+                
+                rendered += 1
+                self.canvas.create_polygon(x1,y1,x2,y2,x3,y3, fill = fill, outline = outline)
+            
+            if rendered > 0 :
+                count += 1
+        
+        render_time = time.perf_counter() - start
+
+        if self.LOG:
+            print(
+                f"[CRAPHICS] Rendered {count} objects "
+                f"| Render time: {render_time * 1000:.2f} ms "
+                f"| Render FPS: {1 / render_time:.1f} "
+                f"| Target FPS: {self.FPS}"
+            )
+
+        self.canvas.after(1000 // self.FPS, self._render)

craphics-0.0.1/craphics.egg-info/PKG-INFO

@@ -0,0 +1,340 @@
+Metadata-Version: 2.4
+Name: craphics
+Version: 0.0.1
+Summary: A small Python Library for CPU - rendered graphics
+Author: Moinak Debnath
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/findstring/craphics
+Project-URL: Repository, https://github.com/findstring/craphics
+Project-URL: Issues, https://github.com/findstring/craphics/issues
+Keywords: graphics,cpu,rendering,tkinter,math
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Craphics
+
+A small and lightweight Python 3D graphics module built using Python's standard libraries **`tkinter`**, **`math`**, and **`time`**.
+
+Craphics provides basic 3D rendering with perspective projection, camera movement, mouse-controlled rotation, triangle rendering, and `.obj` model loading.
+
+> **Version:** `v0.0.1`
+
+## Features
+
+* 🖥️ Tkinter-based rendering
+* 📐 Basic 3D perspective projection
+* 🎥 Movable camera
+* 🖱️ Mouse-controlled camera rotation
+* 🔺 Triangle-based object rendering
+* 📦 Wavefront `.obj` file loading
+* 👁️ Near and far rendering planes
+* 🎨 Custom object fill and outline colors
+* 📊 Optional rendering logs
+* ⚙️ Configurable FPS and mouse sensitivity
+* 📚 Uses only Python standard libraries
+
+## Installation
+
+Install Craphics using `pip`:
+
+```bash
+pip install craphics
+```
+
+## Requirements
+
+Craphics is built using Python's standard library:
+
+* `tkinter`
+* `math`
+* `time`
+
+No additional Python dependencies are required.
+
+> **Note:** Your Python installation must have Tkinter available.
+
+## Quick Start
+
+```python
+import tkinter as tk
+from craphics import CRAPHICS
+
+window = tk.Tk()
+window.title("Craphics Demo")
+window.geometry("800x600")
+
+graphics = CRAPHICS(
+    window=window,
+    BG="black",
+    FOCAL_LENGTH=500,
+    CAMERA_DISTANCE=5,
+    RENDER_DISTANCE=1000,
+    SENSITIVITY=0.005,
+    FPS=60,
+    LOG=True
+)
+
+window.mainloop()
+```
+
+## Controls
+
+| Key / Input  | Action               |
+| ------------ | -------------------- |
+| `W`          | Move camera forward  |
+| `S`          | Move camera backward |
+| `A`          | Move camera left     |
+| `D`          | Move camera right    |
+| `Space`      | Move camera upward   |
+| `Left Shift` | Move camera downward |
+| Mouse        | Rotate camera        |
+
+The mouse cursor is hidden while using the Craphics canvas.
+
+## API
+
+### `CRAPHICS()`
+
+Creates a Craphics renderer inside the supplied Tkinter window.
+
+```python
+CRAPHICS(
+    window,
+    BG,
+    FOCAL_LENGTH,
+    CAMERA_DISTANCE,
+    RENDER_DISTANCE,
+    SENSITIVITY,
+    FPS,
+    LOG
+)
+```
+
+### Arguments
+
+| Argument          | Description                                                       |
+| ----------------- | ----------------------------------------------------------------- |
+| `window`          | Tkinter parent window in which the rendering canvas is created    |
+| `BG`              | Background color of the rendering canvas                          |
+| `FOCAL_LENGTH`    | Focal length used for perspective projection. Must not be `0`     |
+| `CAMERA_DISTANCE` | Initial distance of the camera along the Z axis. Must not be `0`  |
+| `RENDER_DISTANCE` | Maximum distance from the camera at which objects can be rendered |
+| `SENSITIVITY`     | Mouse rotation sensitivity                                        |
+| `FPS`             | Target rendering frames per second. Must be greater than `0`      |
+| `LOG`             | If `True`, prints rendering information to the console            |
+
+## Adding Objects
+
+### `add_object()`
+
+Adds a triangle-based 3D object to the scene.
+
+```python
+graphics.add_object(
+    name,
+    fill,
+    outline,
+    polygons
+)
+```
+
+### Arguments
+
+| Argument   | Description                               |
+| ---------- | ----------------------------------------- |
+| `name`     | Unique name used to identify the object   |
+| `fill`     | Fill color of the object's triangles      |
+| `outline`  | Outline color of the object's triangles   |
+| `polygons` | List of triangles that make up the object |
+
+Each triangle consists of three 3D vertices:
+
+```python
+polygons = [
+    [
+        [x1, y1, z1],
+        [x2, y2, z2],
+        [x3, y3, z3]
+    ]
+]
+```
+
+For example:
+
+```python
+triangle = [
+    [
+        [-1, -1, 0],
+        [1, -1, 0],
+        [0, 1, 0]
+    ]
+]
+
+graphics.add_object(
+    "Triangle",
+    "red",
+    "white",
+    triangle
+)
+```
+
+## Removing Objects
+
+### `remove_object()`
+
+Removes an object from the scene using its name.
+
+```python
+graphics.remove_object("Triangle")
+```
+
+## Loading `.obj` Models
+
+### `add_objfile()`
+
+Craphics can load geometry from a Wavefront `.obj` file.
+
+```python
+graphics.add_objfile(
+    name,
+    fill,
+    outline,
+    file
+)
+```
+
+### Arguments
+
+| Argument  | Description                      |
+| --------- | -------------------------------- |
+| `name`    | Name used to identify the object |
+| `fill`    | Fill color of the model          |
+| `outline` | Outline color of the model       |
+| `file`    | Path to the `.obj` file          |
+
+Example:
+
+```python
+graphics.add_objfile(
+    "Cube",
+    "blue",
+    "white",
+    "cube.obj"
+)
+```
+
+### `.obj` Support
+
+The current `.obj` loader supports:
+
+* Vertex definitions (`v`)
+* Triangle faces (`f`)
+* Vertex/texture/normal face formats such as `f 1/1/1 2/2/2 3/3/3`
+* Comments (`#`)
+* Vertex normals (`vn`) are ignored
+
+The current implementation expects faces to contain **three vertices**, meaning models should use triangular faces.
+
+## Rendering
+
+Craphics uses a basic perspective projection:
+
+```text
+screen_x = FOCAL_LENGTH × x / z
+screen_y = FOCAL_LENGTH × y / z
+```
+
+Objects are transformed according to the camera's:
+
+* Position
+* Yaw
+* Pitch
+
+Triangles outside the near and far clipping planes are skipped.
+
+The renderer also performs basic back-face culling, so triangles facing away from the camera are not rendered.
+
+## Camera
+
+The camera starts at:
+
+```python
+CAMERA_X = 0
+CAMERA_Y = 0
+CAMERA_Z = CAMERA_DISTANCE
+```
+
+Camera movement is controlled using the keyboard, while yaw and pitch are controlled by mouse movement.
+
+### Camera Parameters
+
+| Parameter         | Description                                        |
+| ----------------- | -------------------------------------------------- |
+| `CAMERA_DISTANCE` | Initial Z position of the camera                   |
+| `SENSITIVITY`     | Amount of camera rotation caused by mouse movement |
+| `RENDER_DISTANCE` | Maximum rendering range                            |
+
+## Rendering Logs
+
+Set `LOG=True` to display rendering information:
+
+```python
+graphics = CRAPHICS(
+    window,
+    "black",
+    500,
+    5,
+    1000,
+    0.005,
+    60,
+    True
+)
+```
+
+The console will display information such as:
+
+```text
+[CRAPHICS] Added Object : Cube
+[CRAPHICS] Rendered 1 objects | Render time: 2.31 ms | Render FPS: 432.9 | Target FPS: 60
+```
+
+Set `LOG=False` to disable these messages.
+
+## Limitations
+
+Craphics is currently intended to be a **simple and experimental 3D renderer**, rather than a full 3D engine.
+
+Current limitations include:
+
+* Triangle-based rendering
+* `.obj` faces should be triangles
+* No textures
+* No lighting system
+* No materials
+* No shadows
+* No perspective-correct texture mapping
+* Basic back-face culling
+* CPU-based rendering through Tkinter
+* Performance decreases with complex models
+
+## Version
+
+**Craphics v0.0.1**
+
+This is an early version of the project and the API may change in future releases.
+
+## License
+
+**MIT License © 2026**
+
+See the `LICENSE` file for the full license text.
+
+---
+
+Made with Python 🐍 and Tkinter.

craphics-0.0.1/craphics.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+craphics/__init__.py
+craphics/craphics.py
+craphics.egg-info/PKG-INFO
+craphics.egg-info/SOURCES.txt
+craphics.egg-info/dependency_links.txt
+craphics.egg-info/top_level.txt

craphics-0.0.1/craphics.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

craphics-0.0.1/craphics.egg-info/top_level.txt

@@ -0,0 +1 @@
+craphics

craphics-0.0.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "craphics"
+version = "0.0.1"
+description = "A small Python Library for CPU - rendered graphics"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [
+    { name = "Moinak Debnath" }
+]
+keywords = ["graphics", "cpu", "rendering", "tkinter", "math"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Graphics",
+	"Topic :: Multimedia :: Graphics :: 3D Modeling",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/findstring/craphics"
+Repository = "https://github.com/findstring/craphics"
+Issues = "https://github.com/findstring/craphics/issues"

craphics-0.0.1/setup.cfg

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