e2D 2.0.0__cp313-cp313-win_amd64.whl → 2.0.2__cp313-cp313-win_amd64.whl

e2D/winrec.pyi

@@ -0,0 +1,87 @@
+from __future__ import annotations
+from typing import Any
+
+from typing import Optional
+import numpy as np
+import cv2
+import threading
+import queue
+
+class WinRec:
+    """Asynchronous screen recorder for ModernGL-based e2D applications."""
+    
+    rootEnv: Any
+    path: str
+    fps: int
+    draw_on_screen: bool
+    is_recording: bool
+    screenshot_counter: int
+    recording_frames: int
+    pause_start_time: Optional[float]
+    total_pause_duration: float
+    video_writer: cv2.VideoWriter
+    frame_buffer: np.ndarray
+    frame_queue: queue.Queue
+    running: bool
+    frames_written: int
+    frames_dropped: int
+    write_start_time: float
+    last_stat_update: float
+    current_write_fps: float
+    write_thread: threading.Thread
+    
+    def __init__(
+        self,
+        rootEnv: Any,
+        fps: int = 30,
+        draw_on_screen: bool = True,
+        path: str = 'output.mp4'
+    ) -> None: ...
+    
+    def _write_worker(self) -> None:
+        """Background thread that writes frames to video file."""
+        ...
+    
+    def handle_input(self) -> None:
+        """Handle recording control keyboard inputs (F9-F12)."""
+        ...
+    
+    def update(self) -> None:
+        """Capture frame from ModernGL framebuffer and queue for writing."""
+        ...
+    
+    def get_rec_seconds(self) -> float:
+        """Get recorded time in seconds (excludes paused time)."""
+        ...
+    
+    def draw(self) -> None:
+        """Draw recording statistics overlay on screen."""
+        ...
+    
+    def pause(self) -> None:
+        """Pause recording (stop capturing frames)."""
+        ...
+    
+    def resume(self) -> None:
+        """Resume recording (continue capturing frames)."""
+        ...
+    
+    def toggle_recording(self) -> None:
+        """Toggle between pause and resume."""
+        ...
+    
+    def restart(self) -> None:
+        """Restart recording: clear buffer, reset all counters and timers, resume recording."""
+        ...
+    
+    def clear_buffer(self) -> None:
+        """Clear the frame queue and reset write statistics."""
+        ...
+    
+    def take_screenshot(self, filename: Optional[str] = None) -> str:
+        """Save current screen as PNG screenshot."""
+        ...
+    
+    def quit(self) -> None:
+        """Stop recording and release resources."""
+        ...

