1.8Documentation

$image = Image::forge();

// Or with optional config
$image = Image::forge(array(
    'quality' => 80
));
$image
    ->load('image.png')
    ->output('image.jpeg');

// Resize an image, and change the background.
Image::load('filename.gif')
    ->config('bgcolor', '#f00')
    ->resize(100, 100, true, true);

// Load image
Image::load('filename.gif');

// Upload an image and pass it directly into the Image::load method.
Upload::process(array(
    'path' => DOCROOT.DS.'files'
));

if (Upload::is_valid())
{
    $data = Upload::get_files(0);

    // Using the file upload data, we can force the image's extension
    // via $force_extension
    Image::load($data['file'], false, $data['extension'])
        ->crop_resize(200, 200)
        ->save('image');
} 

// For the purpose of this example, the image width and height are 200x200

// Crops the image from (20, 20) to (180, 180)
Image::load('filename.gif')
    ->crop(20, 20, 180, 180);

// Crops the image from (40, 40) to (160, 160) using negatives.
Image::load('filename.gif')
    ->crop(40, 40, -40, -40);

// Crops the image from (30, 30) to (170, 170) using a mix of percentages and negatives.
Image::load('filename.gif')
    ->crop('15%', '15%', '-15%', '-15%');

// Resize using absolutes
Image::load('filename.gif')
    ->resize(100, 100);

// Resize using percentages
Image::load('filename.gif')
    ->resize('50%', '50%');

// Stretch the image to fit
Image::load('filename.gif')
    ->resize(100, 100, false);

// Pad image as to keep input size and AR.
Image::load('filename.gif')
    ->resize(100, 200, true, true);

// Example usage, crop a 300x200 image to 200x200 would remove 50px on the top and bottom
Image::load('filename.gif')
    ->crop_resize(200, 200);

// Rotates by 90 degrees clockwise
Image::load('filename.gif')
    ->rotate(90);

// Rotates by 90 degrees counter clockwise
Image::load('filename.gif')
    ->rotate(-90);

// Accepts numbers outside of the (-359, 359) range.
Image::load('filename')
    ->rotate(450);

//Flip vertical
Image::load('filename.gif')
    ->flip('vertical');

// Flip horizontal
Image::load('filename.gif')
    ->flip('horizontal');

// Flip horizontal and vertical.
Image::load('filename')
    ->flip('both');

// Watermarks the image in the top left corner with padding of 15 pixels
Image::load('filename.gif')
    ->watermark('watermark.ext', "top left", 15);

// Watermarks the image in the bottom right corner
Image::load('filename.gif')
    ->watermark('watermark.ext', "bottom right");

// Watermarks the image in the center
Image::load('filename.gif')
    ->watermark('watermark.ext', "center middle");
// "center middle" is identical to "center center", "middle middle", or "middle center"

// Make a 10px black border
Image::load('filename.gif')
    ->border(10, '#000000');

// Make a 15px red, green, and blue border.
Image::load('filename.gif')
    ->border(5, '#FF0000')
    ->border(5, '#00FF00')
    ->border(5, '#0000FF');

// Masks the image with mask.ext
Image::load('filename.gif')
    ->mask('mask.ext');

// Rounds the image 10px on all sides
Image::load('filename.gif')
    ->rounded(10);

// Rounds the image 10px on the top
Image::load('filename.gif')
    ->rounded(10, "tl tr");

// Rounds the image 10px on all sides with no antialiasing
Image::load('filename.gif')
    ->rounded(10, null, 0);

// Get sizes for a referenced image
$sizes = Image::sizes('filename.gif');

// Returns
Object
(
    [width] => 500
    [height] => 400
)

// Returns 'jpg'
$ext = Image::load('uploaded_file.jpg')
    ->extension();

// Save a PNG as a JPG
Image::load('placeholder.png')
    ->output($ext);
                            

// Grayscale image
Image::load('filename.gif')
    ->grayscale();

// Saves to filename2.ext
Image::load('filename.gif')
    ->save('filename2');

// Saves to filename2.png
Image::load('filename.gif')
    ->save('filename2.png');

// Saves to filename2.ext while attempting to apply permissions
Image::load('filename.gif')
    ->save('filename2', 755);

// Saves to prepend_filename_append.gif
Image::load('filename.gif')
    ->save_pa('prepend_', '_append');
                            

// Output as gif
Image::load('filename.gif')
    ->output();

// Output as jpeg
Image::load('filename.gif')
    ->output('jpeg');