flutter_bicubic_resize 1.9.0

Fastest image resize, crop and compress for Flutter. 3-4x faster than other libraries. Native C code, consistent results on iOS/Android.

Changelog

1.9.0 - 2026-08-24

Added

• ML normalization presets. New NormalizationPreset enum bundles the four values a model family expects from its input tensor (input size, normalization formula, channel order, tensor layout) for mobileNet, resNet, efficientNet, yolo and openClip. Read them through NormalizationPresetX (preset.inputSize, preset.mean, preset.std, preset.layout, preset.tensorLength, preset.label).
• BicubicResizer.resizeForModelPreset and resizeForModelPresetAsync turn a preset into a ready tensor in one call instead of six hand-tuned arguments. outputWidth/outputHeight override the preset input size for model variants trained at another resolution.
• Batch processing across isolates. BicubicResizer.resizeBatch, resizeForModelBatch and resizeForModelPresetBatch process a list of images in parallel with an ordered result list, a concurrency cap (defaulting to defaultBatchConcurrency, one isolate per core minus one) and an onProgress callback fired on the calling isolate.

Changed

• ffi constraint raised to ^2.2.0.
• flutter_lints raised to ^6.0.0; the package analyzes clean under the stricter rule set.

1.8.2 - 2026-07-10

Changed

• pub.dev "Documentation" link now points to the hosted docs at codigee.com/open-source/flutter-bicubic-resize.

1.8.1 - 2026-07-10

Changed

• Documentation: hosted docs at codigee.com/open-source/flutter-bicubic-resize (overview, API reference, advanced usage).
• README now links the hosted documentation and points the API reference at the hosted page, keeping doc/api.md as the markdown source.

1.8.0 - 2026-07-10

Added

• Aspect-ratio-preserving resize. New BicubicResizer.resizeToFit scales an image so it fits entirely within a maxWidth x maxHeight box without distortion or cropping ("contain" scaling), computing the target dimensions from the image's real size. Images smaller than the box are left untouched unless allowUpscale: true is passed. EXIF orientation is respected by default so the result never exceeds the box after rotation.
• BicubicResizer.computeFitDimensions, a pure, decode-free helper that returns the fitted BicubicDimensions for a source size and bounding box — usable on any platform and independently of the native library.
• BicubicDimensions, an immutable width/height pair with value equality.

1.7.0 - 2026-06-07

Added

