ImagePickerKMP v1.0.24-beta Release Notes

ImagePickerKMP v1.0.24-beta Release Notes

Release Date: September 11, 2025

---

New Features

Advanced Image Cropping System

• ** Interactive Crop Handles** - Resize crop areas with intuitive corner and edge handles
  • 8 resize points: corners (TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT) and edges (TOP_CENTER, BOTTOM_CENTER, LEFT_CENTER, RIGHT_CENTER)
  • Real-time crop rectangle adjustment with smooth user interaction
• ** Circular Crop Support** - Create perfect circular cropped images for avatars and profile pictures
• ** Smart Crop Configuration** - Flexible crop settings:
  • aspectRatioLocked - Maintain consistent image proportions
  • circularCrop - Enable circular cropping mode
  • squareCrop - Force square aspect ratio (enabled by default)
  • freeformCrop - Allow completely free-form cropping

Enhanced Image Compression

• ** Compression Level Control** - Three-tier compression system:
  • CompressionLevel.LOW - High quality (95% quality) for premium images
  • CompressionLevel.MEDIUM - Balanced (75% quality) for general use
  • CompressionLevel.HIGH - Maximum compression (50% quality) for storage optimization
• ** Custom Quality Settings** - Fine-tune compression with precise quality values (0.0 to 1.0)
• ** Cross-Platform Optimization** - Consistent compression behavior on Android and iOS

File Size Optimization

• ** Smart File Size Reporting** - File sizes now reported in KB for better readability
• ** Automatic Size Calculation** - Real-time file size updates during compression
• ** Storage-Aware Processing** - Intelligent compression based on target file sizes

---

Improvements & Enhancements

User Interface

• Enhanced Crop View - Improved visual feedback during image cropping
• Better Touch Handling - More responsive crop handle detection and movement
• Precise Positioning - Accurate crop area boundaries with visual guides

Cross-Platform Stability

• ** iOS Compatibility** - Resolved compilation issues for all iOS targets (arm64, x64, simulatorArm64)
• ** Android Optimization** - Enhanced bitmap processing and memory management
• ** Platform Consistency** - Unified behavior across Android and iOS implementations

Performance

• ** Optimized Rendering** - Faster image processing and crop operations
• ** Memory Efficiency** - Reduced memory footprint during image manipulation
• ** Build Performance** - Improved build times with better caching (~7 minutes)

---

Technical Specifications

Supported Operations

• Image Selection - Gallery and camera capture
• Advanced Cropping - Rectangular, square, circular, and freeform
• Smart Compression - Multiple quality levels with size optimization
• Format Support - JPEG, PNG with proper compression handling
• Orientation Handling - Automatic image orientation correction

Platform Support

• ✅ Android - API 21+ with CameraX integration
• ✅ iOS - iOS 14+ with native PHPickerViewController
• ✅ Kotlin Multiplatform - KMP 1.9.x compatibility

---

Installation

Gradle (Kotlin DSL)

dependencies {
    implementation("io.github.ismoy:imagepickerkmp:1.0.24-beta")
}

Gradle (Groovy)

dependencies {
    implementation 'io.github.ismoy:imagepickerkmp:1.0.24-beta'
}

---

Usage Examples

Basic Crop Configuration

val cropConfig = CropConfig(
    enabled = true,
    circularCrop = false,
    squareCrop = true,
    aspectRatioLocked = true
)

Compression Setup

val compressionConfig = CompressionConfig(
    quality = CompressionLevel.MEDIUM
)

---

Acknowledgments

Special thanks to the community for feedback on cropping functionality and compression requirements that shaped this release.

---

🔗 Resources

• 📚 Documentation
• 🐛 Bug Reports
• 💬 Discussions
• 📖 API Reference

---

This release brings professional-grade image editing capabilities to ImagePickerKMP with advanced cropping and compression features!

Android

Crop Mode

iOS

Crop Mode