pyimagecuda 0.0.3

GPU-accelerated image processing library for Python

PyImageCUDA 0.0.3

GPU-accelerated image compositing for Python.

PyImageCUDA focuses on creative image generation rather than computer vision. Expect GPU-accelerated effects for design workflows—blending modes, shadows, gradients, filters... not edge detection or object recognition.

Quick Example

from pyimagecuda import Image, Fill, Effect, Blend, save

with Image(1024, 1024) as bg:
    with Image(512, 512) as card:
        Fill.color(bg, (1, 1, 1, 1))
        Fill.gradient(card, (1, 0, 0, 1), (0, 0, 1, 1), 'radial')
        Effect.rounded_corners(card, 50)

        with Effect.drop_shadow(card, blur=50, color=(0, 0, 0, 1)) as shadowed:
            Blend.normal(bg, shadowed, anchor='center')

        save(bg, 'output.png')

Key Features

• ✅ Zero Dependencies: No CUDA Toolkit, Visual Studio, or complex compilers needed. Is Plug & Play.
• ✅ Ultra-lightweight: library weighs <0.5 MB.
• ✅ Studio Quality: 32-bit floating-point precision (float32) to prevent color banding.
• ✅ Advanced Memory Control: Reuse GPU buffers across operations and resize without reallocation—critical for video processing and batch workflows.
• ✅ API Simplicity: Intuitive, Pythonic API designed for ease of use.

Use Cases

• Generative Art: Create thousands of unique variations in seconds.
• Motion Graphics: Process video frames or generate effects in real-time.
• Image Compositing: Complex multi-layer designs with GPU-accelerated effects.
• Game Development: Procedural UI assets, icons, and sprite generation.
• Marketing Automation: Mass-produce personalized graphics from templates.
• Data Augmentation: High-speed batch transformations for ML datasets.

Installation

pip install pyimagecuda

Note: Automatically installs pyvips binary dependencies for robust image format support (JPG, PNG, WEBP, HEIC).

Documentation

⚠️ Alpha Release: Many more features are planned and under development.

Core Concepts

• Getting Started Guide
• Image & Memory (Buffer management)
• IO (Loading and Saving)

Operations

• Adjust (Brightness, Contrast, Saturation, Gamma)
• Transform (Flip, Rotate, Crop)
• Blend (Normal, Multiply, Screen, Add, Overlay, Soft Light, Hard Light, Mask)
• Resize (Nearest, Bilinear, Bicubic, Lanczos)
• Filter (Gaussian Blur, Sharpen)
• Effect (Drop Shadow, Rounded Corners)
• Fill (Solid colors, Gradients)

Requirements

• OS: Windows 10 or 11 (64-bit). Linux support coming soon.
• GPU: NVIDIA GPU (Maxwell architecture / GTX 900 series or newer).
• Drivers: Standard NVIDIA Drivers installed.

NOT REQUIRED: Visual Studio, CUDA Toolkit, or Conda.