image_pack 0.2.5 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12f5358f1b62d18b5f23c0022bf953ae6efab239645a94329774465b5ff4681a
-  data.tar.gz: b0fd8d35a15c5e6ef157c925e0ed967a485755b32f310b5c49bdc10688b58ebf
+  metadata.gz: 6f474c5c23864c265a479c5c711277dc2c3b42dc43217b17822cf6e6aef86a26
+  data.tar.gz: 9f60517520b04ee7a0ca6a69f20b821a1c8603b58b1491f0319edb9732466942
 SHA512:
-  metadata.gz: a3cf71f03cedf98384331e74fdd47d3fa151b432d3af4e059032261a3f4a929d15b9329cbc57aace8f04fda9c73ac1cdad9d99a4b7e499fbda1f7242334c5c6e
-  data.tar.gz: 99898ec78f08fe924e5447a514dd37dcd4b141cf6b619fe5713f1050c0ca1ded2e112eda18b407e75b39d3a9c2fe802e1294d02d46ed63a24960944f398603d4
+  metadata.gz: 7b78d6fd999b204c36e843eac3b07867219a774e5590b8a0e59ac93a4f1af684bf241b7ea3622a2daa4de7b05e2f217595821ac149944420659befdcb896e82b
+  data.tar.gz: 8721a5ec476e76a4d1ae667eac4730dce4b1e86971db413f7b1f60ea77d5d27ecff2d36382ea215857486a7bf85355f2bfd194fd41109a750f991f76af1a0f10

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.2.7
+
+**Correctness**
+
+- `optimize_jpeg(progressive: false)` now explicitly disables `JBOOLEAN_OPTIMIZE_SCANS`. The previous path cleared `scan_info` but left mozjpeg's max-compression scan search enabled, which ran `memcpy(NULL, 0)` in `select_scans`.
+- `optimize_jpeg(progressive: true)` now enables scan optimization explicitly instead of inheriting it from `jpeg_set_defaults`.
+- Marker bombs are rejected before `jpeg_read_header` (and again when copying markers). The budget only counts marker types that will actually be saved for the current `strip_metadata` / `strip_icc` flags. APP1/APP2 profile chains allow up to 256 segments; other saved markers stay capped at 64. Combined payload stays at 8 MiB.
+- Default `compress` (`strip_metadata: true`) keeps the ICC profile. Pass `strip_icc: true` to drop it.
+- `mozjpeg_trellis: false` no longer disables overshoot deringing.
+
+**API**
+
+- `subsampling: :auto/:420/:422/:444` on `compress` / `compress_pixels`. For `algo: :size` / `:mozjpeg`, `:auto` uses 4:4:4 at quality >= 90, otherwise 4:2:0. `algo: :fast` / `:jpeg_turbo` keeps 4:2:0 unless `subsampling:` is set. The luma `min_ssim` guard still retries 4:4:4 before raising `QualityConstraintError`.
+- `tune: :hvs/:ssim/:ms_ssim/:psnr` and `effort: :default/:fast/:max`.
+- `scale:` decode-time downscale (`1`, `0.5`, `0.25`, `0.125`, Rational, or `[num, denom]`).
+- `strip_icc:` on `compress` and `optimize_jpeg`.
+- JPEG→JPEG `compress` uses a raw YCbCr path when chroma sampling can be preserved.
+- `optimize_jpeg(strip_metadata: true)` losslessly applies EXIF Orientation via `transupp` when the transform is MCU-perfect. Otherwise it raises `UnsupportedError` instead of silently cropping. Pass `trim: true` to opt in to jpegtran-style edge trim.
+
+**Distribution**
+
+- `rake vendor` applies `patches/*.patch` after unpacking MozJPEG; `rake release:check` dry-runs them.
+- Unused SIMD trees (`i386`, `mips`, `mips64`, `powerpc`, `aarch32`) are no longer packaged.
+- Scalar builds emit a one-time runtime warning instead of failing install.
+
+## 0.2.6
+
+- Lowered the supported Ruby floor to `>= 2.7.1`. The core JPEG API, vendored MozJPEG build, `:direct`, and `:nogvl` execution modes work on Ruby 2.7.1.
+- Kept `execution: :offload` explicitly unavailable until Ruby `>= 3.4`; `:auto` falls back to existing direct/no-GVL execution on older Rubies.
+- Moved Async, benchmark, and external-comparison tooling into an optional `modern_development` Bundler group so a Ruby 2.7.1 developer can install, compile, and run the core suite without resolving modern-only development gems.
+- CI enables `modern_development` on supported modern Rubies, so Async and benchmark dependencies remain covered there.
+
 ## 0.2.5
 
 **Output and API changes (upgrade notes)**

data/README.md

@@ -55,6 +55,9 @@ ImagePack.compress_bytes(jpeg, min_ssim: 0.985)
 ImagePack.compress_bytes(jpeg, progressive: false) # force baseline output
 ImagePack.compress_bytes(jpeg, strict: true)
 ImagePack.compress_bytes(jpeg, report: true)
