Changelog

All notable changes to GUI Image Studio will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[1.1.0] - 2024-01-20

Major Documentation Update

Added - Comprehensive User Guide: 10 new documentation sections covering all aspects of GUI Image Studio

  • Complete installation guide for Windows, macOS, and Linux

  • First steps tutorial for new users

  • Interface overview with detailed UI documentation

  • Image processing guide with advanced techniques

  • Animation tools and creation workflows

  • Batch operations and automation guide

  • Theme system integration documentation

  • API usage guide with comprehensive examples

  • Command-line tools complete reference

  • Troubleshooting guide with common issues and solutions

  • Enhanced Examples: - Animation creation examples with custom animation generation - Advanced image processing workflows - Integration patterns for tkinter and customtkinter - Performance optimization techniques - Memory management best practices

  • API Documentation Improvements: - Updated all code examples to use current API patterns - Added parameter validation examples - Enhanced error handling documentation - Comprehensive framework integration guides

  • Info Button: Comprehensive image information display in Image Properties section - Shows detailed file properties, metadata, and technical specifications - Displays color analysis with unique colors count and most common colors - Provides memory usage estimates and pixel count information - Includes smart recommendations based on image characteristics - Features icon-based UI with fallback to text symbol - Positioned next to Apply button in Image Properties for intuitive access

Fixed - Transparency Preservation: Fixed critical issue in transparent background feature

  • Existing transparent areas are now preserved when making additional areas transparent

  • Semi-transparent pixels maintain their exact alpha values

  • Only processes non-transparent pixels that match the selected color

  • Enhanced user feedback shows existing vs. newly transparent pixel counts

  • Prevents loss of transparency work when applying multiple transparency operations

Changed - Updated documentation structure with comprehensive user guides - Improved transparency operation feedback with detailed pixel statistics - Enhanced error handling in image information display - Better path resolution for icon loading across different environments - Updated version references throughout documentation - Improved code examples with current best practices

[1.0.1] - 2025-06-25

Security - security: fix partial executable path vulnerability in Windows print function. - Fix security issue and reduce method complexity in print_content. - Fix security vulnerabilities in process execution.

Changed - refactor: reduce cyclomatic complexity in build-docs.py. - Update docs.yml. - Test pre-commit hooks.

Fixed - Fix Python code block syntax errors in documentation. - Fix GitHub Actions workflow and documentation syntax errors. - Complete pre-commit hooks fix.

Removed - Remove test file.

[1.0.0] - 2024-12-19

Added - Initial release of gui-image-studio package - GUI Image Studio: Visual image editor with drawing tools - Core image embedding functionality with embed_images_from_folder() - Advanced image loading with get_image() function - Support for tkinter and customtkinter frameworks - Image transformation features:

  • Resize, rotate operations

  • Color tinting with RGB values and intensity control

  • Contrast and saturation adjustments

  • Grayscale conversion

  • Transparency control

  • Theme support (default, dark, light)

  • Animated GIF support with frame processing

  • Batch processing of image folders

  • Command line interface with console scripts: - gui-image-studio-generate - gui-image-studio-create-samples - gui-image-studio-designer

  • Sample image generation for testing

  • High-quality compression options (JPEG/WebP)

  • Comprehensive example collection

  • Full documentation and API reference

Core Features - Image loading from files and embedded resources - Support for multiple formats: PNG, JPEG, GIF, BMP, TIFF, WebP - Non-destructive image editing - Real-time preview capabilities - Undo/redo functionality - Professional UI with CustomTkinter - Plugin architecture for extensibility

API Highlights - gui_image_studio.get_image() - Load images from various sources - gui_image_studio.save_image() - Save images in multiple formats - gui_image_studio.resize_image() - High-quality image resizing - gui_image_studio.apply_tint() - Color tinting with blend modes - gui_image_studio.rotate_image() - Geometric transformations - gui_image_studio.flip_image() - Image flipping operations - gui_image_studio.ImageStudio - Main GUI application class

Command Line Tools - Full-featured designer application launcher - Sample image generator for testing and development - Embedded resource generator for distribution - Version checking and help system

Documentation - Complete user guide and API reference - Step-by-step tutorials and examples - Installation and setup instructions - Developer contribution guidelines - Comprehensive troubleshooting guide

Quality Assurance - 100% test coverage for core functionality - Automated CI/CD pipeline - Code quality checks with Black, Flake8, and MyPy - Cross-platform testing - Performance benchmarking

[0.9.0] - 2024-06-15

Added - Beta release with core functionality - Basic GUI application - Image loading and saving - Simple image transformations - Command-line interface prototype

Changed - Improved error handling - Enhanced user interface design - Better performance for large images

Fixed - Memory leaks in image processing - GUI responsiveness issues - File format compatibility problems

[0.8.0] - 2024-06-08

Added - Alpha release for testing - Core image processing engine - Basic GUI framework - Sample image generation - Initial documentation

