A tightly-focused PHP library for performing a very limited set of simple image transformations. This library's purpose is to eschew the standard kitchen sink approach to PHP image libraries in favor of high performance, wide driver support, and a dead simple API.
Find a file
2023-09-11 03:28:59 +00:00
.devcontainer started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
examples started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
src started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
tests started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
.gitignore some fundamentals are actually working 2020-10-01 16:07:33 -06:00
composer.json started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
LICENSE Initial commit 2020-09-30 12:11:50 -06:00
README.md started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00

image-transform

A tightly-focused library for performing a very limited set of simple image transformations. This library's purpose is to eschew the standard kitchen sink approach to PHP image libraries in favor of high performance, wider driver support, and a dead simple API.

Current state

This library is under active development, and until a 1.0 release is made you should expect it to potentially be broken, and unexpectedly and dramatically change its API and functionality. That said, I do have use of this thing for work, so I'm probably going to be working pretty dang hard on it, and hope to have a stable release by about November of 2020.

Current progress

Driver Rotate Mirror Resize Crop
GD X X X X
Imagick
Gmagick
ImagickCLI X X X X

Roadmap

Drivers

A 1.0 release will not be made until the following drivers are available and solidly tested:

  • GD
  • Imagick
  • Gmagick
  • GmagickCLI

Transforms

A 1.0 release will be made available once the following transforms are available and solidly tested across all drivers. These are basically what I see as the bare minimum for such a library to be useful.

  • orientation
    • rotate (in 90 degree increments)
    • mirror-h
    • mirror-v
  • size
    • fit (basically an alias for max-width and max-height)
    • cover (scale to cover a box, then crop excess)
    • crop (crop toward the center to a given size)
    • cover-crop (convenience transform, combining cover and crop, useful for thumbnails)

More complex, and also lesser used effects/stages that may or may not make it into 1.0

  • color effects
    • grayscale
    • colorize
  • content effects
    • overlay
    • blur
    • hue
    • saturation
    • brightness

Order of operations

In the name of simplicity, ease of use, and performance, the effective order of operations will always and only be:

  1. Orientation
  2. Resizing and cropping
  3. Color effects
  4. Content-changing effects