Repository navigation
Changelog
0.1.3 — 2026-11-20
Everything from the 0.1.2 review list, plus what the new checks found:
- No silent defaults: unknown
position/gravity,kernel,failOn,extendWith, blurprecision,
chromaSubsampling, TIFFcompression/predictor, HEIFcompression, rawdepthand noisetypenow throw
instead of quietly falling back. - Unambiguous inputs for
composite/join/joinChannel/boolean: encoded image bytes are never used as a file
name, and['file' => …]/['buffer' => …]say explicitly what a value is. Unknown input shapes throw. limitInputPixelsalso applies tocreate,text,fromRawandjoin.- Smart crop (
entropy/attention) on animated images: the first frame picks the window, which is then applied to
every frame. Previously this fell back to centre silently. join()followed by an operation that needs random access (smart crop,rotate(90),flip,trim) no longer
fails with "out of order read". Found with valgrind.PixelForge::format()probes HEIF/AVIF encoders, so it reportsavifas unavailable when libheif has no AV1 encoder
(e.g. Alpine).- Builds on Alpine (musl).
configurechecks for a 64-bit platform with__int128. - New tests: corrupted/truncated input fuzz, strict options, inputs and limits, animated smart crop.
- New CI: Alpine, valgrind memcheck (pixelforge code is clean; third-party libheif reports on corrupt AVIF are
suppressed), README snippet for Alpine.
0.1.2 — 2026-11-20
timeout()now works below one second (libvips progress only counts whole seconds; a monotonic clock is used instead).- macOS: errors raised inside libvips are caught reliably. The extension is built with hidden visibility, so libc++ saw
vips::VErroras a different type andcatchblocks (timeout translation, ICC fallback) could miss. - CI runs the README install steps verbatim on Debian, Ubuntu (PPA), macOS (Homebrew), the Dockerfile snippet and the
Docker quick try. README troubleshooting covers PIE's GitHub rate limit.
0.1.1 — 2026-11-20
Fixes found by a stricter test suite (warnings are now failures, plus a sweep of every public method and invalid input):
- Crash fix: an invalid
toColourspace(),bandbool(),linear(),convolve()orrecomb()argument aborted the
PHP process instead of throwingPixelForgeException. - Colours: CSS names (
red,navy,orange, …) are supported. Invalid colours throwInvalidArgumentException
instead of silently producing a wrong colour. - TIFF:
predictoris only applied to deflate/lzw/zstd, the compressions libtiff accepts it for. - Builds against libvips 8.15/8.16 (the
mks2013/mks2021kernels need 8.17+ and fall back to lanczos3). - README rewritten around copy-paste install steps and recipes.
0.1.0 — 2026-11-20
First release.
- libvips 8.15+ engine with sharp-style shrink-on-load, per-pipeline thread selection and
malloc_trimafter each output. - Inputs: file, buffer, raw pixels, blank/noise canvas, text (Pango), join (grid or animation), animated GIF/WebP pages.
- Operations: resize (5 fits, gravity, entropy/attention, 8 kernels), extract, extend, trim, rotate, flip/flop, affine,
sharpen, blur, median, gamma, negate, normalise, CLAHE, threshold, linear, modulate, tint, greyscale, convolve,
recomb, dilate/erode, boolean/bandbool, join/extract channels, composite (blend modes, tiling). - Outputs: JPEG (mozjpeg options), PNG (palette), WebP, AVIF/HEIF, GIF, TIFF, JPEG XL (when available), raw,
Deep Zoom/Zoomify/Google/IIIF tiles; ICC profile / EXIF writing; timeout. - Installable with
phpize, PECL (package.xml) and PIE (composer.json, typephp-ext).