Insert Images
Place Images onto other Images
2.9M Downloads / Month
Open Source MIT License
You are viewing the documentation for Intervention Image v4. This version is in an early alpha stage.
Use stable in production environments.
Use stable in production environments.
Learn how to insert images onto other images using the Intervention Image library. Position images, adjust offsets, and control opacity for custom overlays or watermarks.
Insert Images
public Image::place(mixed $element, string $position = 'top-left', int $offset_x = 0, int $offset_y = 0, int $opacity = 100): ImageInterface
Inserts an image at the specified position. The image to insert can be specified
from any of the supported image
sources. Optionally you can
pass coordinates for an offset to move the image relative to the specified
position. It is also possible to control the opacity of the watermark using the
opacity parameter.
The possible position values are:
top-left(default)toptop-rightleftcenterrightbottom-leftbottombottom-right
Parameters
| Name | Type | Description |
|---|---|---|
| element | mixed | Source of the image to be placed |
| position | string | Position of the image to be placed |
| offset_x | int | Optional relative offset of the new image on x-axis |
| offset_y | int | Optional relative offset of the new image on y-axis |
| opacity | int | Control over the opacity of the placed image ranging from 0 (fully transparent) to 100 (opaque) |
Example
use Intervention\Image\ImageManager; // create an test image from a file $manager = ImageManager::gd(); $image = $manager->read('test.png'); // paste another image $img->place('images/foo.png'); // create a new resized watermark instance and insert at bottom-right // corner with 10px offset and an opacity of 25% $img->place( 'images/watermark.png', 'bottom-right', 10, 10, 25 );