Metadata-Version: 2.4
Name: vectify-simplify
Version: 1.0.3
Summary: Enterprise-grade AI image upscaling and multi-threaded vectorization engine.
Author-email: Tu Nombre <tu_correo@ejemplo.com>
Project-URL: Homepage, https://github.com/tu_usuario/vectify
Project-URL: Bug Tracker, https://github.com/tu_usuario/vectify/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python>=4.8.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: onnxruntime>=1.15.0
Dynamic: license-file

# 🚀 Vectify Simplify V8

**Vectify Simplify** is an enterprise-grade, high-performance Python library that combines Artificial Intelligence (ONNX) with advanced mathematical tracing to convert raster images (JPG, PNG) into pixel-perfect, scalable vector graphics (SVG).

## ✨ Key Features
* **🏎️ Hardware Acceleration:** Auto-detects CPU, NVIDIA GPUs (CUDA), and Intel/AMD graphics.
* **🧠 AI Super-Resolution:** Built-in ONNX upscaling.
* **👻 Native Alpha:** Preserves PNG transparency.
* **🎨 Smart Quantization:** Vectorize with up to 64 strict colors.

---

## 📦 Installation
```bash
pip install vectify-simplify
```

*(Optional) For GPU Acceleration:*
* NVIDIA: `pip install onnxruntime-gpu`
* Intel/AMD (Windows): `pip install onnxruntime-directml`

---

## 🚀 Usage Examples

### 1. "Lazy Mode" (Automatic Preset)
Perfect for standard photographs. It automatically upscales, refines, and traces using optimal settings.

```python
from vectify.core import VectifyEngine

# 1. Initialize engine (Auto-detects best hardware)
engine = VectifyEngine(mode="auto")

# 2. Vectorize with a single line
result = engine.vectorize(
    image_path="photo.png", 
    output_path="output.svg", 
    preset="photo" 
)

print(f"Success! SVG created with {result['colors_used']} layers.")
```

### 2. "Hybrid Mode" (Preset + Custom Overrides)
Want to use the logo preset but force a specific number of colors? You can override any parameter.

```python
from vectify.core import VectifyEngine

engine = VectifyEngine()

result = engine.vectorize(
    image_path="logo.png", 
    output_path="clean.svg", 
    preset="logo",            # Start with logo defaults
    max_colors=5,             # Override: Force exactly 5 colors
    solid_fill=True,          # Override: Close micro-gaps mathematically
    detail_level="high"       # Ensure sharp corners
)
```

### 3. Extract Color Palette
Need to know the dominant colors of an image before vectorizing?

```python
from vectify.core import VectifyEngine

engine = VectifyEngine()
palette = engine.analyze_palette("art.png", max_colors=5)

for color in palette: 
    print(f"Hex: {color['hex']} | Area: {color['percentage']}%")
```

---

## 🎛️ Configuration Attributes

When overriding parameters in the `vectorize()` function, use these exact options:

| Parameter | Type/Options | Description |
| :--- | :--- | :--- |
| `preset` | `"photo"`, `"logo"`, `"illustration"` | Base settings configuration. |
| `max_colors` | `int` (e.g., 16, 32) | Maximum number of color layers to extract. |
| `detail_level` | `"low"`, `"medium"`, `"high"` | Polygon count and curve accuracy. |
| `smoothing_level` | `"low"`, `"normal"`, `"high"` | Curve smoothing (Bezier optimization). |
| `solid_fill` | `True`, `False` | Applies morphological closing to heal transparent micro-gaps. |

---
**License:** MIT License. Free for commercial and personal use.
