joby/image-transform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
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.
14 commits 2 branches 2 tags 1.2 MiB
PHP 100%
Find a file
Joby Elliott ac0e9e1acb started work on *magick driver and updated tests
2023-09-12 00:23:25 +00:00
.devcontainer started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
.github/workflows started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
examples started working on 0.2 overhaul 2023-09-11 03:28:59 +00:00
src started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
tests started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
.gitignore started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
composer.json started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
LICENSE Initial commit 2020-09-30 12:11:50 -06:00
phpstan.neon started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
phpunit.xml started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00
README.md started work on *magick driver and updated tests 2023-09-12 00:23:25 +00:00

README.md

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
GDDriver X X X X
MagickDriver
MagickCliDriver X X X X

Roadmap

Drivers

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

  • GD
  • Magick (unified driver that will use either ImageMagick or Gmagick automatically depending on what is available)
  • MagickCliDriver (unified driver that can be configured to use either ImageMagick or Gmagick CLI tools)

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