Fork me on GitHub

insert — Paste over another image

Description

public Intervention\Image\Image insert(mixed $source, [integer $pos_x, integer $pos_y, [string $anchor]])

Paste a given image source over the current image with an optional position x, y and an optional anchor position. This method can be used to apply another image as watermark because the transparency values are maintained.

Parameters

source

The image source that will inserted on top of the current image. The method can handle the following types of input:

pos_x (optional)

Optional position of the new image on x-axis of the current image. Default: 0

pos_y (optional)

Optional position of the new image on y-axis of the current image. Default: 0

anchor (optional)

Set a position where image will be inserted. For example if you are setting the anchor to bottom-left the image will be positioned at the bottom-left border of the current image. The position of the new image will be calculated relatively to this location.

The possible values for anchor are:

Return Values

Instance of Intervention\Image\Image

Examples

// create new Intervention Image
$img = Image::make('public/foo.jpg');

// paste another image
$img->insert('public/bar.png');

// create a new Image instance for inserting
$watermark = Image::make('public/watermark.png');
$img->insert($watermark, 100, 100);

// insert watermark at bottom-right corner
$img->insert('public/watermark.png', 0, 0, 'bottom-right');

See also