2.1.8

Update version

2.1.2

Version Notes: 2.1.2

Changes

• In scaleDownTo.. functions, if bitmap or file width (or height) is already smaller than or equals to the width (or height) argument, a log will be printed instead of throwing IllegalArgumentException.
• Some updates in KDoc
• Small changes in size limit equality checks

2.1

Version Notes: 2.1

Features and Changes

Enhanced Configurability:
Users can now modify configuration parameters dynamically during the compression and scaling process, offering more flexibility.
Improved Logging:
Enhanced log messages for better visibility during file size reduction processes.
SizeException Handling:
Introducing a custom SizeException to provide more specific information when the file size exceeds the specified limits after compression.
Dynamic Configuration Updates:
Configuration parameters such as sizeLimitBytes, compressPriority, lowerWidthLimit, lowerHeightLimit, compressionQualityDownTo, and scaleDownFactor can be modified after the object is instantiated.
Exception Handling
SizeException:
Thrown when the file size remains above the specified limits after the compression and scaling processes.
Improved Logging:
Log messages are more informative and detailed, aiding in debugging and understanding the library's behavior.

2.0

Version Notes: 2.0

Features and Changes

• Code Refactoring

  • The library has undergone significant code refactoring to improve readability, maintainability, and adherence to best practices.

• Enhanced Compression and Scaling Logic

  • The new version introduces a more flexible and customizable approach to compression and scaling.
  • Improved algorithms ensure efficient file size reduction while maintaining image quality.

• New Scaling and Compress Static Methods

  • scaleDownToHeight, scaleDownToWidth and compress static methods have been implemented.

• Dynamic File Overwriting

  • The library now dynamically overwrites the input file during compression for proper size calculation, reducing the need for additional file handling steps.

• Error Handling

  • The library throws specific exceptions (IllegalArgumentException and RuntimeException) to provide more meaningful error messages in case of invalid input or runtime issues.

Breaking Changes

• Constructor Parameters

  • The constructor now accepts a File parameter, ensuring a more intuitive initialization process.

• Method Signature Changes

  • The compress method has been removed from the class, and compression is now handled through the compressAndScaleDown method.

• Method Renaming

  • The compressByPriority method has been renamed to compressAndScaleDownByPriority for clarity.

1.2

Overview

Remove appompat dependency

1.1

Overview

minSdk has been lowered.

1.0

Overview

The BitmapCompression library provides a utility to reduce the size of image files under a specified size limit while maintaining control over compression parameters. This library is particularly useful for reducing image file sizes in Android applications.

Features in version 1.0

Initial release of the BitmapCompression library.

Compression Strategies: Choose between starting compression by scaling down the image or compressing it directly.
Size Limit: Set a maximum file size limit for the compressed image.
Quality Adjustment: Control the compression quality by specifying the compression quality down to a desired level.
Scale Down Factor: Define a scale factor to gradually reduce the width and height of the image during compression.
Lower Resolution Limits: Optionally set lower resolution limits for the width and height of the image.