================================

ImageWorkshop class

================================

Summary and features

Really flexible and easy-to-use PHP class to work with images using the GD Library

http://phpimageworkshop.com/

Latest updates

Version 2.0.2 - 2013-06-14

• Fix a new bug : when resizing or cropping, small images can have 0 pixel of width or height (because of round), which is impossible and script crashes. Now width and height are 1 pixel minimum.

Note:

$layer->resizeInPixel(null, 0 /* or negative number */, null);

It will generate a 1 pixel height image, not 0.

Version 2.0.1 - 2013-06-03

• Fix an opacity bug : pure black color (#000000) always displayed fully transparent (from 0 to 99% opacity). Bug fixed ! (no known bug anymore)
• Add some Exceptions to help debugging

Version 2.0.0 - 2012-11-21

New version of ImageWorkshop ! The library is now divided in 3 main classes for cleaned code:

• ImageWorkshopLayer: the class which represents a layer, that you manipulate
• ImageWorkshop: a factory that is used to generate layers
• ImageWorkshopLib: a class containing some tools (for calculations, etc...), used by both classes

Technically, only the initialization change compared with the 1.3.x versions, check the documentation: http://phpimageworkshop.com/documentation.html#chapter-initialization-of-a-layer

Here an example, before and now:

    // before
    $layer = new ImageWorkshop(array(
        'imageFromPath' => '/path/to/images/picture.jpg',
    ));

    // now
    $layer = ImageWorkshop::initFromPath('/path/to/images/picture.jpg');

And also the installation of the class: http://phpimageworkshop.com/installation.html

The documentation has been updated, you can now check the documentation of each version since 1.3.3: (Ex: http://phpimageworkshop.com/doc/9/initialize-from-an-image-file.html?version=2.0.0, http://phpimageworkshop.com/doc/9/initialize-from-an-image-file.html?version=1.3.3)

Version 1.3.4 - 2012-11-20

• Renaming "Pourcent" occurrences for "Percent" For example, the method resizeInPourcent() is now named resizeInPercent(). Check the changes: https://github.com/Sybio/ImageWorkshop/pull/9/files

Version 1.3.3 - 2012-10-25

• Adding an ImageWorkshopException class in the project to manage exceptions

Version 1.3.1 - 2012-10-17

• Fixing a transparency bug when saving a layer as PNG which has no sublayer.

Version 1.3.0 - 2012-10-11

• You are able to apply a horizontal or vertical flip (transformation) on a layer:

$layer->flip('horizontal');

• Refactoring mergeTwoImages() method.

Installation

The class is designed for PHP 5.3+, but it can work with older PHP versions... Check how to install the class here: http://phpimageworkshop.com/installation.html

Usage

• Learn how to use the class in 5 minutes: http://phpimageworkshop.com/quickstart.html
• The complete documentation: http://phpimageworkshop.com/documentation.html
• Usefull tutorials: http://phpimageworkshop.com/tutorials.html

What's new in the doc' ?

• Installation guide: http://phpimageworkshop.com/installation.html
• Adding the flip documentation: http://phpimageworkshop.com/doc/25/flip-vertical-horizontal-mirror.html
• Adding the opacity documentation which was omitted: http://phpimageworkshop.com/doc/24/opacity-transparency.html
• Tutorial "Manage animated GIF with ImageWorkshop (and GiFFrameExtractor & GifCreator)": http://phpimageworkshop.com/tutorial/5/manage-animated-gif-with-imageworkshop.html

@todo

• Adding a method to add easily borders to a layer (external, inside and middle border)
• Check given hexa' color and remove # if exists.

Contributors

Main contributors:

• Clément Guillemain - Freelance [Sybio / @Sybio01]

And also:

• Cédric Spalvieri - Novaway [skwi69]
• Elton Minetto - Coderockr [eminetto]
• Phil Sturgeon - HappyNinjas Ltd. [philsturgeon]
• [ziadoz]
• Frank de Jonge - Ku [FrenkyNet]
• Bjørn Børresen - Freelancer [bjornbjorn]
• Turneliusz - [Turneliusz]