andrewgjohnson / imagettftextblur
imagettftextblur is a drop-in replacement for imagettftext with added parameters to add blur, glow and shadow effects to your PHP GD images
Package info
github.com/andrewgjohnson/imagettftextblur
pkg:composer/andrewgjohnson/imagettftextblur
Requires
- php: >=8.0.0
- ext-gd: *
- andrewgjohnson/agjgd: ^2.0
Requires (Dev)
- phpunit/phpunit: ^12.5
- squizlabs/php_codesniffer: ^3.13
README
Description
imagettftextblur is a drop-in replacement for imagettftext with added parameters to add blur, glow and shadow effects to your PHP GD images.
As of v2.0.0 imagettftextblur is part of AgjGd. The implementation now lives in the \AndrewGJohnson\AgjGd class provided by the andrewgjohnson/agjgd package, and this package provides the standalone imagettftextblur() function as a thin reverse-compatibility wrapper around it.
New code should call \AndrewGJohnson\AgjGd::imagettftextblur() directly.
imagettftextblur is an agjgd project.
Examples
// In PHP 8.0 a ninth parameter ($options) was added to imagettftext()
imagettftext($im, 20, 0, 0, 0, $color, $font, $string, array()); // Add text to a GD image
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string, array()); // This works the same as the line above
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string, array(), 1); // This will add the same text only blurred
// We also support previous versions of PHP back to 5.0 and the previous version of imagettftext()
imagettftext($im, 20, 0, 0, 0, $color, $font, $string); // Add text to a GD image
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string); // This works the same as the line above
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string, 1); // This will add the same text only blurred
There are other examples included in the GitHub repository and on imagettftextblur.agjgd.org.
Usage
With Composer
This project offers support for the Composer dependency manager. You can find the imagettftextblur package online on packagist.org.
Install using Composer
Either run this command:
composer require andrewgjohnson/imagettftextblur
or add this to the require section of your composer.json file:
"andrewgjohnson/imagettftextblur": "^2.0"
This package requires PHP 8.0 or newer, the GD extension and the andrewgjohnson/agjgd package, which Composer installs automatically.
Without Composer
Because imagettftextblur() now forwards to the \AndrewGJohnson\AgjGd class, you need both this wrapper and AgjGd. Composer is the recommended way to install them, but you can also require both source files directly:
require_once 'path/to/agjgd/source/AndrewGJohnson/AgjGd.php';
require_once 'source/imagettftextblur.php';
Help Requests
Please post any questions in the discussions area on GitHub if you need help.
If you discover a bug please enter an issue on GitHub. When submitting an issue please use our issue templates.
Contributing
Please read our contributing guidelines if you want to contribute.
You can contribute financially by becoming a patron at patreon.com/agjopensource to support imagettftextblur and other agjgd.org projects.
Acknowledgements
This project was started by Andrew G. Johnson (@andrewgjohnson).
Full list of contributors:
Our security policies and procedures come via the atomist/samples project. Our issue templates come via the tensorflow/tensorflow project. Our pull request template comes via the stevemao/github-issue-templates project. The Jekyll theme was released by Andrew G. Johnson.
Changelog
You can find all notable changes in the changelog.
