* Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in the * Software without restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the * Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * * PHP version 5 * * @category Andrewgjohnson * @package Imagettftextblur * @author Andrew G. Johnson * @copyright 2013-2022 Andrew G. Johnson * @license https://opensource.org/licenses/mit/ The MIT License * @link https://github.com/andrewgjohnson/imagettftextblur */ if (!function_exists('imagettftextblur')) { /** * Imagettftextblur is a drop in replacement for imagettftext with added * parameters to add blur, glow and shadow effects to your PHP GD images. * * @param resource $image

An image resource, returned by one of the * image creation functions, such as imagecreatetruecolor().

* @param float $size

The font size. Depending on your version * of GD, this should be specified as the pixel size (GD1) or point size * (GD2).

* @param float $angle

The angle in degrees, with 0 degrees being * left-to-right reading text. Higher values represent a counter-clockwise * rotation. For example, a value of 90 would result in bottom-to-top reading * text.

* @param int $x

The coordinates given by x and y will * define the basepoint of the first character (roughly the lower-left corner * of the character). This is different from the imagestring(), where x and y * define the upper-left corner of the first character. For example, "top * left" is 0, 0.

* @param int $y

The y-ordinate. This sets the position of * the fonts baseline, not the very bottom of the character.

* @param int $color

The color index. Using the negative of a * color index has the effect of turning off antialiasing. See * imagecolorallocate().

* @param string $fontfile

The path to the TrueType font you wish to * use.

Depending on which version of the GD library PHP is using, when * fontfile does not begin with a leading / then .ttf will be appended to the * filename and the library will attempt to search for that filename along a * library-defined font path.

When using versions of the GD library * lower than 2.0.18, a space character, rather than a semicolon, was used as * the 'path separator' for different font files. Unintentional use of this * feature will result in the warning message: Warning: Could not find/open * font. For these affected versions, the only solution is moving the font to * a path which does not contain spaces.

* @param string $text

The text string in UTF-8 encoding.

May include decimal numeric character references (of the form: * €) to access characters in a font beyond position 127. The * hexadecimal format (like ©) is supported.Strings in UTF-8 * encoding can be passed directly.

Named entities, such as ©, * are not supported. Consider using html_entity_decode to decode these * named entities into UTF-8 strings.

If a character is used in the * string which is not supported by the font, a hollow rectangle will * replace the character.

* @param int $blur_intensity

The number of times you would like to * apply your filter to your text (default is zero)

* @param int $blur_filter

The filter you would like applied to your * text (default is IMG_FILTER_GAUSSIAN_BLUR)

* * @return mixed Returns an array with 8 elements representing four points * making the bounding box of the text. The order of the points is lower left, * lower right, upper right, upper left. The points are relative to the text * regardless of the angle, so "upper left" means in the top left-hand corner * when you see the text horizontally. Returns FALSE on error. */ function imagettftextblur( &$image, $size, $angle, $x, $y, $color, $fontfile, $text, $blur_intensity = 0, $blur_filter = IMG_FILTER_GAUSSIAN_BLUR ) { // $blur_intensity needs to be an integer greater than zero; if it is not we // treat this function call identically to imagettftext if (is_int($blur_intensity) && $blur_intensity > 0) { // $return_array will be returned once all calculations are complete $return_array = [ imagesx($image), // lower left, x coordinate -1, // lower left, y coordinate -1, // lower right, x coordinate -1, // lower right, y coordinate -1, // upper right, x coordinate imagesy($image), // upper right, y coordinate imagesx($image), // upper left, x coordinate imagesy($image) // upper left, y coordinate ]; // $temporary_image is a GD image that is the same size as our // original GD image $temporary_image = imagecreatetruecolor( imagesx($image), imagesy($image) ); // fill $temporary_image with a black background imagefill( $temporary_image, 0, 0, imagecolorallocate($temporary_image, 0x00, 0x00, 0x00) ); // add white text to $temporary_image with the function call's // parameters imagettftext( $temporary_image, $size, $angle, $x, $y, imagecolorallocate($temporary_image, 0xFF, 0xFF, 0xFF), $fontfile, $text ); // execute the blur filters for ($blur = 1; $blur <= $blur_intensity; $blur++) { imagefilter($temporary_image, $blur_filter); } // set $color_opacity based on $color's transparency $color_opacity = imagecolorsforindex($image, $color)['alpha']; $color_opacity = (127 - $color_opacity) / 127; // loop through each pixel in $temporary_image for ($_x = 0; $_x < imagesx($temporary_image); $_x++) { for ($_y = 0; $_y < imagesy($temporary_image); $_y++) { // $visibility is the grayscale of the current pixel multiplied // by $color_opacity $visibility = (imagecolorat( $temporary_image, $_x, $_y ) & 0xFF) / 255 * $color_opacity; // if the current pixel would not be invisible then add it to // $image if ($visibility > 0) { // we know we are on an affected pixel so ensure // $return_array is updated accordingly $return_array[0] = min($return_array[0], $_x); $return_array[1] = max($return_array[1], $_y); $return_array[2] = max($return_array[2], $_x); $return_array[3] = max($return_array[3], $_y); $return_array[4] = max($return_array[4], $_x); $return_array[5] = min($return_array[5], $_y); $return_array[6] = min($return_array[6], $_x); $return_array[7] = min($return_array[7], $_y); // set the current pixel in $image imagesetpixel( $image, $_x, $_y, imagecolorallocatealpha( $image, ($color >> 16) & 0xFF, ($color >> 8) & 0xFF, $color & 0xFF, (1 - $visibility) * 127 ) ); } } } // destroy our $temporary_image imagedestroy($temporary_image); return $return_array; } else { return imagettftext( $image, $size, $angle, $x, $y, $color, $fontfile, $text ); } } }