--- application: "Intervention Image" version: "Version 4" status: "stable" --- # Resize Images ## Change the Image Size in Different Ways Discover comprehensive image resizing techniques with the Intervention Image library. Learn methods for scaling, cropping, and adjusting image canvas sizes, all while maintaining aspect ratios. ## Simple Image Resizing Try it out in the live demo ### Resize an Image > public Image::resize(null|int|Fraction $width = null, null|int|Fraction $height = null): ImageInterface The method `resize()` simply stretches the image to the desired size regardless of the original aspect ratio. Use `resizeDown()` to change the size but do not exceed the original size of the image. The method supports [named arguments](https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments) to target only one axis for the modification. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Desired image width. | | height | null, integer or `Fraction` | Desired image height. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; // create new image instance $image = ImageManager::usingDriver(Driver::class) ->decode('images/example.jpg'); // resize to 300 x 200 pixel $image->resize(300, 200); // resize only image height to 200 pixel $image->resize(height: 200); ``` Try it out in the live demo ### Resize Without Exceeding the Original Size > public Image::resizeDown(null|int|Fraction $width = null, null|int|Fraction $height = null): ImageInterface The `resizeDown()` method does the same as `resize()`. It simply stretches the image to the specified size, but does not exceeds the original size of the image. You can use [named arguments](https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments) to resize just one axis for the modification. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Desired image width. | | height | null, integer or `Fraction` | Desired image height. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; // create new image instance (800 x 600) $image = ImageManager::usingDriver(Driver::class)->decode('images/example.jpg'); $image = $image->resizeDown(2000, 100); // 800 x 100 // resize only image width to 200 pixel and do not exceed the original width $image->resizeDown(width: 200); ``` ## Scale Images Try it out in the live demo ### Resize Images Proportionally > public Image::scale(null|int|Fraction $width = null, null|int|Fraction $height = null): ImageInterface Often you want to resize an image without distorting the original image aspect ratio. For this kind of modification you can simply use the methods `scale()` or `scaleDown()`. Note that the resulting size may differ from the given arguments, as the aspect ratio is preferably preserved. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Desired image width. | | height | null, integer or `Fraction` | Desired image height. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; $manager = ImageManager::usingDriver(Driver::class); // create new image instance with 800 x 600 (4:3) $image = $manager->decode('images/example.jpg'); // scale to fixed height $image->scale(height: 300); // 400 x 300 (4:3) // scale to 120 x 100 pixel $image->scale(120, 100); // 120 x 90 (4:3) ``` Try it out in the live demo ### Scale Images but do not Exceed the Original Size > public Image::scaleDown(null|int|Fraction $width = null, null|int|Fraction $height = null): ImageInterface The method `scale()` resizes the image while maintaining the original aspect ratio. While `scaleDown()` is similar to `scale()` the only difference is that it doesn't exceed the original size of the image. The method support [named arguments](https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments) to target only one axis for the modification. Note that the size of the result may differ from the given parameter values. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Desired image width. | | height | null, integer or `Fraction` | Desired image height. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver; // create new image instance $manager = ImageManager::usingDriver(Driver::class); $image = $manager->decode('images/example.jpg'); // 800 x 600 // scale down to fixed width $image->scaleDown(width: 200); // 200 x 150 // scale down to fixed height $image->scaleDown(height: 300); // 400 x 300 ``` ## Fitted Image Resizing Try it out in the live demo ### Cropping & Resizing Combined > public Image::cover(int|Fraction $width, int|Fraction $height, string|Alignment $alignment = Alignment::CENTER): ImageInterface The `cover()` method is a two-step combination of cropping and resizing to achieve a given result size. This method takes the given dimensions and scales them to the largest possible size that matches the original size. This size is then positioned on the original and cropped before being resized to the desired size from the arguments. This method requires both width and height arguments. You can optionally specify an alignment position to determine which part of the image should remain in focus. #### Parameters | Name | Type | Description | | - | - | - | | width | integer or `Fraction` | Desired image width. | | height | integer or `Fraction` | Desired image height. | | alignment (optional) | string or `Alignment` | Crop alignment. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver; use Intervention\Image\Alignment; // create new image instance (800 x 600) $manager = ImageManager::usingDriver(Driver::class); $image = $manager->decode('images/example.jpg'); // crop the best fitting 5:3 (600x360) ratio and resize to 600x360 pixel $img->cover(600, 360); // crop the best fitting 1:1 ratio (200x200) and resize to 200x200 pixel $img->cover(200, 200); // cover a size of 300x300 and position crop on the left $image->cover(300, 300, Alignment::LEFT); // 300 x 300 px ``` Try it out in the live demo ### Fitted Resizing without Exceeding the Original Size > public Image::coverDown(int|Fraction $width, int|Fraction $height, string|Alignment $alignment = Alignment::CENTER): ImageInterface This method has the same purpose and the same signature as `cover()` but the final pixel size will never be larger than the original image. Use this if you want to avoid upsampling your image. Note that the size of the result may differ from the given parameter values. #### Parameters | Name | Type | Description | | - | - | - | | width | integer or `Fraction` | Desired image width. | | height | integer or `Fraction` | Desired image height. | | alignment (optional) | string or `Alignment` | Position | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; use Intervention\Image\Alignment; // create new image instance $image = ImageManager::usingDriver(Driver::class)->decode('images/example.jpg'); // 800 x 600 // resize down to 1200x720 (5:3) $img->coverDown(1200, 720); // 800 x 480 (5:3) // resize down to 900x900 (1:1) $img->coverDown(900, 900); // 600 x 600 // resize down to 900x450 (2:1) and position left $image->coverDown(900, 450, Alignment::LEFT); // 800 x 400 px ``` ## Contain Resizing Try it out in the live demo ### Contain Resizing > public Image::contain(int|Fraction $width, int|Fraction $height, null|string|ColorInterface $background = null, string|Alignment $alignment = Alignment::CENTER): ImageInterface Resize the image to fit within the given dimensions while maintaining the aspect ratio. New areas are filled with the given background color. #### Parameters | Name | Type | Description | | - | - | - | | width | integer or `Fraction` | Image width. | | height | integer or `Fraction` | Image height. | | background (optional) | null, string or ColorInterface | Background color for the new areas of the image. By default the background color from the configuration is used. | | alignment (optional) | string | Alignment position where the original image is placed. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver; // create new image instance (800 x 600) $image = ImageManager::usingDriver(Driver::class)->decode('images/example.jpg'); // resize padded without upsizing $image->contain(900, 600); // padded resizing with gray background color $image->contain(500, 500, 'efefef'); ``` Try it out in the live demo ### Contain Resizing without Upscaling > public Image::containDown(int|Fraction $width, int|Fraction $height, null|string|ColorInterface $background = null, string|Alignment $alignment = Alignment::CENTER): ImageInterface Resize the image to fit within the given dimensions while maintaining the aspect ratio and without exceeding the original dimensions. New areas are filled with the given background color. #### Parameters | Name | Type | Description | | - | - | - | | width | integer or `Fraction` | Image width. | | height | integer or `Fraction` | Image height. | | background (optional) | null, string or ColorInterface | Background color for the new areas of the image. By default the background color from the configuration is used. | | alignment (optional) | string | Alignment position where the original image is placed. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; use Intervention\Image\Alignment; // create new image instance $manager = ImageManager::usingDriver(new Driver()); $image = $manager->decode('images/example.jpg'); // resize padded to 300 x 200 $image->containDown(300, 200, 'ccc'); // resize padded with alignment position $image->containDown(500, 500, alignment: Alignment::TOP_LEFT); ``` ## Crop Image Try it out in the live demo ### Cut Out a Rectangular Part > public Image::crop(int|Fraction $width, int|Fraction $height, int $x = 0, int $y = 0, null|string|ColorInterface $background = null, string|Alignment $position = Alignment::TOP_LEFT): ImageInterface Crops a rectangular area of the current image with a given width and height at a given position. Pass optional x, y offset coordinates to move the crop by the specified number of pixels. You may also specify a background color. This color is used to fill any new areas that may be created, for example if the cropped area is larger than the original image format. #### Parameters | Name | Type | Description | | - | - | - | | width | integer or `Fraction` | Width of the rectangular cutout | | height | integer or `Fraction` | Height of the rectangular cutout | | x (optional) | int | Pixel offset of the cutout on the x-axis | | y (optional) | int | Pixel offset of the cutout on the y-axis | | background (optional) | null, string or ColorInterface | Color to fill any newly created areas. By default the globally configured background color is used. | | alignment (optional) | string or `Alignment` | Alignment position at which the cutout will be aligned | **Caution: The signature has changed in version 3.3 by the additional parameter `background`** #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; // create new image instance $manager = ImageManager::usingDriver(Driver::class) $image = $manager->decode('images/example.jpg'); // cut out a 200 x 150 pixel cutout at position 45,90 $image->crop(200, 150, 45, 90); // crop a 40 x 40 pixel cutout from the bottom-right and move it 30 pixel down $image->crop(200, 150, 0, 30, position: Alignment::BOTTOM_RIGHT); ``` ## Resize Image Canvas Try it out in the live demo ### Resize Image Boundaries without Resampling the Original Image > public Image::resizeCanvas(null|int|Fraction $width = null, null|int|Fraction $height = null, null|string|ColorInterface $background = null, string|Alignment $alignment = Alignment::CENTER): ImageInterface This function changes the size of the image borders without recalculating the actual image. If the specified sizes are larger than the original, the image area is added in the specified color. If the specified sizes are smaller, the original image area is cropped. The specified position is taken into account and determines where the original image is fixed. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Width of the new image area | | height | null, integer or `Fraction` | Height of the new image area | | background (optional) | null, string or `ColorInterface` | Background color for the new areas of the image. By default the globally configured background color is used. | | alignment (optional) | string or `Alignment` | Alignment position where the original image will be fixed | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; // create new image instance $manager = ImageManager::usingDriver(Driver::class) $image = $manager->decode('images/example.jpg'); // resize image area to 800 x 600 and fill new area with yellow $image->resizeCanvas(800, 600, 'ff0'); ``` Try it out in the live demo ### Resize Image Boundaries Relative to the Original > public Image::resizeCanvasRelative(null|int|Fraction $width = null, null|int|Fraction $height = null, null|string|ColorInterface $background = null, string|Alignment $alignment = Alignment::CENTER): ImageInterface This function behaves in the same way as `resizeCanvas()`, but here you specify relative values which are either added (positive) or subtracted (negative) from the original size. #### Parameters | Name | Type | Description | | - | - | - | | width | null, integer or `Fraction` | Width in pixels to be added or subtracted to the original width | | height | null, integer or `Fraction` | Height in pixels to be added or subtracted to the original height | | background (optional) | null, string or `ColorInterface` | Background color for the new areas of the image. By default the globally configured background color is used. | | alignment (optional) | string or `Alignment` | Alignment position where the original image will be fixed | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Imagick\Driver; use Intervention\Image\Color; // create new image instance $manager = ImageManager::usingDriver(Driver::class) $image = $manager->decode('images/example.jpg'); // add 50 pixels in green at each side of the image $image->resizeCanvas(50, 50, Color::rgb(0, 255, 0)); // add 20 red pixels to the height at the bottom of the image $image->resizeCanvas(height: 20, background: 'ff0000', alignment: Alignment::BOTTOM); ``` ## Resize with Fractions ### Use relative target sizes for resizing All resizing methods are capable of processing relative values in addition to absolute pixel values. These can be passed as enum values from Fraction. This makes it possible to refer to the width or height of the original image without having to calculate it yourself. #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver; use Intervention\Image\Fraction; // create new image instance $image = ImageManager::usingDriver(Driver::class)->decode('example.jpg'); // resize image to half width and quarter height $image->resize(Fraction::HALF, Fraction::QUARTER); // scale image to double height $image->scale(height: Fraction::DOUBLE); // cover resize with quarter image size $image->cover(Fraction::QUARTER, Fraction::QUARTER); ``` ## Trim Image ### Remove Border Areas in Similar Color > public Image::trim(int $tolerance = 0): ImageInterface Removes border areas of the image on all sides that have a similar color. The color similarity can be varied using the optional `tolerance` parameter. This means that with a tolerance value of `0`, only color areas with exactly the same value will be removed. The higher the tolerance, the more similar color areas are included. Usually values up to `20` make sense. **Note that the results can vary greatly depending on the driver and the image you are processing.** #### Parameters | Name | Type | Description | | - | - | - | | tolerance | integer | Tolerance value that determines how similar in color a border area may be in order to be removed. | #### Example ```php use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver; // create new image instance $image = ImageManager::usingDriver(Driver::class)->decode('images/example.jpg'); // trim with a tolerance of 5 $image->trim(5); ``` --- ## Become a Sponsor ### Intervention Image needs your help to keep the project going Intervention Image is non-commercial, open source licensed and completely free to use. The considerable effort required to maintain and develop the software is only possible with the financial support of sponsors. There are two ways in which you can support this project. - Support via [GitHub Sponsors](https://github.com/sponsors/Intervention) - Support via [Ko-Fi](https://ko-fi.com/interventionphp)