images.lib.php File Reference

Set of function for manipulating images. More...

Go to the source code of this file.

Functions
	getDefaultImageSizes ()
	Return default values for image sizes. More...
	getListOfPossibleImageExt ($acceptsvg=0)
	Return if a filename is file name of a supported image format. More...
	image_format_supported ($file, $acceptsvg=0)
	Return if a filename is file name of a supported image format. More...
	dol_getImageSize ($file, $url=false)
	Return size of image file on disk (Supported extensions are gif, jpg, png, bmp and webp) More...
	dol_imageResizeOrCrop ($file, $mode, $newWidth, $newHeight, $src_x=0, $src_y=0, $filetowrite='', $newquality=0)
	Resize or crop an image file (Supported extensions are gif, jpg, png, bmp and webp) More...
	dolRotateImage ($file_path)
	dolRotateImage if image is a jpg file. More...
	correctExifImageOrientation ($fileSource, $fileDest, $quality=95)
	Add exif orientation correction for image. More...
	vignette ($file, $maxWidth=160, $maxHeight=120, $extName='_small', $quality=50, $outdir='thumbs', $targetformat=0)
	Create a thumbnail from an image file (Supported extensions are gif, jpg, png and bmp). More...

Detailed Description

Set of function for manipulating images.

Definition in file images.lib.php.

Function Documentation

correctExifImageOrientation()

correctExifImageOrientation	(		$fileSource,
			$fileDest,
			$quality = 95
	)

Add exif orientation correction for image.

Parameters

string	$fileSource	Full path to source image to rotate
string | bool	$fileDest	string : Full path to image to rotate | false return gd img | null the raw image stream will be outputted directly
int	$quality	output image quality

Returns

bool : true on success or false on failure or gd img if $fileDest is false.

Definition at line 427 of file images.lib.php.

Referenced by dolRotateImage().

dol_getImageSize()

dol_getImageSize	(		$file,
			$url = false
	)

Return size of image file on disk (Supported extensions are gif, jpg, png, bmp and webp)

Parameters

string	$file	Full path name of file
bool	$url	Image with url (true or false)

Returns

array array('width'=>width, 'height'=>height)

Definition at line 140 of file images.lib.php.

dol_imageResizeOrCrop()

dol_imageResizeOrCrop	(		$file,
			$mode,
			$newWidth,
			$newHeight,
			$src_x = 0,
			$src_y = 0,
			$filetowrite = '',
			$newquality = 0
	)

Resize or crop an image file (Supported extensions are gif, jpg, png, bmp and webp)

Parameters

string	$file	Path of source file to resize/crop
int	$mode	0=Resize, 1=Crop
int	$newWidth	Largeur maximum que dois faire l'image destination (0=keep ratio)
int	$newHeight	Hauteur maximum que dois faire l'image destination (0=keep ratio)
int	$src_x	Position of croping image in source image (not use if mode=0)
int	$src_y	Position of croping image in source image (not use if mode=0)
string	$filetowrite	Path of file to write (overwrite source file if not provided)
int	$newquality	Value for the new quality of image, for supported format (use 0 for maximum/unchanged).

Returns

string File name if OK, error message if KO

See also

dol_convert_file()

Definition at line 181 of file images.lib.php.

dolRotateImage()

dolRotateImage

(

$file_path

)

dolRotateImage if image is a jpg file.

Currently use an autodetection to know if we can rotate. TODO Introduce a new parameter to force rotate.

Parameters

string

$file_path

Full path to image to rotate

Returns

boolean Success or not

Definition at line 413 of file images.lib.php.

References correctExifImageOrientation().

getDefaultImageSizes()

getDefaultImageSizes

(

)

Return default values for image sizes.

Returns

array Array of default values

Definition at line 38 of file images.lib.php.

getListOfPossibleImageExt()

getListOfPossibleImageExt

(

$acceptsvg = 0

)

Return if a filename is file name of a supported image format.

Parameters

int

$acceptsvg

0=Default (depends on setup), 1=Always accept SVG as image files

Returns

string Return list fo image format

Definition at line 61 of file images.lib.php.

image_format_supported()

image_format_supported	(		$file,
			$acceptsvg = 0
	)

Return if a filename is file name of a supported image format.

Parameters

string	$file	Filename
int	$acceptsvg	0=Default (depends on setup), 1=Always accept SVG as image files

Returns

int -1=Not image filename, 0=Image filename but format not supported for conversion by PHP, 1=Image filename with format supported by this PHP

Definition at line 80 of file images.lib.php.

vignette()

vignette	(		$file,
			$maxWidth = 160,
			$maxHeight = 120,
			$extName = '_small',
			$quality = 50,
			$outdir = 'thumbs',
			$targetformat = 0
	)

Create a thumbnail from an image file (Supported extensions are gif, jpg, png and bmp).

If file is myfile.jpg, new file may be myfile_small.jpg

Parameters

string	$file	Path of source file to resize
int	$maxWidth	Largeur maximum que dois faire la miniature (-1=unchanged, 160 by default)
int	$maxHeight	Hauteur maximum que dois faire l'image (-1=unchanged, 120 by default)
string	$extName	Extension to differenciate thumb file name ('_small', '_mini')
int	$quality	Quality of compression (0=worst, 100=best)
string	$outdir	Directory where to store thumb
int	$targetformat	New format of target (IMAGETYPE_GIF, IMAGETYPE_JPG, IMAGETYPE_PNG, IMAGETYPE_BMP, IMAGETYPE_WBMP ... or 0 to keep old format)

Returns

string Full path of thumb or '' if it fails or 'Error...' if it fails

Definition at line 511 of file images.lib.php.