Collection of breaking change ideas for next major version

[olivervogel]

Collection of ideas that would be nice to have but would introduce a BC and would therefore only be possible in the next major version.

Please note that this is an initial collection of ideas that may or may not be adopted.

[olivervogel]

Standardization and simplification of offset parameters

To specify parameters for offsets, offset_x and offset_y are used in v3. The names could be catchier and simpler.

For example, just x or left instead of offset_x and y or top instead of offset_y.

[olivervogel]

More universal ColorInterface::create() method

Currently only string values of the colors are processed. It would also be nice if the values of the color channels could be specified directly.

use Intervention\Image\Colors\Rgb\Color;

// currently
$color = Color::create('rgb(255, 255, 255)');

// more universal
$color = Color::create('rgb(255, 255, 255)');
$color = Color::create(255, 255, 255);

[olivervogel]

Change from scale (int) 0 - 100 to (float) 0 - 1, for more precise input options.

Many functions use 0 - 100 integers as the standard for inputs. For a more precise definition of values, you could consider switching to float values from 0 - 1.

• 0 becomes 0
• 25 becomes 0.25
• 50 becomes 0.5
• 75 becomes 0.75
• 100 becomes 1

[olivervogel]

Switch to dedicated methods for reading

The universal method for reading images ImageManager::read() is convenient and has many advantages. However, it also has disadvantages compared to a group of specialised methods for each type of input. A change can be discussed.

// before
ImageManager::read();

// after
ImageManager::readFromFilePath();
ImageManager::readFromBinary();
ImageManager::readFromBase64();
ImageManager::readFromDataUri();
ImageManager::readFromStream();
ImageManager::readFromSplFileInfo();
ImageManager::readFromNative();

[olivervogel]

Rename Image::blendTransparency() to Image::background()

Could be shorter and more handy.

[olivervogel]

Add in DriverInterface::version(): string

Could be useful to read out the version of the underlying image library.

$version = Driver::version(); // "1.2.3"

[olivervogel]

Include Driver::version() in DriverInterface::class

[olivervogel]

Image on-demand-evaluation

Conversion to so-called on-demand evaluation of image objects. This means that image objects are only loaded internally into the memory when they are actually needed. Before that, they are simply a sequence of commands.

Example:

$image = ImageManager::withDriver($classname)
    ->read('image.jpg') // call delayed and saved in stack: no real image
    ->resize(300, 200)  // call delayed and saved in stack: no real image
    ->brightness(10)  // call delayed and saved in stack: no real image
    ->contrast(5)  // call delayed and saved in stack: no real image
    ->sharpen()  // call delayed and saved in stack: no real image
    ->toPng();  // Image only becomes real at this point: Stack is evaluated completely

[olivervogel]

Replace string defined mime types with MediaType enum

Example:

interface EncodedImageInterface extends FileInterface
{
    public function mimetype(): string; // no
}

interface EncodedImageInterface extends FileInterface
{
    public function mimetype(): MediaType; // yes
}