ThreeDimensions

Send your creations using ThreeDimensions in Models by filling in the Form. The best models will be added to the examples of ThreeDimensions. Others will be added to the models groups. See current submissions in Submissions. Do participate !

---

---

⚡ ThreeDimensions

A Next-Generation 3D Modeling Engine
Built with Python + C++ Core

---

---

🌠 Vision

ThreeDimensions is designed to deliver professional-grade 3D modeling tools with the performance of C++ and the flexibility of Python — empowering developers, creators, and engine builders.

---

⚙️ Core Philosophy

• 🔷 High Performance Rendering Core (C++)
• 🔷 Pythonic Modeling API
• 🔷 Modular Tool Architecture
• 🔷 Production-Ready Design
• 🔷 Cross-Platform Engine Structure

---

✨ Engineered for Power • Designed for Precision • Built for the Future ✨

Professional 3D Modeling Engine & SDK

ThreeDimensions is a high-performance, hybrid C++20/Python 3D modeling library designed to provide a complete toolset comparable to Blender's modeling capabilities. It features a modern C++ core for heavy lifting and a flexible Python SDK for scripting and tool development.

Features

• Hybrid Architecture:
  • C++20 Core: High-performance mesh kernel, geometry processing, and math engine.
  • Python SDK: Object-oriented API, scene graph, and modifier system.
• Mesh Engine: Efficient topology, support for N-gons, and large mesh optimization.
• Modeling Tools:
  • Primitives: Cube, Sphere, Cylinder, Cone, Torus, Plane.
  • Edit Mode: Vertex/Edge/Face operations (Extrude, Bevel, Inset, etc.).
  • Advanced: Booleans, Subdivision Surface, Decimate, Remesh.
• Non-Destructive Workflow: Modifier stack system (Subdivision, Mirror, Array, Boolean).
• Scene System: Hierarchical scene graph, object instancing, and collections.
• Export: OBJ, STL support.

Project Structure

ThreeDimensions/
├── cpp_core/           # C++20 Core Engine
├── python/             # Python SDK
├── examples/           # Usage examples (chair.py, baseball_bat.py)
├── LICENSE
├── Manual.md
├── CMakeLists.txt
├── README.md
├── pyproject.toml

Build Instructions

Prerequisites

• CMake 3.15+
• C++20 compliant compiler (GCC 10+, Clang 10+, MSVC 2019+)
• Python 3.11+
• pip

Download From PyPI or CMD or Terminal

pip install threedimensions

Building from Source

1. Clone the repository:

   git clone https://github.com/LegendsDaD/ThreeDimensions.git
   cd ThreeDimensions

2. Install dependencies and build the Python extension:

   pip install .

   If a C++ compiler is not found, the library will fallback to a pure Python implementation automatically.

Usage

See manual.md for detailed documentation.

import threedimensions as td

# Create a scene
bat = td.Mesh.create_cylinder(radius=0.15, height=1.0)
bat.save("bat.obj")

Authors

• LegedsDaD (legendsdad001@gmail.com)

License

MIT License