+ImagePack.compress_bytes(jpeg, subsampling: 444)
+ImagePack.compress_bytes(jpeg, scale: 0.5) # decode-time 1/2, 1/4, or 1/8
+ImagePack.compress_bytes(jpeg, tune: :hvs, effort: :max)
 ```
 
 
@@ -62,7 +65,13 @@ ImagePack.compress_bytes(jpeg, report: true)
 
 `algo: :fast` / `:jpeg_turbo` keeps baseline output by default and remains the throughput path.
 
-`min_ssim:` searches for the lowest acceptable quality using a fast native luma SSIM guard.
+`min_ssim:` searches for the lowest acceptable quality using a fast native luma SSIM guard. The metric is luma-only; with `subsampling: :auto` (the default) a failed guard retries 4:4:4 before raising `QualityConstraintError`. Pass `subsampling: 420`, `422`, or `444` (or the symbols `:auto`, `:"420"`, `:"422"`, `:"444"`) to force chroma sampling. For `algo: :size` / `:mozjpeg`, `:auto` uses 4:4:4 at `quality >= 90` and 4:2:0 otherwise. `algo: :fast` / `:jpeg_turbo` keeps 4:2:0 unless you set `subsampling:` explicitly.
+
+`strip_metadata: true` (the compress default) still keeps the ICC profile. Pass `strip_icc: true` to drop it. Existing JPEG→JPEG compress uses a planar YCbCr path when sampling can be preserved, so chroma is not upsampled and downsampled again.
+
+`tune:` is one of `:hvs` (default), `:ssim`, `:ms_ssim`, `:psnr` — the cjpeg-style MozJPEG presets. `effort:` is `:default`, `:fast` (skips scan search unless `mozjpeg_scan_opt:` is passed), or `:max` (extra trellis loops + quant-table opt).
+
+`scale:` is decode-time only (`1`, `0.5`, `0.25`, `0.125`, a Rational, or `[num, denom]`).
 
 `strict: true` raises `ImagePack::InvalidImageError` on damaged/truncated JPEG warnings.
 
@@ -90,11 +99,11 @@ ImagePack.optimize_bytes(jpeg)
 ImagePack.optimize_file("photo.jpg", output: "photo.optimized.jpg")
 ```
 
-This rewrites JPEG coefficients without decoding and re-encoding pixels. It is the right path for existing JPEGs when you only want optimized Huffman tables and optional progressive scans.
+This rewrites JPEG coefficients without decoding and re-encoding pixels. It is the right path for existing JPEGs when you only want optimized Huffman tables and optional progressive scans. `progressive: true` (the default) runs MozJPEG scan optimization (the jpegrescan-style search). Pass `progressive: false` for a baseline Huffman rewrite; that flag is applied explicitly and does not inherit the max-compression scan search.
 
 Defaults: `progressive: true`, `strip_metadata: false`.
 
-If `strip_metadata: true` would remove EXIF Orientation, `optimize_jpeg` raises `UnsupportedError` instead of silently changing visual orientation.
+If `strip_metadata: true` would remove EXIF Orientation, `optimize_jpeg` applies a lossless coefficient rotate/flip when the image is MCU-aligned. If a rotate/flip would crop partial MCU edges, it raises `UnsupportedError` instead of trimming. Pass `trim: true` to allow jpegtran-style cropping. ICC is kept unless `strip_icc: true`.
 
 ## Raw pixels
 
@@ -156,10 +165,24 @@ end
 
 ## Development
 
+Core build and test dependencies work on Ruby 2.7.1+:
+
 ```bash
-bundle exec rake vendor
+bundle install
 bundle exec rake compile
 bundle exec rake test
+```
+
+Optional comparison benchmarks and Async tooling are kept out of Ruby 2.7 dependency resolution. Enable them on modern Ruby when needed:
+
+```bash
+BUNDLE_WITH=modern_development bundle install
+```
+
+Vendoring and release checks:
+
+```bash
+bundle exec rake vendor
 bundle exec rake release:check
 ```
 
@@ -170,8 +193,9 @@ bundle exec rake release:check
 ## Limits
 
 - JPEG only.
-- Ruby `>= 3.1`; `execution: :offload` requires Ruby `>= 3.4`.
+- Ruby `>= 2.7.1`; `execution: :offload` requires Ruby `>= 3.4`. On Ruby 2.7–3.3, `:auto` uses `:direct` or `:nogvl`; it never attempts scheduler offload.
 - Pixel-level `compress` rejects CMYK/YCCK JPEG input; use `optimize_jpeg` for existing CMYK/YCCK JPEGs.
+- `min_ssim` is luma-only. Color artifacts from 4:2:0 are not scored; use `subsampling:` or rely on the auto 4:4:4 retry (size profile).
 - Arithmetic-coded JPEG support is disabled in `0.2.5`.
 - Streaming output is not supported; file output uses atomic write-through-temp-file and rename.
 - `ImagePack.compress(input, ...)` keeps a legacy path-vs-bytes heuristic; prefer explicit `*_bytes` / `*_file` helpers.

data/ext/image_pack/extconf.rb

@@ -4,8 +4,8 @@ require "mkmf"
 require "fileutils"
 require "rbconfig"
 
-if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3.1.0")
-  abort "image_pack requires Ruby >= 3.1.0; got #{RUBY_VERSION}"
+if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.7.1")
+  abort "image_pack requires Ruby >= 2.7.1; got #{RUBY_VERSION}"
 end
 
 require_relative "mozjpeg_sources"