image_pack 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a35cbfc63db1f7d8b22ee78c12340ecfca68522706c12b90fe79103c4eee1ed5
-  data.tar.gz: 553e2fb895c181b8b8b399e343b44ae2f001f30c6a0e5e391824d148dec602bd
+  metadata.gz: 6f474c5c23864c265a479c5c711277dc2c3b42dc43217b17822cf6e6aef86a26
+  data.tar.gz: 9f60517520b04ee7a0ca6a69f20b821a1c8603b58b1491f0319edb9732466942
 SHA512:
-  metadata.gz: 9ed878b4dce88f44e0b2f4b6a4601cb3987051aafaa8128e6d932fd58a2067a351987ba979205904531c1e906b230e94264019a4b7e8e2d315c1a069b76bb471
-  data.tar.gz: 0abb8e15b559d1fba9362360d8f585d022f3bbc6f9bfece1cbc754c62f1fce131af0fffb828f2564a5faae939e8539a008345ee5ffcb817f008bbef2c8ba601b
+  metadata.gz: 7b78d6fd999b204c36e843eac3b07867219a774e5590b8a0e59ac93a4f1af684bf241b7ea3622a2daa4de7b05e2f217595821ac149944420659befdcb896e82b
+  data.tar.gz: 8721a5ec476e76a4d1ae667eac4730dce4b1e86971db413f7b1f60ea77d5d27ecff2d36382ea215857486a7bf85355f2bfd194fd41109a750f991f76af1a0f10

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # 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.

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
 
@@ -186,6 +195,7 @@ bundle exec rake release:check
 - JPEG only.
 - 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.