imagettftextgradient
Description
imagettftextgradient is a drop-in replacement for imagettftext with added parameters to add gradient coloring effects to your PHP GD images.
imagettftextgradient is an agjgd project.
Usage
With Composer
This project offers support for the Composer dependency manager. You can find the imagettftextgradient package online on packagist.org.
Install using Composer
Either run this command:
composer require andrewgjohnson/imagettftextgradient
or add this to the require section of your composer.json file:
"andrewgjohnson/imagettftextgradient": "1.*"
Without Composer
To use without Composer add an include to the imagettftextgradient.php source file.
include_once 'source/imagettftextgradient.php';
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
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string, array()); // This works the same as the line above
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string, array(), $secondColor); // This will add the same text only with a vertical gradient instead of a solid color
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string, array(), $secondColor, true); // This will add the same text only with a horizontal gradient instead of a solid color
// 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
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string); // This works the same as the line above
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string, $secondColor); // This will add the same text only with a vertical gradient instead of a solid color
imagettftextgradient($im, 20, 0, 0, 0, $color, $font, $string, $secondColor, true); // This will add the same text only with a horizontal gradient instead of a solid color
There are other examples included in the GitHub repository and on imagettftextgradient.agjgd.org.
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 template.
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 imagettftextgradient and other agjgd.org projects.
Acknowledgements
This project was started by Andrew G. Johnson (@andrewgjohnson).
Full list of contributors:
Our security policies and procedures comes via the atomist/samples project. Our issue templates comes via the tensorflow/tensorflow project. Our pull request template comes via the stevemao/github-issue-templates project. The mountains photo comes via Gabriel Garcia Marengo.
Changelog
You can find all notable changes in the changelog.