Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
/lib/ -> gdlib.php (source)
<?php

// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * gdlib.php - Collection of routines in Moodle related to
 * processing images using GD
 *
 * @package   core
 * @copyright 1999 onwards Martin Dougiamas  {@link http://moodle.com}
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

/**
 * Copies a rectangular portion of the source image to another rectangle in the destination image
 *
 * This function calls imagecopyresampled() if it is available and GD version is 2 at least.
 * Otherwise it reimplements the same behaviour. See the PHP manual page for more info.
 *
 * @link http://php.net/manual/en/function.imagecopyresampled.php
< * @param resource $dst_img the destination GD image resource < * @param resource $src_img the source GD image resource
> * @param resource|\GdImage $dst_img the destination GD image resource > * @param resource|\GdImage $src_img the source GD image resource
* @param int $dst_x vthe X coordinate of the upper left corner in the destination image * @param int $dst_y the Y coordinate of the upper left corner in the destination image * @param int $src_x the X coordinate of the upper left corner in the source image * @param int $src_y the Y coordinate of the upper left corner in the source image * @param int $dst_w the width of the destination rectangle * @param int $dst_h the height of the destination rectangle * @param int $src_w the width of the source rectangle * @param int $src_h the height of the source rectangle * @return bool tru on success, false otherwise */ function imagecopybicubic($dst_img, $src_img, $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h) { global $CFG; if (function_exists('imagecopyresampled')) { return imagecopyresampled($dst_img, $src_img, $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h); } $totalcolors = imagecolorstotal($src_img); for ($i=0; $i<$totalcolors; $i++) { if ($colors = imagecolorsforindex($src_img, $i)) { imagecolorallocate($dst_img, $colors['red'], $colors['green'], $colors['blue']); } } $scalex = ($src_w - 1) / $dst_w; $scaley = ($src_h - 1) / $dst_h; $scalex2 = $scalex / 2.0; $scaley2 = $scaley / 2.0; for ($j = 0; $j < $dst_h; $j++) { $sy = $j * $scaley; for ($i = 0; $i < $dst_w; $i++) { $sx = $i * $scalex; $c1 = imagecolorsforindex($src_img, imagecolorat($src_img, (int)$sx, (int)$sy + $scaley2)); $c2 = imagecolorsforindex($src_img, imagecolorat($src_img, (int)$sx, (int)$sy)); $c3 = imagecolorsforindex($src_img, imagecolorat($src_img, (int)$sx + $scalex2, (int)$sy + $scaley2)); $c4 = imagecolorsforindex($src_img, imagecolorat($src_img, (int)$sx + $scalex2, (int)$sy)); $red = (int) (($c1['red'] + $c2['red'] + $c3['red'] + $c4['red']) / 4); $green = (int) (($c1['green'] + $c2['green'] + $c3['green'] + $c4['green']) / 4); $blue = (int) (($c1['blue'] + $c2['blue'] + $c3['blue'] + $c4['blue']) / 4); $color = imagecolorclosest($dst_img, $red, $green, $blue); imagesetpixel($dst_img, $i + $dst_x, $j + $dst_y, $color); } } } /** * Stores optimised icon images in icon file area. * * Since 2.9 this function will generate an icon in the same format as the original file when possible. * To counter that behaviour, you can use the argument $preferpng to generate a PNG icon. * * @param context $context * @param string $component * @param string filearea * @param int $itemid * @param string $originalfile * @param boolean $preferpng When true, it will try to generate a PNG file regardless of the original file. * @return mixed new unique revision number or false if not saved */ function process_new_icon($context, $component, $filearea, $itemid, $originalfile, $preferpng = false) { global $CFG; if (!is_file($originalfile)) { return false; } $imageinfo = getimagesize($originalfile); $imagefnc = ''; if (empty($imageinfo)) { return false; } $image = new stdClass(); $image->width = $imageinfo[0]; $image->height = $imageinfo[1]; $image->type = $imageinfo[2]; $t = null; switch ($image->type) { case IMAGETYPE_GIF: if (function_exists('imagecreatefromgif')) { $im = imagecreatefromgif($originalfile); } else { debugging('GIF not supported on this server'); return false; } // Guess transparent colour from GIF. $transparent = imagecolortransparent($im); if ($transparent != -1) { $t = imagecolorsforindex($im, $transparent); } break; case IMAGETYPE_JPEG: if (function_exists('imagecreatefromjpeg')) { $im = imagecreatefromjpeg($originalfile); } else { debugging('JPEG not supported on this server'); return false; } // If the user uploads a jpeg them we should process as a jpeg if possible. if (!$preferpng && function_exists('imagejpeg')) { $imagefnc = 'imagejpeg'; $imageext = '.jpg'; $filters = null; // Not used. $quality = 90; } break; case IMAGETYPE_PNG: if (function_exists('imagecreatefrompng')) { $im = imagecreatefrompng($originalfile); } else { debugging('PNG not supported on this server'); return false; } break; default: return false; } // The conversion has not been decided yet, let's apply defaults (png with fallback to jpg). if (empty($imagefnc)) { if (function_exists('imagepng')) { $imagefnc = 'imagepng'; $imageext = '.png'; $filters = PNG_NO_FILTER; $quality = 1; } else if (function_exists('imagejpeg')) { $imagefnc = 'imagejpeg'; $imageext = '.jpg'; $filters = null; // Not used. $quality = 90; } else { debugging('Jpeg and png not supported on this server, please fix server configuration'); return false; } } if (function_exists('imagecreatetruecolor')) { $im1 = imagecreatetruecolor(100, 100); $im2 = imagecreatetruecolor(35, 35); $im3 = imagecreatetruecolor(512, 512); if ($image->type != IMAGETYPE_JPEG and $imagefnc === 'imagepng') { if ($t) { // Transparent GIF hacking... $transparentcolour = imagecolorallocate($im1 , $t['red'] , $t['green'] , $t['blue']); imagecolortransparent($im1 , $transparentcolour); $transparentcolour = imagecolorallocate($im2 , $t['red'] , $t['green'] , $t['blue']); imagecolortransparent($im2 , $transparentcolour); $transparentcolour = imagecolorallocate($im3 , $t['red'] , $t['green'] , $t['blue']); imagecolortransparent($im3 , $transparentcolour); } imagealphablending($im1, false); $color = imagecolorallocatealpha($im1, 0, 0, 0, 127); imagefill($im1, 0, 0, $color); imagesavealpha($im1, true); imagealphablending($im2, false); $color = imagecolorallocatealpha($im2, 0, 0, 0, 127); imagefill($im2, 0, 0, $color); imagesavealpha($im2, true); imagealphablending($im3, false); $color = imagecolorallocatealpha($im3, 0, 0, 0, 127); imagefill($im3, 0, 0, $color); imagesavealpha($im3, true); } } else { $im1 = imagecreate(100, 100); $im2 = imagecreate(35, 35); $im3 = imagecreate(512, 512); }
< $cx = $image->width / 2; < $cy = $image->height / 2;
> $cx = floor($image->width / 2); > $cy = floor($image->height / 2);
if ($image->width < $image->height) { $half = floor($image->width / 2.0); } else { $half = floor($image->height / 2.0); } imagecopybicubic($im1, $im, 0, 0, $cx - $half, $cy - $half, 100, 100, $half * 2, $half * 2); imagecopybicubic($im2, $im, 0, 0, $cx - $half, $cy - $half, 35, 35, $half * 2, $half * 2); imagecopybicubic($im3, $im, 0, 0, $cx - $half, $cy - $half, 512, 512, $half * 2, $half * 2); $fs = get_file_storage(); $icon = array('contextid'=>$context->id, 'component'=>$component, 'filearea'=>$filearea, 'itemid'=>$itemid, 'filepath'=>'/');
> if ($imagefnc === 'imagejpeg') { ob_start(); > // Function imagejpeg() accepts less arguments than imagepng() but we need to make $imagefnc accept the same if (!$imagefnc($im1, NULL, $quality, $filters)) { > // number of arguments, otherwise PHP8 throws an error. // keep old icons > $imagefnc = function($image, $filename, $quality, $unused) { ob_end_clean(); > return imagejpeg($image, $filename, $quality); return false; > }; } > } $data = ob_get_clean(); >
imagedestroy($im1); $icon['filename'] = 'f1'.$imageext; $fs->delete_area_files($context->id, $component, $filearea, $itemid); $file1 = $fs->create_file_from_string($icon, $data); ob_start(); if (!$imagefnc($im2, NULL, $quality, $filters)) { ob_end_clean(); $fs->delete_area_files($context->id, $component, $filearea, $itemid); return false; } $data = ob_get_clean(); imagedestroy($im2); $icon['filename'] = 'f2'.$imageext; $fs->create_file_from_string($icon, $data); ob_start(); if (!$imagefnc($im3, NULL, $quality, $filters)) { ob_end_clean(); $fs->delete_area_files($context->id, $component, $filearea, $itemid); return false; } $data = ob_get_clean(); imagedestroy($im3); $icon['filename'] = 'f3'.$imageext; $fs->create_file_from_string($icon, $data); return $file1->get_id(); } /** * Resize an image from an image path. * * This maintains the aspect ratio of the image. * This will not enlarge the image. * * @param string $filepath The full path to the original image file. * @param int|null $width The max width of the resized image, or null to only use the height. * @param int|null $height The max height of the resized image, or null to only use the width. * @param bool $forcecanvas Whether the final dimensions should be set to $width and $height. * @return string|bool False if a problem occurs, else the resized image data. */ function resize_image($filepath, $width, $height, $forcecanvas = false) { if (empty($filepath)) { return false; } // Fetch the image information for this image. $imageinfo = @getimagesize($filepath); if (empty($imageinfo)) { return false; } // Create a new image from the file. $original = @imagecreatefromstring(file_get_contents($filepath)); // Generate the thumbnail. return resize_image_from_image($original, $imageinfo, $width, $height, $forcecanvas); } /** * Resize an image from an image object. *
< * @param resource $original The image to work on.
> * @param resource|\GdImage $original The image to work on.
* @param array $imageinfo Contains [0] => originalwidth, [1] => originalheight. * @param int|null $width The max width of the resized image, or null to only use the height. * @param int|null $height The max height of the resized image, or null to only use the width. * @param bool $forcecanvas Whether the final dimensions should be set to $width and $height. * @return string|bool False if a problem occurs, else the resized image data. */ function resize_image_from_image($original, $imageinfo, $width, $height, $forcecanvas = false) { global $CFG; if (empty($width) && empty($height) || ($forcecanvas && (empty($width) || empty($height)))) { // We need do not have the required ddimensions to work with. return false; } if (empty($imageinfo)) { return false; } $originalwidth = $imageinfo[0]; $originalheight = $imageinfo[1]; if (empty($originalwidth) or empty($originalheight)) { return false; } if (function_exists('imagepng')) { $imagefnc = 'imagepng'; $filters = PNG_NO_FILTER; $quality = 1; } else if (function_exists('imagejpeg')) { $imagefnc = 'imagejpeg'; $filters = null; $quality = 90; } else { debugging('Neither JPEG nor PNG are supported at this server, please fix the system configuration.'); return false; } if (empty($height)) { $ratio = $width / $originalwidth; } else if (empty($width)) { $ratio = $height / $originalheight; } else { $ratio = min($width / $originalwidth, $height / $originalheight); } if ($ratio < 1) { $targetwidth = floor($originalwidth * $ratio); $targetheight = floor($originalheight * $ratio); } else { // Do not enlarge the original file if it is smaller than the requested thumbnail size. $targetwidth = $originalwidth; $targetheight = $originalheight; } $canvaswidth = $targetwidth; $canvasheight = $targetheight; $dstx = 0; $dsty = 0; if ($forcecanvas) { $canvaswidth = $width; $canvasheight = $height; $dstx = floor(($width - $targetwidth) / 2); $dsty = floor(($height - $targetheight) / 2); } if (function_exists('imagecreatetruecolor')) { $newimage = imagecreatetruecolor($canvaswidth, $canvasheight); if ($imagefnc === 'imagepng') { imagealphablending($newimage, false); imagefill($newimage, 0, 0, imagecolorallocatealpha($newimage, 0, 0, 0, 127)); imagesavealpha($newimage, true); } } else { $newimage = imagecreate($canvaswidth, $canvasheight); } imagecopybicubic($newimage, $original, $dstx, $dsty, 0, 0, $targetwidth, $targetheight, $originalwidth, $originalheight);
> > if ($imagefnc === 'imagejpeg') { // Capture the image as a string object, rather than straight to file. > // Function imagejpeg() accepts less arguments than imagepng() but we need to make $imagefnc accept the same ob_start(); > // number of arguments, otherwise PHP8 throws an error. if (!$imagefnc($newimage, null, $quality, $filters)) { > $imagefnc = function($image, $filename, $quality, $unused) { ob_end_clean(); > return imagejpeg($image, $filename, $quality); return false; > }; } > }
$data = ob_get_clean(); imagedestroy($original); imagedestroy($newimage); return $data; } /** * Generates a thumbnail for the given image * * If the GD library has at least version 2 and PNG support is available, the returned data * is the content of a transparent PNG file containing the thumbnail. Otherwise, the function * returns contents of a JPEG file with black background containing the thumbnail. * * @param string $filepath the full path to the original image file * @param int $width the width of the requested thumbnail * @param int $height the height of the requested thumbnail * @return string|bool false if a problem occurs, the thumbnail image data otherwise */ function generate_image_thumbnail($filepath, $width, $height) { return resize_image($filepath, $width, $height, true); } /** * Generates a thumbnail for the given image string. * * If the GD library has at least version 2 and PNG support is available, the returned data * is the content of a transparent PNG file containing the thumbnail. Otherwise, the function * returns contents of a JPEG file with black background containing the thumbnail. * * @param string $filedata The image content as a string * @param int $width the width of the requested thumbnail * @param int $height the height of the requested thumbnail * @return string|bool false if a problem occurs, the thumbnail image data otherwise */ function generate_image_thumbnail_from_string($filedata, $width, $height) { if (empty($filedata) or empty($width) or empty($height)) { return false; } // Fetch the image information for this image. $imageinfo = @getimagesizefromstring($filedata); if (empty($imageinfo)) { return false; } // Create a new image from the file. $original = @imagecreatefromstring($filedata); // Generate the thumbnail. return generate_image_thumbnail_from_image($original, $imageinfo, $width, $height); } /** * Generates a thumbnail for the given image string. * * If the GD library has at least version 2 and PNG support is available, the returned data * is the content of a transparent PNG file containing the thumbnail. Otherwise, the function * returns contents of a JPEG file with black background containing the thumbnail. * * @param resource $original The image to work on. * @param array $imageinfo Contains [0] => originalwidth, [1] => originalheight. * @param int $width The width of the requested thumbnail. * @param int $height The height of the requested thumbnail. * @return string|bool False if a problem occurs, the thumbnail image data otherwise. */ function generate_image_thumbnail_from_image($original, $imageinfo, $width, $height) { return resize_image_from_image($original, $imageinfo, $width, $height, true); }