pyblend2d 0.22.0__tar.gz

pyblend2d-0.22.0/PKG-INFO

@@ -0,0 +1,342 @@
+Metadata-Version: 2.4
+Name: pyblend2d
+Version: 0.22.0
+Summary: Ultra-Fast 2D/2.5D Vector Graphics, GIS, Motion & Video Engine for Python powered by Blend2D
+Author: Islam Arifi, PyBlend Developers
+Maintainer: Islam Arifi
+License: Proprietary
+Project-URL: Homepage, https://huggingface.co/ArifiIslam/PyBlend
+Project-URL: Repository, https://huggingface.co/ArifiIslam/PyBlend
+Project-URL: Documentation, https://huggingface.co/ArifiIslam/PyBlend/blob/main/DOCUMENTATION.md
+Keywords: blend2d,graphics,2d,vector,rasterizer,jit,simd,motion,gis,geopandas,shapely,video,render,vfx
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.20; extra == "numpy"
+Provides-Extra: pil
+Requires-Dist: Pillow>=8.0; extra == "pil"
+Provides-Extra: all
+Requires-Dist: numpy>=1.20; extra == "all"
+Requires-Dist: Pillow>=8.0; extra == "all"
+Requires-Dist: geopandas>=0.10.0; extra == "all"
+Requires-Dist: shapely>=1.8.0; extra == "all"
+Requires-Dist: pytest>=7.0; extra == "all"
+Dynamic: requires-python
+
+# PyBlend (Blend2D for Python) 🎨🚀
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](https://huggingface.co/ArifiIslam/PyBlend)
+[![JIT Accelerated](https://img.shields.io/badge/JIT-AsmJit%20Hardware%20Accelerated-orange.svg)](https://blend2d.com)
+
+**Author & Creator**: Islam Arifi  
+**PyPI Package**: [`pyblend2d`](https://pypi.org/project/pyblend2d/)  
+**Private Mirror**: [Hugging Face](https://huggingface.co/ArifiIslam/PyBlend)  
+
+**PyBlend** is an ultra-fast 2D/2.5D vector graphics, GIS, motion graphics, and cinematic video engine for Python powered by **[Blend2D](https://blend2d.com)** (embedded JIT compiler and SIMD hardware acceleration).
+
+---
+
+## 🔑 License Activation & Evaluation Mode
+
+PyBlend is distributed under a **Proprietary Commercial License** with an Evaluation Mode.
+Unlicensed evaluation renders include a subtle semi-transparent `"Auras"` watermark in the center.
+
+### To Activate Full Commercial Version:
+Call `blend2d.set_license()` at the beginning of your program:
+
+```python
+import blend2d
+
+# Activate official license (removes all evaluation watermarks)
+blend2d.set_license("08032008is")
+```
+
+Or set the environment variable:
+```bash
+export PYBLEND_LICENSE_KEY="08032008is"  # Linux/macOS
+set PYBLEND_LICENSE_KEY="08032008is"     # Windows
+```
+
+---
+
+## 📦 Official Installation
+
+### 1. From PyPI (Recommended):
+```bash
+pip install pyblend2d
+```
+
+### 2. Direct Wheel (from Hugging Face Mirror):
+```bash
+pip install "https://huggingface.co/ArifiIslam/PyBlend/resolve/main/dist/pyblend2d-0.21.2-py3-none-any.whl"
+```
+
+### 3. Optional Speed & Ecosystem Extensions:
+```bash
+pip install "pyblend2d[numpy,pil]"     # For Zero-Copy NumPy & Pillow integration
+pip install "pyblend2d[all]"           # For GeoPandas, Shapely & full testing
+```
+
+### ✅ Quick Verification:
+```python
+import blend2d
+print(f"PyBlend Version: {blend2d.__version__} by {blend2d.__author__}")
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Basic Drawing & Context Manager
+
+```python
+from blend2d import Image, Context, Format
+
+# Create 800x600 surface in PRGB32 format
+img = Image(800, 600, Format.PRGB32)
+
+with Context(img) as ctx:
+    # Fill background
+    ctx.fill_all("#0F172A")
+
+    # Draw smooth anti-aliased circles
+    ctx.fill_circle(200, 300, 100, "#3B82F6")
+    ctx.stroke_width = 4.0
+    ctx.stroke_circle(200, 300, 100, "#93C5FD")
+
+    # Draw rounded rectangle
+    ctx.fill_round_rect(400, 200, 300, 200, 24, "#10B981")
+    ctx.stroke_width = 3.0
+    ctx.stroke_round_rect(400, 200, 300, 200, 24, "#A7F3D0")
+
+# Save directly to PNG
+img.write_to_file("output.png")
+```
+
+---
+
+### 2. Linear, Radial & Conic Gradients
+
+```python
+from blend2d import Image, Context, LinearGradient, RadialGradient, ConicGradient
+
+img = Image(600, 400)
+with Context(img) as ctx:
+    # Linear Gradient
+    grad = LinearGradient(50, 50, 550, 350)
+    grad.add_stop(0.0, "#EC4899")
+    grad.add_stop(0.5, "#8B5CF6")
+    grad.add_stop(1.0, "#06B6D4")
+
+    ctx.fill_round_rect(50, 50, 500, 300, 30, grad)
+
+img.write_to_file("gradient.png")
+```
+
+---
+
+### 3. Vector Paths & Bezier Curves
+
+```python
+from blend2d import Image, Context, Path
+
+img = Image(400, 400)
+with Context(img) as ctx:
+    ctx.fill_all("#18181B")
+
+    # Build vector path
+    p = Path()
+    p.move_to(50, 200)
+    p.cubic_to(150, 50, 250, 350, 350, 200)
+    p.close()
+
+    ctx.fill_path(p, "#38BDF833")
+    ctx.stroke_width = 3.0
+    ctx.stroke_path(p, "#38BDF8")
+
+img.write_to_file("curve.png")
+```
+
+---
+
+### 4. Typography & Font Metrics
+
+```python
+from blend2d import Image, Context, Font
+
+img = Image(600, 200)
+with Context(img) as ctx:
+    ctx.fill_all("#0B0F19")
+
+    font = Font.from_file("C:/Windows/Fonts/segoeui.ttf", 36.0)
+    
+    # Measure text bounding box & advance
+    metrics = font.get_text_metrics("Hello Blend2D!")
+    print(f"Advance width: {metrics.advance.x}px")
+
+    ctx.fill_text(40, 110, font, "Hello Blend2D!", "#38BDF8")
+
+img.write_to_file("text.png")
+```
+
+---
+
+### 5. Zero-Copy NumPy Interoperability
+
+```python
+import numpy as np
+from blend2d import Image, Context
+
+img = Image(500, 500)
+
+# Get direct pointer buffer view as NumPy array (no memory copy)
+buf = img.to_numpy(copy=False)
+
+# Modify pixels directly using vector math
+y, x = np.mgrid[0:500, 0:500]
+buf[:, :, 0] = (x % 256).astype(np.uint8)  # Blue
+buf[:, :, 1] = (y % 256).astype(np.uint8)  # Green
+buf[:, :, 2] = 128                         # Red
+buf[:, :, 3] = 255                         # Alpha
+
+# Render vector overlays on top of the NumPy buffer
+with Context(img) as ctx:
+    ctx.stroke_width = 5.0
+    ctx.stroke_circle(250, 250, 150, "white")
+
+img.write_to_file("numpy_blend.png")
+```
+
+---
+
+### 6. Mass Bulk Array Operations (100,000+ Shapes in 1 Call)
+
+Render massive GIS maps, scatter plots, and point clouds in a single C call with zero Python loop overhead:
+
+```python
+import numpy as np
+from blend2d import Image, Context
+
+img = Image(1000, 1000)
+with Context(img) as ctx:
+    ctx.fill_all("#090D16")
+
+    # Generate 100,000 rectangles [x, y, w, h] as a float64 NumPy array
+    rects = np.random.uniform(0, 950, (100000, 4)).astype(np.float64)
+
+    # ⚡ Single C call — renders in ~30ms!
+    ctx.fill_rect_array(rects, "#38BDF822")
+
+img.write_to_file("bulk_rectangles.png")
+```
+
+---
+
+### 7. Typography to Vector Path Outlines
+
+Convert shaped text (including multi-lingual and Arabic) directly into editable vector `Path` contours:
+
+```python
+from blend2d import Image, Context, Font, LinearGradient
+
+img = Image(800, 200)
+font = Font.from_file("C:/Windows/Fonts/segoeui.ttf", 48.0)
+
+# Convert text string to vector bezier contours
+text_path = font.get_text_outlines("PyBlend 2D Vector Outlines", origin=(40, 120))
+
+with Context(img) as ctx:
+    ctx.fill_all("#0B0F19")
+    
+    # Fill text with dynamic linear gradient
+    grad = LinearGradient(40, 0, 700, 0)
+    grad.add_stop(0.0, "#38BDF8")
+    grad.add_stop(1.0, "#F43F5E")
+    
+    ctx.fill_path(text_path, grad)
+    ctx.stroke_width = 1.5
+    ctx.stroke_path(text_path, "#FFFFFF66")
+
+img.write_to_file("vector_text.png")
+```
+
+---
+
+### 8. Zero-Copy FFmpeg Streaming & Native Buffer Protocol
+
+Stream raw frames directly to FFmpeg stdin or sockets with zero memory copies:
+
+```python
+import subprocess
+from blend2d import Image, Context
+
+img = Image(1920, 1080)
+
+# Direct zero-copy memoryview
+frame_buffer = img.buffer
+
+# Example: Write directly to FFmpeg subprocess
+# proc = subprocess.Popen(['ffmpeg', '-f', 'rawvideo', '-pix_fmt', 'bgra', ...], stdin=subprocess.PIPE)
+# proc.stdin.write(frame_buffer)
+```
+
+---
+
+## ☁️ Google Colab & Kaggle Support
+
+PyBlend ships with pre-compiled Linux x86_64 JIT binaries (`libblend2d.so`), allowing instant execution on Colab and Kaggle without building from source:
+
+```python
+!pip install pyblend2d
+import blend2d
+print("Blend2D running with JIT & SIMD on Linux Cloud!")
+```
+
+---
+
+## 🧪 Running the Test Suite
+
+Run the full pytest suite:
+
+```bash
+python -m pytest tests -v
+```
+
+---
+
+## 🎨 Running Examples
+
+```bash
+python examples/01_basic_shapes.py
+python examples/02_gradients_and_patterns.py
+python examples/03_vector_paths_and_bezier.py
+python examples/04_typography_and_text.py
+python examples/05_numpy_vector_overlay.py
+python examples/06_composite_ops.py
+python examples/07_bulk_gis_and_vector_text.py
+```
+
+Generated outputs will be placed in the `output/` directory.
+
+---
+
+## 📄 License
+
+This library is licensed under the [Zlib License](LICENSE). Blend2D is licensed under the Zlib License.
+

pyblend2d-0.22.0/README.md

@@ -0,0 +1,302 @@
+# PyBlend (Blend2D for Python) 🎨🚀
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](https://huggingface.co/ArifiIslam/PyBlend)
+[![JIT Accelerated](https://img.shields.io/badge/JIT-AsmJit%20Hardware%20Accelerated-orange.svg)](https://blend2d.com)
+
+**Author & Creator**: Islam Arifi  
+**PyPI Package**: [`pyblend2d`](https://pypi.org/project/pyblend2d/)  
+**Private Mirror**: [Hugging Face](https://huggingface.co/ArifiIslam/PyBlend)  
+
+**PyBlend** is an ultra-fast 2D/2.5D vector graphics, GIS, motion graphics, and cinematic video engine for Python powered by **[Blend2D](https://blend2d.com)** (embedded JIT compiler and SIMD hardware acceleration).
+
+---
+
+## 🔑 License Activation & Evaluation Mode
+
+PyBlend is distributed under a **Proprietary Commercial License** with an Evaluation Mode.
+Unlicensed evaluation renders include a subtle semi-transparent `"Auras"` watermark in the center.
+
+### To Activate Full Commercial Version:
+Call `blend2d.set_license()` at the beginning of your program:
+
+```python
+import blend2d
+
+# Activate official license (removes all evaluation watermarks)
+blend2d.set_license("08032008is")
+```
+
+Or set the environment variable:
+```bash
+export PYBLEND_LICENSE_KEY="08032008is"  # Linux/macOS
+set PYBLEND_LICENSE_KEY="08032008is"     # Windows
+```
+
+---
+
+## 📦 Official Installation
+
+### 1. From PyPI (Recommended):
+```bash
+pip install pyblend2d
+```
+
+### 2. Direct Wheel (from Hugging Face Mirror):
+```bash
+pip install "https://huggingface.co/ArifiIslam/PyBlend/resolve/main/dist/pyblend2d-0.21.2-py3-none-any.whl"
+```
+
+### 3. Optional Speed & Ecosystem Extensions:
+```bash
+pip install "pyblend2d[numpy,pil]"     # For Zero-Copy NumPy & Pillow integration
+pip install "pyblend2d[all]"           # For GeoPandas, Shapely & full testing
+```
+
+### ✅ Quick Verification:
+```python
+import blend2d
+print(f"PyBlend Version: {blend2d.__version__} by {blend2d.__author__}")
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Basic Drawing & Context Manager
+
+```python
+from blend2d import Image, Context, Format
+
+# Create 800x600 surface in PRGB32 format
+img = Image(800, 600, Format.PRGB32)
+
+with Context(img) as ctx:
+    # Fill background
+    ctx.fill_all("#0F172A")
+
+    # Draw smooth anti-aliased circles
+    ctx.fill_circle(200, 300, 100, "#3B82F6")
+    ctx.stroke_width = 4.0
+    ctx.stroke_circle(200, 300, 100, "#93C5FD")
+
+    # Draw rounded rectangle
+    ctx.fill_round_rect(400, 200, 300, 200, 24, "#10B981")
+    ctx.stroke_width = 3.0
+    ctx.stroke_round_rect(400, 200, 300, 200, 24, "#A7F3D0")
+
+# Save directly to PNG
+img.write_to_file("output.png")
+```
+
+---
+
+### 2. Linear, Radial & Conic Gradients
+
+```python
+from blend2d import Image, Context, LinearGradient, RadialGradient, ConicGradient
+
+img = Image(600, 400)
+with Context(img) as ctx:
+    # Linear Gradient
+    grad = LinearGradient(50, 50, 550, 350)
+    grad.add_stop(0.0, "#EC4899")
+    grad.add_stop(0.5, "#8B5CF6")
+    grad.add_stop(1.0, "#06B6D4")
+
+    ctx.fill_round_rect(50, 50, 500, 300, 30, grad)
+
+img.write_to_file("gradient.png")
+```
+
+---
+
+### 3. Vector Paths & Bezier Curves
+
+```python
+from blend2d import Image, Context, Path
+
+img = Image(400, 400)
+with Context(img) as ctx:
+    ctx.fill_all("#18181B")
+
+    # Build vector path
+    p = Path()
+    p.move_to(50, 200)
+    p.cubic_to(150, 50, 250, 350, 350, 200)
+    p.close()
+
+    ctx.fill_path(p, "#38BDF833")
+    ctx.stroke_width = 3.0
+    ctx.stroke_path(p, "#38BDF8")
+
+img.write_to_file("curve.png")
+```
+
+---
+
+### 4. Typography & Font Metrics
+
+```python
+from blend2d import Image, Context, Font
+
+img = Image(600, 200)
+with Context(img) as ctx:
+    ctx.fill_all("#0B0F19")
+
+    font = Font.from_file("C:/Windows/Fonts/segoeui.ttf", 36.0)
+    
+    # Measure text bounding box & advance
+    metrics = font.get_text_metrics("Hello Blend2D!")
+    print(f"Advance width: {metrics.advance.x}px")
+
+    ctx.fill_text(40, 110, font, "Hello Blend2D!", "#38BDF8")
+
+img.write_to_file("text.png")
+```
+
+---
+
+### 5. Zero-Copy NumPy Interoperability
+
+```python
+import numpy as np
+from blend2d import Image, Context
+
+img = Image(500, 500)
+
+# Get direct pointer buffer view as NumPy array (no memory copy)
+buf = img.to_numpy(copy=False)
+
+# Modify pixels directly using vector math
+y, x = np.mgrid[0:500, 0:500]
+buf[:, :, 0] = (x % 256).astype(np.uint8)  # Blue
+buf[:, :, 1] = (y % 256).astype(np.uint8)  # Green
+buf[:, :, 2] = 128                         # Red
+buf[:, :, 3] = 255                         # Alpha
+
+# Render vector overlays on top of the NumPy buffer
+with Context(img) as ctx:
+    ctx.stroke_width = 5.0
+    ctx.stroke_circle(250, 250, 150, "white")
+
+img.write_to_file("numpy_blend.png")
+```
+
+---
+
+### 6. Mass Bulk Array Operations (100,000+ Shapes in 1 Call)
+
+Render massive GIS maps, scatter plots, and point clouds in a single C call with zero Python loop overhead:
+
+```python
+import numpy as np
+from blend2d import Image, Context
+
+img = Image(1000, 1000)
+with Context(img) as ctx:
+    ctx.fill_all("#090D16")
+
+    # Generate 100,000 rectangles [x, y, w, h] as a float64 NumPy array
+    rects = np.random.uniform(0, 950, (100000, 4)).astype(np.float64)
+
+    # ⚡ Single C call — renders in ~30ms!
+    ctx.fill_rect_array(rects, "#38BDF822")
+
+img.write_to_file("bulk_rectangles.png")
+```
+
+---
+
+### 7. Typography to Vector Path Outlines
+
+Convert shaped text (including multi-lingual and Arabic) directly into editable vector `Path` contours:
+
+```python
+from blend2d import Image, Context, Font, LinearGradient
+
+img = Image(800, 200)
+font = Font.from_file("C:/Windows/Fonts/segoeui.ttf", 48.0)
+
+# Convert text string to vector bezier contours
+text_path = font.get_text_outlines("PyBlend 2D Vector Outlines", origin=(40, 120))
+
+with Context(img) as ctx:
+    ctx.fill_all("#0B0F19")
+    
+    # Fill text with dynamic linear gradient
+    grad = LinearGradient(40, 0, 700, 0)
+    grad.add_stop(0.0, "#38BDF8")
+    grad.add_stop(1.0, "#F43F5E")
+    
+    ctx.fill_path(text_path, grad)
+    ctx.stroke_width = 1.5
+    ctx.stroke_path(text_path, "#FFFFFF66")
+
+img.write_to_file("vector_text.png")
+```
+
+---
+
+### 8. Zero-Copy FFmpeg Streaming & Native Buffer Protocol
+
+Stream raw frames directly to FFmpeg stdin or sockets with zero memory copies:
+
+```python
+import subprocess
+from blend2d import Image, Context
+
+img = Image(1920, 1080)
+
+# Direct zero-copy memoryview
+frame_buffer = img.buffer
+
+# Example: Write directly to FFmpeg subprocess
+# proc = subprocess.Popen(['ffmpeg', '-f', 'rawvideo', '-pix_fmt', 'bgra', ...], stdin=subprocess.PIPE)
+# proc.stdin.write(frame_buffer)
+```
+
+---
+
+## ☁️ Google Colab & Kaggle Support
+
+PyBlend ships with pre-compiled Linux x86_64 JIT binaries (`libblend2d.so`), allowing instant execution on Colab and Kaggle without building from source:
+
+```python
+!pip install pyblend2d
+import blend2d
+print("Blend2D running with JIT & SIMD on Linux Cloud!")
+```
+
+---
+
+## 🧪 Running the Test Suite
+
+Run the full pytest suite:
+
+```bash
+python -m pytest tests -v
+```
+
+---
+
+## 🎨 Running Examples
+
+```bash
+python examples/01_basic_shapes.py
+python examples/02_gradients_and_patterns.py
+python examples/03_vector_paths_and_bezier.py
+python examples/04_typography_and_text.py
+python examples/05_numpy_vector_overlay.py
+python examples/06_composite_ops.py
+python examples/07_bulk_gis_and_vector_text.py
+```
+
+Generated outputs will be placed in the `output/` directory.
+
+---
+
+## 📄 License
+
+This library is licensed under the [Zlib License](LICENSE). Blend2D is licensed under the Zlib License.
+