imageflip

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imageflip — Flips an image using a given mode

Description

imageflip(GdImage $image, int $mode): true

Flips the image image using the given mode.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

mode

Flip mode, this can be one of the IMG_FLIP_* constants:

Constant Meaning

IMG_FLIP_HORIZONTAL Flips the image horizontally.

IMG_FLIP_VERTICAL Flips the image vertically.

IMG_FLIP_BOTH Flips the image both horizontally and vertically.

Constant	Meaning
`IMG_FLIP_HORIZONTAL`	Flips the image horizontally.
`IMG_FLIP_VERTICAL`	Flips the image vertically.
`IMG_FLIP_BOTH`	Flips the image both horizontally and vertically.

Return Values

Always returns true.

Changelog

Version	Description
8.0.0	`image` expects a GdImage instance now; previously, a valid `gd` resource was expected.

Examples

Example #1 Flips an image vertically

This example uses the IMG_FLIP_VERTICAL constant.

<?php
// File
$filename = 'phplogo.png';

// Content type
header('Content-type: image/png');

// Load
$im = imagecreatefrompng($filename);

// Flip it vertically
imageflip($im, IMG_FLIP_VERTICAL);

// Output
imagejpeg($im);
?>

The above example will output something similar to:

Output of example: Vertically flipped image

Example #2 Flips the image horizontally

This example uses the IMG_FLIP_HORIZONTAL constant.

<?php
// File
$filename = 'phplogo.png';

// Content type
header('Content-type: image/png');

// Load
$im = imagecreatefrompng($filename);

// Flip it horizontally
imageflip($im, IMG_FLIP_HORIZONTAL);

// Output
imagejpeg($im);
?>

The above example will output something similar to:

Output of example: Horizontally flipped image