GUI Image Studio Documentation

GUI Image Studio is a comprehensive Python toolkit for creating, embedding, and managing images in Python GUI applications. It provides support for tkinter and customtkinter frameworks with features like image transformations, animated GIF support, and a visual image studio GUI for creating and editing images.

Features

🎨 Visual Image Studio GUI - Create and edit images with drawing tools
🖼️ Image Embedding - Convert images to base64 encoded strings for easy distribution
📁 Batch Processing - Process entire folders of images automatically
🎨 Multi-Framework Support - Works with tkinter and customtkinter
🔧 Image Transformations - Resize, rotate, flip, tint, contrast, saturation adjustments
📦 Embedded Python Modules - Generate Python files with embedded images
🎬 Animated GIF Support - Create and process animated GIFs with frame control
🎯 High-Quality Compression - Configurable compression options for optimal file sizes
📝 Sample Image Generation - Built-in sample creator for testing
👁️ Real-time Preview - Live preview of transformations and code generation
🔍 Comprehensive Image Information - Detailed image analysis with smart recommendations
🌟 Advanced Transparency Features - Preserve existing transparency when making areas transparent

Quick Start

Installation

pip install gui-image-studio

Launch the Application

# For PyPI installations (recommended)
gui-image-studio-designer

# For development/contributors (GitHub repo only)
python launch_designer.py

Basic Usage

from gui_image_studio import get_image, embed_images_from_folder

# Get a single image with transformations
image = get_image(
    "my_image.png",
    framework="tkinter",
    size=(64, 64),
    theme="default"
)

# Embed all images from a folder
embed_images_from_folder(
    folder_path="images/",
    output_file="embedded_images.py",
    compression_quality=85
)

Command Line Tools

# Launch the Image Studio GUI
gui-image-studio-designer

# Create sample images for testing
gui-image-studio-create-samples

# Embed images from a folder
gui-image-studio-generate \
  --folder images/ \
  --output embedded_images.py \
  --quality 85

Table of Contents

User Guide

API Reference

Links