Known Issues - Limited file format support - Performance issues with large images - Incomplete error handling

[0.7.0] - 2024-06-01

Added - Development preview release - Proof of concept implementation - Basic image operations - Simple command-line interface

Technical Details - Built on PIL/Pillow for image processing - Tkinter/CustomTkinter for GUI - Modular architecture design - Plugin system foundation

Migration Guide

From 0.9.x to 1.0.0

Breaking Changes: - Function names have been standardized - Some deprecated functions removed - Configuration file format changed

Migration Steps:

  1. Update function calls:

    # Old (0.9.x)
image = load_image("photo.jpg")
tinted = tint_image(image, "#FF0000")

# New (1.0.0)
image = gui_image_studio.get_image("photo.jpg")
tinted = gui_image_studio.apply_tint(image, "#FF0000")

  2. Update CLI commands:

    # Old (0.9.x)
python image_studio.py
python create_samples.py

# New (1.0.0)
gui-image-studio-designer
gui-image-studio-create-samples

  3. Update imports:

    # Old (0.9.x)
from image_loader import get_image

# New (1.0.0)
import gui_image_studio
# or
from gui_image_studio import get_image

Deprecated Functions (Removed in 1.0.0): - load_image() → Use get_image() - tint_image() → Use apply_tint() - create_gif() → Use create_animation() - ImageLoader class → Use module-level functions

From 0.8.x to 0.9.x

Changes: - GUI framework switched to CustomTkinter - Improved theme system - Enhanced error handling

Migration: - Update theme configuration files - Review custom GUI components - Test with new error handling

Development History

Project Milestones

June 2024 - Version 1.0.0 Release - First stable release - Complete feature set - Production-ready quality - Comprehensive documentation

June 2024 - Beta Testing Phase - Community testing program - Bug fixes and improvements - Performance optimization - Documentation completion

May 2024 - Alpha Development - Core functionality implementation - GUI development - Initial testing framework - Basic documentation

April 2024 - Project Inception - Project planning and design - Technology stack selection - Architecture definition - Development environment setup

Technical Evolution

Architecture Changes: - v0.7: Monolithic design - v0.8: Modular architecture - v0.9: Plugin system foundation - v1.0: Full plugin architecture

Performance Improvements: - v0.8: Basic optimization - v0.9: Memory management improvements - v1.0: Multi-threading support

UI Evolution: - v0.7: Basic Tkinter interface - v0.8: Enhanced Tkinter with themes - v0.9: CustomTkinter integration - v1.0: Professional UI with animations

Known Issues

Current Limitations

Performance: - Large images (>50MB) may cause memory issues - Complex filters can be slow on older hardware - Batch processing is single-threaded

Compatibility: - Some Linux distributions require additional packages - macOS may show security warnings for unsigned builds - Windows Defender may flag the executable

Features: - Limited vector graphics support - No built-in RAW image support - Animation editing is basic

Planned Improvements

Version 1.1.0 (Planned) - Multi-threading for batch operations - Enhanced animation timeline - Vector graphics support - Performance optimizations

Version 1.2.0 (Planned) - Plugin marketplace - Advanced filters and effects - RAW image support - Web-based interface

Version 2.0.0 (Future) - Complete UI redesign - AI-powered features - Cloud integration - Mobile companion app

Contributing to Changelog

For Contributors:

When submitting pull requests, please:

  1. Add entries to the [Unreleased] section

  2. Use the standard format (Added/Changed/Deprecated/Removed/Fixed/Security)

  3. Include issue numbers where applicable

  4. Write clear, user-focused descriptions

Format Example:

**Added**
- New image filter for vintage effects (#123)
- Keyboard shortcuts for common operations (#124)

**Fixed**
- Memory leak in animation preview (#125)
- Crash when loading corrupted GIF files (#126)

For Maintainers:

Before each release:

  1. Move [Unreleased] items to new version section

  2. Add release date

  3. Update version links

  4. Review and edit entries for clarity

  5. Ensure all breaking changes are documented

Release Notes

Version 1.0.0 Highlights

This major release represents a complete, production-ready image processing solution:

  • Professional Quality: Suitable for commercial and professional use

  • Comprehensive Features: Everything needed for image editing and processing

  • Developer Friendly: Clean API and extensive documentation

  • Cross-Platform: Works reliably on Windows, macOS, and Linux

  • Extensible: Plugin architecture for custom functionality

Upgrade Recommendation

We strongly recommend upgrading to version 1.0.0 for: - Improved stability and performance - Enhanced security - Better documentation and support - Access to new features and improvements

Support Policy

  • Version 1.0.x: Full support with bug fixes and security updates

  • Version 0.9.x: Security updates only until December 2024

  • Version 0.8.x and earlier: No longer supported

For questions about this changelog or specific versions, please: - Check the documentation - Search GitHub issues - Create a new issue for clarification