1. Go to this page and download the library: Download hbarcelos/gd-wrapper library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
hbarcelos / gd-wrapper example snippets
use Hbarcelos\GdWrapper\Io\Reader;
$jpegReader = new JpegReader();
$imageResource = $jpegReader->read('/path/to/file.jpg');
use Hbarcelos\GdWrapper\Io\ReaderFactory;
$file = '/path/to/file.png';
$readerFactory = new ReaderFactory();
$reader = $readerFactory->create($file); // Will create a factory based on the type of the image
$imageResource = $reader->read($file);
use Hbarcelos\GdWrapper\Io\Reader;
use Hbarcelos\GdWrapper\Resource\ImageResource;
$jpegReader = new JpegReader();
$imageResource = $jpegReader->read('/path/to/file.jpg');
$objResource = new ImageResource($imageResource);
use Hbarcelos\GdWrapper\Resource\ResourceFactory;
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource = $resourceFactory->create(); // Will create a ImageResource object
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource = $resourceFactory->create(); // Will create a ImageResource object
$objResource = $resourceFactory->create(); // Will create another ImageResource object for the same image
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource = $resourceFactory->create(); // Will create a ImageResource object for /path/to/file.jpg
$resourceFactory->setPathName('/path/to/another_file.png');
$objResource = $resourceFactory->create(); // Will create another ImageResource object for /path/to/another_file.png
use Hbarcelos\GdWrapper\Resource\ImageResource;
use Hbarcelos\GdWrapper\Io\PngWriter;
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource = $resourceFactory->create(); // Will create a ImageResource object for /path/to/file.jpg
$writer = new PngWriter($objResource->getRaw()); // Writers just need the raw GD resource to work
$writer->write('/path/to/new_file.png'); // will save a PNG image on /path/to/new_file.png
header('Content: image/png'); // This is important to make the image be properly rendered by the browser
$writer->write(PngWritter::STDOUT); // will generate a PNG image binary and send it to the browser
use Hbarcelos\GdWrapper\Resource\ResourceFactory;
use Hbarcelos\GdWrapper\Action\Resize;
use Hbarcelos\GdWrapper\Action\ResizeMode\Proportional as ResizeProportional;
use Hbarcelos\GdWrapper\Action\ResizeMode\KeepRatio as ResizeKeepRatio;
use Hbarcelos\GdWrapper\Action\ResizeMode\Exact as ResizeExact;
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource1 = $resourceFactory->create();
$objResource2 = $resourceFactory->create();
$objResource3 = $resourceFactory->create();
/* Will resize the image to 80% of its original size (both width and height).
* You can also scale up an image, by passing a value > 1 to ResizeProportional constructor,
* but that is inadivisable, since it will deteriorate the image quality.
*/
$resizeMode = new ResizeProportional(0.8);
$resizeAction = new Resize($resizeMode);
$resizeAction->execute($objResource1); // $objResource1 now refers to the 80%-resized image resource
/* This will resize the image to the exact dimensions passed to ResizeExact construtor (width, height).
* Needless to say that this can cause distortions (stretching or shrinking) on the image.
*/
$resizeMode = new ResizeExact(400, 300);
$resizeAction->execute($objResource2); // $objResource1 now refers to the 400x300 px resized image resource
/* This is a hybrid resizing mode: you pass both width and length that will be considered the maximum
* allowed dimensions for the image.
*
* If the image dimensions have the same ratio as the dimensions passed to ResizeKeepRatio constructor,
* this action will perform the same way ResizeExact would do.
* If not, then one of the dimensions will be set to the maximum allowed and the other will be proportionally
* scaled in order to stay within the predefined limits.
*/
$resizeMode = new ResizeKeepRatio(400, 300); // This is a 4:3 ratio
// Now imagine that $objResource3 refers to an image with 16:9 ratio (1920x1080 px, AKA full HD)
$resizeAction->execute($objResource3); // $objResource1 now refers to a 400x225 px image (keeping the 16:9 ratio)
use Hbarcelos\GdWrapper\Resource\ResourceFactory;
use Hbarcelos\GdWrapper\Action\Crop;
use Hbarcelos\GdWrapper\Action\CropMode\Proportional as CropProportional;
use Hbarcelos\GdWrapper\Action\CropMode\FixedDimensions as CropFixedDimensions;
use Hbarcelos\GdWrapper\Action\CropMode\FromEdges as CropFromEdges;
use Hbarcelos\GdWrapper\Action\CropMode\FixedPoints as CropFixedPoints;
use Hbarcelos\GdWrapper\Geometry\Point;
use Hbarcelos\GdWrapper\Geometry\Padding\Fixed as FixedPadding;
use Hbarcelos\GdWrapper\Geometry\Padding\Proportional as ProportionalPadding;
use Hbarcelos\GdWrapper\Geometry\Position\FixedPoint as FixedPointPosition;
use Hbarcelos\GdWrapper\Geometry\Position\Aligned as AlignedPosition;
use Hbarcelos\GdWrapper\Geometry\Alignment\Center;
use Hbarcelos\GdWrapper\Geometry\Alignment\Start;
use Hbarcelos\GdWrapper\Geometry\Alignment\End;
$resourceFactory = new ImageResourceFactory('/path/to/file.jpg');
$objResource1 = $resourceFactory->create();
$objResource2 = $resourceFactory->create();
$objResource3 = $resourceFactory->create();
$objResource4 = $resourceFactory->create();
/* Point(x,y) represents the (x,y) point of the inverted y-axis cartesian plan.
* Inverted because the way GD referential point is the top left corner of the image.
* The x coordinates increase from left to right.
* The y coordinates increase from top to down.
*/
/* Fixed points cropping will be done using the rectangle defined by the $start and $end points.
*
* Will generate a 800x500 px image, from the point (0,0) to the point (800,500) of the original image.
*
* Imagine this:
*
* .----------------------------------------------------------> 1920 px
* |(0,0) + > 800 px |
* | + |
* | + |
* | + |
* | + |
* | + |
* | + |
* | + |
* |++++++++++++++++++++++++++.(500,300) |
* | v |
* | 500 px |
* | |
* | |
* | |
* | |
* | |
* -----------------------------------------------------------
* v
* 1080 px
*/
$cropMode = new CropFixedPoints(new Point(0,0), new Point(800,500));
$cropAction = new Crop($cropMode);
$crop->execute($objResource1);
/* Padding cropping can be done using fixed paddings...
*
* Will Generate a 1720x880 image, cropping out 100 px from each side of the original image.
*
* Imagine this:
*
* -----------------------------------------------------------> 1920 px
* | A 100px |
* | V 100 px|
* | +++++++++++++++++++++++++++++++++++++++++++++++<--->|
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* |<--->+++++++++++++++++++++++++++++++++++++++++++++++ |
* | 100 px 100 px A |
* | V |
* -----------------------------------------------------------
* v
* 1080 px
*/
$padding = new FixedPadding(100); // --> same padding for both sides
// To use different vertical and horizontal paddings: new FixedPadding(100, 200) --> 100 px on vert. and 200 horiz.
// To use 4 different paddings: new FixedPadding(100, 200, 50, 80) --> top, right, bottom, left
$cropMode = new CropFromEdges($padding);
$crop->execute($objResource2);
/* ... or it can be done with proportional paddings.
* The proportion will be relative to the original image dimensions.
*
* Imagine this:
*
* -----------------------------------------------------------> 2000 px
* | A 120px |
* | V 200 px|
* | +++++++++++++++++++++++++++++++++++++++++++++++<--->|
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* | + + |
* |<--->+++++++++++++++++++++++++++++++++++++++++++++++ |
* | 200 px 120 px A |
* | V |
* -----------------------------------------------------------
* v
* 1200 px
*/
$padding = new ProportionalPadding(0.1); // 10%
// Different paddings can be used just like the example above
$cropMode = new CropFromEdges($padding);
$crop->execute($objResource3);
/* FixedDimensionsCrop is a Positioned cropping mode.
* This means you have to determine a reference position for it.
* Reference positions can be either a fixed point or anchored to some image notable point (aligned).
*
* For fixed point references, the cropping will behave almost like FixedPointsCrop, but you should pass
* the desired width and height of the cropped image instead of the end point.
*
* Imagine this:
*
* -----------------------------------------------------------> 1920 px
* | |
* | |
* | |
* |(200,200).++++++++++++++++++++++++++++++++ A |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | + + | 900 px |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | +++++++++++++++++++++++++++++++++ V |
* | <----------- 1200 px -----------> |
* | |
* -----------------------------------------------------------
* v
* 1080 px
*/
$pos = new FixedPosition(new Point(200, 200));
$cropMode = new CropFixedDimensions($pos, 1200, 900);
/* An alignment is either start, center or end, for both vertical and horizontal directions.
* For the horizontal direction:
* start --> left
* end --> right
*
* For the vertical direction:
* start --> top
* end --> bottom
*/
/* An aligned position consists of a horizontal AND a vertical alignment.
* The two alignment coordinates will generate a reference point.
*/
/* For aligned reference, the cropping will be aligned to source image anchor points and you should also pass
* the desired width and height for the cropped image.
* Imagine this:
*
* -----------------------------------------------------------> 1920 px
* | |
* | |
* | +++++++++++++++++++++++++++++++++++++++ A |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | + + | 800 px|
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | +++++++++++++++++++++++++++++++++++++++ V |
* | <-------------- 1200 px --------------> |
* | |
* -----------------------------------------------------------
* v
* 1080 px
*/
$pos = new AlignedPosition(new Center());
/* If you want different alingments in horizontal and vertical, you can pass a second argument:
* $post = new AlignedPosition(new Center(), new Start()); // horizontal, vertical = center, top
*/
$cropMode = new CropFixedDimensions($pos, 1200, 800);
$crop->execute($objResource3);
/* Much like the above example, it's also possible do crop an image proportionally, based on a reference position.
* The arguments to the CropProportional constructor are the position and the proportio.
*
* Imagine this:
*
* -----------------------------------------------------------> 2000 px
* | A (10%) |
* | V 120 px |
* | +++++++++++++++++++++++++++++++++++++++ A |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | + + | |
* | + + | 960 px|
* | + + | |
* | + + | |
* | (10%) + + | |
* | 200 px + + | |
* |<------->+++++++++++++++++++++++++++++++++++++++ V |
* | <-------------- 1600 px --------------> |
* | |
* -----------------------------------------------------------
* v
* 1200 px
*/
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.