• macOS support. The plugin now builds and links its native C code on macOS, fixing Failed to lookup symbol 'bicubic_resize_rgb' (#3). Adds a macos/ podspec that reuses the shared cross-platform C sources and registers macos as an FFI platform. The Dart loader already resolved symbols via DynamicLibrary.executable() on macOS.

Changed

• The Objective-C registrant now imports FlutterMacOS or Flutter depending on the platform, so a single source file serves iOS and macOS.
• Package.swift now also declares the .macOS(10.15) platform.

1.6.0 - 2026-06-07

Added

• Swift Package Manager support for iOS. The plugin now ships a Package.swift and an SPM-compatible source layout under ios/flutter_bicubic_resize/, resolving the "does not support Swift Package Manager" warning in recent Flutter versions (#4). CocoaPods remains supported via the updated podspec pointing at the same sources.

Changed

• Restructured the iOS native sources into ios/flutter_bicubic_resize/Sources/flutter_bicubic_resize/ with the public C header exposed through an umbrella module map. The former Swift symbol-retention registrant was rewritten in Objective-C so the C sources and registrant share a single SPM target.
• Raised the Android compileSdk to 36.
• Raised the minimum SDK constraints to Dart >=3.5.0 and Flutter >=3.24.0 (required for Swift Package Manager).

1.5.4 - 2026-06-07

Added

• ImageFormatX extension exposing mimeType and fileExtension getters on ImageFormat.

1.5.3 - 2026-05-13

Changed

• Replaced the deprecated library flutter_bicubic_resize; directive with the modern unnamed library; declaration in the barrel file.
• Removed unnecessary braces in two string interpolations in the example app (unnecessary_brace_in_string_interps lint cleanup via dart fix --apply). No production code changes.

1.5.2 - 2026-04-07

Changed

• Updated installation docs to ^1.5.2

1.5.1 - 2026-04-07

Changed

• Dart SDK constraint: >=3.2.0 <4.0.0
• Flutter constraint: >=3.16.0
• Android compileSdk: 33 → 35
• Android Gradle Plugin: 7.4.2 → 8.7.3
• iOS deployment target: 11.0 → 13.0
• Modernized Gradle DSL (compileSdkVersion → compileSdk)

1.5.0 - 2026-03-27

Added

• getImageInfo() — read image dimensions, format, channels, and EXIF orientation without decoding pixels
  • BicubicImageInfo class with width, height, channels, format, exifOrientation
  • Computed orientedWidth/orientedHeight for EXIF-corrected dimensions
  • Async variant: getImageInfoAsync()
• resizeFile() / resizeFileToFile() — File I/O convenience methods
  • Read from file path, resize, and return bytes or save to output path
  • Async variants: resizeFileAsync(), resizeFileToFileAsync()
• Format conversion — JPEG↔PNG conversion without resizing
  • jpegToPng() / pngToJpeg() — direct format conversion
  • convertFormat() — auto-detect input and convert to target format
  • Async variants: jpegToPngAsync(), pngToJpegAsync(), convertFormatAsync()
• formatUnknown error code (-6) in BicubicNativeError for unknown/unsupported image formats

Changed

• Parameter validation in C layer — out-of-range filter, edge mode, crop anchor, and aspect mode values are now clamped to safe defaults instead of causing undefined behavior
• Updated flutter_lints from ^3.0.0 to ^4.0.0

1.4.0 - 2026-02-23

Added

• Async wrappers for all public resize methods using Isolate.run() to avoid blocking the UI thread
  • resizeJpegAsync(), resizePngAsync(), resizeRgbAsync(), resizeRgbaAsync()
  • resizeAsync() (auto-detect format), resizeForModelAsync() (ML preprocessing)
• Specific native error codes replacing generic -1 for better debugging
  • BicubicNativeError enum: nullInput (-1), invalidDims (-2), decodeFailed (-3), allocFailed (-4), encodeFailed (-5)
  • BicubicResizeException class with nativeCode, error, and human-readable message
• Custom normalization validation - resizeForModel() now throws ArgumentError if any std value is zero

Changed

• Native C functions now return specific BICUBIC_ERROR_* codes instead of -1 for all errors
• Dart error handling uses BicubicResizeException (implements Exception for backward compatibility)

1.3.1 - 2026-01-13

Fixed

• Android 15 compatibility - Added 16KB page alignment for native library
  • Fixed libflutter_bicubic_resize.so alignment from 4KB to 16KB
  • Required for Android 15 (API 35+) which enforces 16KB page size
  • Added -Wl,-z,max-page-size=16384 linker flag in CMakeLists.txt

1.3.0 - 2026-01-13

Added

• ML preprocessing with normalization - new resizeForModel() method returning Float32List
  • NormalizationType enum: none (default), simple [0,1], centered [-1,1], imageNet, custom
  • ChannelOrder enum: rgb (default), bgr
  • TensorLayout enum: hwc (default, TensorFlow), chw (PyTorch)
  • Custom mean/std normalization parameters
  • Native C pipeline for raw RGB output (no re-encoding overhead)

Optimized

• Pre-computed scale/offset factors for normalization (multiply+add instead of divide+subtract+divide)
• Branch conditions moved outside hot loops for better performance

Changed

• Added machine-learning topic to pubspec.yaml
• Updated API documentation with ML preprocessing section
• Updated README with normalization examples

1.2.3 - 2025-12-18

Added

• Format detection and validation - library now handles unsupported formats
  • ImageFormat enum (jpeg, png) for supported formats
  • UnsupportedImageFormatException - thrown for unsupported formats (HEIC, WebP, GIF, etc.)
  • BicubicResizer.detectFormat(bytes) - detect image format from bytes
  • BicubicResizer.resize(bytes: ...) - generic resize with auto-detection, throws exception for unsupported formats

1.2.2 - 2025-12-18

Added

• Crop anchor positions (CropAnchor) - crop from any position, not just center
  • center (default), topLeft, topCenter, topRight, centerLeft, centerRight, bottomLeft, bottomCenter, bottomRight
• Crop aspect ratio modes (CropAspectRatio) - control crop shape
  • square (default) - 1:1 aspect ratio
  • original - keep original image proportions
  • custom - use custom aspect ratio with aspectRatioWidth/aspectRatioHeight
• Edge handling modes (EdgeMode) - control how pixels outside bounds are handled
  • clamp (default) - repeat edge pixels
  • wrap - tile/repeat image
  • reflect - mirror reflection at edges
  • zero - black/transparent pixels outside
• JPEG EXIF control (applyExifOrientation) - option to disable EXIF orientation correction
• PNG compression control (compressionLevel) - adjust compression 0-9 (default: 6)

Changed

• All new parameters are optional with backward-compatible defaults
• Updated API documentation with comprehensive examples
• Expanded README with new features and usage examples

1.2.1 - 2025-12-14

Fixed

• iOS release build crash - Fixed FFI symbol stripping issue that caused "symbol not found" errors in release/archive builds
• Added proper Xcode build settings to prevent symbol stripping (STRIP_STYLE=non-global)
• Added symbol retention mechanism in Swift plugin to ensure C functions are linked

1.2.0 - 2025-12-14

Added

• EXIF orientation support for JPEG images - photos from mobile cameras now display correctly
• Automatic rotation/flip based on EXIF metadata (supports all 8 orientation values)

Changed

• Breaking: Crop now produces 1:1 aspect ratio (square) instead of proportional crop
  • crop: 1.0 on 1920x1080 image now crops to 1080x1080 (not 1920x1080)
  • This prevents stretching when resizing to square output (e.g., 224x224)
• Updated README with new features documentation

1.1.0 - 2025-12-12

Added

• Optional center crop parameter (crop) for all resize methods
• Crop value range: 0.0-1.0 (1.0 = no crop, 0.5 = center 50%)
• Crop is applied before resize for efficient single-pass processing
• Example app now includes crop slider for testing

Changed

• Updated API documentation with crop parameter
• Updated README with crop usage examples

1.0.1 - 2025-12-12

Fixed

• Fixed GitHub repository links in pubspec.yaml

Added

• Added API documentation (doc/api.md)
• Added topics for better discoverability on pub.dev
• Added funding link
• Added library documentation comments

1.0.0 - 2025-12-12

Added

• Initial release
• Bicubic resize using native C code (stb_image_resize2)
• RGB and RGBA support
• JPEG and PNG encoding/decoding
• Isolate support for non-blocking operations
• iOS and Android support