{e2d-2.0.0.dist-info → e2d-2.0.2.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: e2D
-Version: 2.0.0
+Version: 2.0.2
 Summary: High-performance 2D graphics and math library with ultra-optimized vector operations
 Home-page: https://github.com/marick-py/e2D
 Author: Riccardo Mariani
-Author-email: Riccardo Mariani <ricomari2006@gmail.com>
+Author-email: Riccardo Mariani <riccardo.mariani@emptyhead.dev>
 License: MIT
 Project-URL: Homepage, https://github.com/marick-py/e2D
 Project-URL: Repository, https://github.com/marick-py/e2D
@@ -30,9 +30,10 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.19.0
-Requires-Dist: pygame
 Requires-Dist: moderngl
 Requires-Dist: glfw
+Requires-Dist: Pillow>=8.0.0
+Requires-Dist: attrs
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
@@ -41,6 +42,10 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Provides-Extra: performance
 Requires-Dist: cython>=0.29.0; extra == "performance"
+Provides-Extra: rec
+Requires-Dist: opencv-python; extra == "rec"
+Provides-Extra: all
+Requires-Dist: opencv-python; extra == "all"
 Dynamic: license-file
 
 # e2D - High-Performance 2D Graphics and Math Library
@@ -62,7 +67,9 @@ Dynamic: license-file
 ### 🎮 Modern Graphics
 - **ModernGL** rendering pipeline
 - **Shape rendering** with instancing support
-- **Text rendering** with custom styles
+- **Text rendering** with custom styles and TTF fonts
+- **Screen recording** with async video encoding
+- **Color system** with 80+ pre-defined colors
 - **GLFW window management**
 
 ### 🎯 Game Development Tools
@@ -73,18 +80,51 @@ Dynamic: license-file
 
 ## 📦 Installation
 
+### Basic Installation
+
 ```bash
 pip install e2D
 ```
 
 The package will automatically compile the Cython extensions during installation for optimal performance (like numpy). If compilation fails, it falls back to pure Python mode.
 
+### Optional Features
+
+Install with screen recording support:
+```bash
+pip install e2D[rec]
+```
+
+Install for development (includes testing tools):
+```bash
+pip install e2D[dev]
+```
+
+Install with performance monitoring (includes Cython source):
+```bash
+pip install e2D[performance]
+```
+
+Install everything:
+```bash
+pip install e2D[all]
+```
+
+### Legacy Version (1.x with Pygame)
+
+If you need the old pygame-based version:
+```bash
+pip install "e2D<2.0"
+```
+
 ### Requirements
 - Python 3.9+
-- NumPy
-- ModernGL
-- GLFW
-- Pygame
+- NumPy (required)
+- ModernGL (required)
+- GLFW (required)
+- Pillow (required - for text rendering)
+- attrs (required - for data structures)
+- OpenCV-Python (optional, for recording - install with `[rec]` extra)
 
 ## 🚀 Quick Start
 
@@ -119,26 +159,50 @@ pos_array = vectors_to_array(positions)
 ### Graphics Rendering
 
 ```python
-from e2D import RootEnv
-
-class MyApp(RootEnv):
-    def __init__(self):
-        super().__init__(
-            window_size=(1920, 1080),
-            target_fps=60,
-            vsync=True
-        )
+from e2D import RootEnv, DefEnv
+
+class MyApp(DefEnv):
+    def __init__(self) -> None:
+        pass
     
-    def update(self):
+    def update(self) -> None:
         # Your game logic here
         pass
     
-    def draw(self):
+    def draw(self) -> None:
         # Your rendering code here
         pass
 
-app = MyApp()
-app.run()
+# Initialize and run
+rootEnv = RootEnv(window_size=(1920, 1080), target_fps=60)
+rootEnv.init(MyApp())
+
+# Optional: Enable screen recording
+rootEnv.init_rec(fps=30, draw_on_screen=True, path='output.mp4')
+
+rootEnv.loop()
+```
+
+### Color System
+
+```python
+from e2D import Color, WHITE, RED, CYAN, normalize_color
+from e2D.color_defs import MD_BLUE, PASTEL_PINK, NEON_GREEN
+
+# Create colors
+color1 = Color.from_hex("#FF5733")
+color2 = Color.from_rgb255(100, 150, 200)
+color3 = Color.from_hsv(0.5, 0.8, 1.0)
+
+# Color operations
+lighter = color1.lighten(0.2)
+darker = color1.darken(0.2)
+inverted = color1.invert()
+rotated = color1.rotate_hue(120)
+
+# Use pre-defined colors
+from e2D import draw_circle
+draw_circle((100, 100), 50, color=RED, fill_mode='fill')
 ```
 
 ## 📊 Performance
@@ -162,9 +226,9 @@ Perfect for:
 
 ## 📚 Documentation
 
+- **[API Reference](docs/API_REFERENCE.md)** - Complete API documentation
 - **[Quick Start Guide](QUICKSTART.md)** - Get up and running in minutes
-- **[API Reference](https://github.com/marick-py/e2D)** - Full API documentation
-- **[Examples](examples/)** - Working code examples
+- **[Developer Guide](DEVELOPER_GUIDE.md)** - Development workflow and contributing
 
 ## 🎯 Use Cases
 
@@ -239,7 +303,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## 👤 Author
 
 **Riccardo Mariani**
-- Email: ricomari2006@gmail.com
+- Email: riccardo.mariani@emptyhead.dev
 - GitHub: [@marick-py](https://github.com/marick-py)
 
 ## 🙏 Acknowledgments
@@ -250,8 +314,13 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## 📈 Version History
 
-- **2.0.0** - Added ultra-optimized Vector2D with Cython compilation
-- **1.4.24** - Previous stable release with pure Python vectors
+### Version 2.x (ModernGL-based - Current)
+- **2.0.2** (Current) - Bug fixes and documentation improvements
+- **2.0.0** - Complete rewrite with ModernGL rendering, Cython-optimized vectors, modern color system, screen recording, removed pygame dependency
+
+### Version 1.x (Pygame-based - Legacy)
+- **1.4.24** - Previous stable release with pure Python vectors and pygame
+- Legacy versions available via: `pip install "e2D<2.0"`
 
 ---
 

e2d-2.0.2.dist-info/RECORD

@@ -0,0 +1,46 @@
+e2D/__init__.py,sha256=4nHe2BM_96KpCiIyou-vXMRZYpb29J0iyss_tZw1l1I,21367
+e2D/__init__.pyi,sha256=GDsOLGkttx3m6j_5fQoMWiM6wAEnlM5VhLtdHQa1qQg,5389
+e2D/ccolors.c,sha256=Jwq7_RSoivaWCu22YVe-Bc9PthbN37G_legE17w49Dg,1362725
+e2D/ccolors.cp313-win_amd64.pyd,sha256=TLAOCFubcc9rYbzmUFrQeu9RvmkJSKJ59DHTnQl6PB8,184320
+e2D/ccolors.pyi,sha256=YigNgTp0YWL4sdJs9Twb5gfWDgD0R0ic5WnGoCIVYmI,1157
+e2D/ccolors.pyx,sha256=d11z7TLFKPAw5Xz1LA2_Xh27xWGzmqoQD0aMcWHy1PY,10116
+e2D/color_defs.py,sha256=9zMRdGGDENjhaSDmFA0V-Nxtga_Q5sJUL1RwigXq6sI,9475
+e2D/colors.py,sha256=ntuaRWf3EZf7FQlaKQqEVZRJoP7L-Wz2k9e12Onh4Mk,12981
+e2D/colors.pyi,sha256=swdU3wcIoh4kEVY7lKv50zw2OyO2XDO4pqTJ3HetWp8,3917
+e2D/commons.py,sha256=HHCns8CpKw51R6jlsrItwINVTULqOnk3bhUuIPT4_60,3732
+e2D/commons.pyi,sha256=gMXLKPM2I8DHs3ZbFNa2K1iRp4VWqiauMub5kT4cslE,2153
+e2D/cvectors.c,sha256=zv03i5AJTHPM8xJO5zY289OGj6afd2froVCOXJp9I0o,1222782
+e2D/cvectors.cp313-win_amd64.pyd,sha256=tL8ZyK2ZQl-YnV1G1M2sC8N06f3RKN7Yy7gqyAvOnKc,228864
+e2D/cvectors.pxd,sha256=7y2VUafKkVFezGQioTlF66dy4g5aNbGnGLhLtHZpuM4,2137
+e2D/cvectors.pyi,sha256=DbhamdowlGb4e-FhAUQDW-NlWCOPTNrxeQOs73DzvKE,6895
+e2D/cvectors.pyx,sha256=xJW6dD6JikkUXy0cuytgIijZJLcTpzJ0NpJ-aIErdzg,19048
+e2D/devices.py,sha256=PYEayxU78qTUlTMN5qmiE5PgqOlzupzIFui-yzOXxxo,2903
+e2D/devices.pyi,sha256=A7MYcTGcQ7kyj6A6d0kAIXyK6C4n5rZkfeUJkZIkZFY,1859
+e2D/plots.py,sha256=PhrsZoip07y6tqwWguNVAk2TlTM1F4b6Ovi3ByEsZFI,21982
+e2D/plots.pyi,sha256=HHtNg9eMCHijfTVPCfRjGgY2h9CgEdgy_bgMHUGZL9k,6645
+e2D/shapes.py,sha256=dOXt-OY8-LaBwpNKBcqfvuDsvzeL9x8Pg6QkjW_T0cI,45823
+e2D/shapes.pyi,sha256=Dp5QyZ91fw8sWGZ3048cKMegETBnmsejHZ12XAr-F3A,8357
+e2D/test_colors.py,sha256=rWgCrV4nj8jtK4fh89aW76Gl7R8QyGPeb5AJ3hWFsxY,3872
+e2D/text_renderer.py,sha256=054Vl_tsV8DU-E17JB8a5FAcXq2m6UqlPahTa_NhM74,21015
+e2D/text_renderer.pyi,sha256=Bylzoy_HX-Bu1viKzYQR9pfHRK5ywUXiamtqoUcaw94,3199
+e2D/types.py,sha256=eJGqMWKlEk_bX-_B4mcZo5at22DKOEuPr-Nn_bZcvCE,1764
+e2D/types.pyi,sha256=INQYPvpGcQH9cgKzUiAPYDabazOyf2lNTbzW_LUV9hU,1595
+e2D/vectors.py,sha256=ViZwLpLmfkIEdBDYRpv69Yaf-nishh-Q5LXmZzkkjCg,11519
+e2D/vectors.pyi,sha256=Fc1hPx1PCqJ_K3cVDg3R9W_yq5E21RzgOJVJB09kfhY,2399
+e2D/winrec.py,sha256=--KZZsUUIH0w_TD91MpFAwcMCCdFyzKz4RL6V4h0LEY,11281
+e2D/winrec.pyi,sha256=5uOJA6_ANS4UnFCP281o0wnQOozFwZoThId-ibBzMj0,2393
+e2D/shaders/curve_fragment.glsl,sha256=tKI3rDSlJPrWrQiATn6Rf4bJv7YGWVF6sgU9Y5H5qOk,94
+e2D/shaders/curve_vertex.glsl,sha256=uEp9OwcTSB_EfJhQRkNPalpT6jvJ2FO42vnPeKZl9J8,324
+e2D/shaders/line_instanced_vertex.glsl,sha256=r4XUNFogDH-Q9d_uXZQcT47iuiO8LeYXbEbqzRCFKSo,1049
+e2D/shaders/plot_grid_fragment.glsl,sha256=rOKW6Bold7d9Bunaf1SJeLYOgbsHfKk_UVFGMpkMq4c,1338
+e2D/shaders/plot_grid_vertex.glsl,sha256=-t8E3D0KBjaxIFbhZl87A0_4TzJ7fmajyLXoAaLu7_M,139
+e2D/shaders/segment_fragment.glsl,sha256=tKI3rDSlJPrWrQiATn6Rf4bJv7YGWVF6sgU9Y5H5qOk,94
+e2D/shaders/segment_vertex.glsl,sha256=I-hgbl2SnR5tWH9KRhz3CCj3ZZ7poz_gUfph1ydisaQ,233
+e2D/shaders/stream_fragment.glsl,sha256=EBI2wXv_LjoikQ3sbPtRw5gA5lIeLimNBUSoU6UWSqM,246
+e2D/shaders/stream_shift_compute.glsl,sha256=nwTD8IJjsFpl2XUXInc8IBDdW-DOmvaMLygLdquidyg,290
+e2D/shaders/stream_vertex.glsl,sha256=Wxa8YtgxlMNL7OYq5LwqoOA_B4iRilC5_ArznyT018Y,608
+e2d-2.0.2.dist-info/licenses/LICENSE,sha256=hbjljn38VVW9en51B0qzRK-v2FBDijqRWbZIVTk7ipU,1094
+e2d-2.0.2.dist-info/METADATA,sha256=4FGqpudVja0bpGK8VZOGa4HkP5AkrhD6rx7i87BdmfE,9092
+e2d-2.0.2.dist-info/WHEEL,sha256=-WvvtQtdhM1F5HMi-4hSXLQ_1Tg6qJRWO1HnLNr4mCU,102
+e2d-2.0.2.dist-info/top_level.txt,sha256=3vKZ-CGzNlTCpzVMmM0Ht76krCofKw7hZ0wBf-dnKdM,4
+e2d-2.0.2.dist-info/RECORD,,

{e2d-2.0.0.dist-info → e2d-2.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: false
 Tag: cp313-cp313-win_amd64
 

e2d-2.0.0.dist-info/RECORD

@@ -1,26 +0,0 @@
-e2D/__init__.py,sha256=rNGyv9X8ZdmTJvgjXaO8SKGTnQlrvhtIBF8PP3VpBFA,18054
-e2D/commons.py,sha256=vs6UqYGtm2-oHfv5kCSjMaQ243Xq6OqWh4Jt520H6Ho,2522
-e2D/cvectors.c,sha256=Rqj99mKXScJ2OMc4y5KSBXhjLyuV4bP7T5v-nOgEooY,1222782
-e2D/cvectors.cp313-win_amd64.pyd,sha256=_gzGIOVkH7XbiEr2fQ_QjCkuOytuzPqWgscRqUL2xmE,228864
-e2D/cvectors.pxd,sha256=7y2VUafKkVFezGQioTlF66dy4g5aNbGnGLhLtHZpuM4,2137
-e2D/cvectors.pyx,sha256=xJW6dD6JikkUXy0cuytgIijZJLcTpzJ0NpJ-aIErdzg,19048
-e2D/devices.py,sha256=iAUNXSSD0wEqLqHV6ET3dcqx4C62ifxaXcN_8xaV7sI,2440
-e2D/plots.py,sha256=gaCnnA-gUY1Hnmgquo7mqWlxSzAY4swTfwoPmw9ZF2k,21272
-e2D/shapes.py,sha256=PY2G0EFCLqERTR0UfK8jqSanh5wwIBTYRPA5a6LRs7w,45450
-e2D/text_renderer.py,sha256=u3i0qxnqgnVGUB6f0bKb1QtElVe535cDIIpjtRRcLAY,19752
-e2D/vectors.py,sha256=WXNzaA1bLjM5movVWOn7gDy73H1xA0cavlP7djO1FSc,6781
-e2D/shaders/curve_fragment.glsl,sha256=tKI3rDSlJPrWrQiATn6Rf4bJv7YGWVF6sgU9Y5H5qOk,94
-e2D/shaders/curve_vertex.glsl,sha256=uEp9OwcTSB_EfJhQRkNPalpT6jvJ2FO42vnPeKZl9J8,324
-e2D/shaders/line_instanced_vertex.glsl,sha256=r4XUNFogDH-Q9d_uXZQcT47iuiO8LeYXbEbqzRCFKSo,1049
-e2D/shaders/plot_grid_fragment.glsl,sha256=rOKW6Bold7d9Bunaf1SJeLYOgbsHfKk_UVFGMpkMq4c,1338
-e2D/shaders/plot_grid_vertex.glsl,sha256=-t8E3D0KBjaxIFbhZl87A0_4TzJ7fmajyLXoAaLu7_M,139
-e2D/shaders/segment_fragment.glsl,sha256=tKI3rDSlJPrWrQiATn6Rf4bJv7YGWVF6sgU9Y5H5qOk,94
-e2D/shaders/segment_vertex.glsl,sha256=I-hgbl2SnR5tWH9KRhz3CCj3ZZ7poz_gUfph1ydisaQ,233
-e2D/shaders/stream_fragment.glsl,sha256=EBI2wXv_LjoikQ3sbPtRw5gA5lIeLimNBUSoU6UWSqM,246
-e2D/shaders/stream_shift_compute.glsl,sha256=nwTD8IJjsFpl2XUXInc8IBDdW-DOmvaMLygLdquidyg,290
-e2D/shaders/stream_vertex.glsl,sha256=Wxa8YtgxlMNL7OYq5LwqoOA_B4iRilC5_ArznyT018Y,608
-e2d-2.0.0.dist-info/licenses/LICENSE,sha256=hbjljn38VVW9en51B0qzRK-v2FBDijqRWbZIVTk7ipU,1094
-e2d-2.0.0.dist-info/METADATA,sha256=EKooTJt_akYAd3s_-S7pvJlmnogTloMGmR-pFnutUMc,7117
-e2d-2.0.0.dist-info/WHEEL,sha256=T5i2ODeLs0s2las6bzoWK6w-WYjxkhtXh7SRJsBsjo4,102
-e2d-2.0.0.dist-info/top_level.txt,sha256=3vKZ-CGzNlTCpzVMmM0Ht76krCofKw7hZ0wBf-dnKdM,4
-e2d-2.0.0.dist-info/RECORD,,