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

imagettftextblur

Description

imagettftextblur is a drop in replacement for imagettftext with added parameters to add blur, glow and shadow effects to your PHP GD images.

imagettftextblur is an agjgd.org project.

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": "1.*"

Without Composer

To use without Composer add an include to the imagettftextblur.php source file.

include_once 'source/imagettftextblur.php';

Examples

// standard method to add text to a GD image
imagettftext($im, 20, 0, 0, 0, $color, $font, $string);

// this will work the exact same as the line above
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string);

// method to add blurred text to a GD image
imagettftextblur($im, 20, 0, 0, 0, $color, $font, $string, 1);

There are other examples included in the GitHub repository and on imagettftextblur.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 imagettftextblur and other agjgd.org projects.

Acknowledgements

This project was started by Andrew G. Johnson (@andrewgjohnson).

Full list of contributors:

• Andrew G. Johnson (@andrewgjohnson)
• Philip van Heemstra (@vHeemstra)

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.

imagettftextblur's Issues

Move the changelog out of README.md and into its own file

Add an issue template

https://help.github.com/articles/creating-an-issue-template-for-your-repository/

Multiple blur effects

Instead of always using IMG_FILTER_GAUSSIAN_BLUR set it up as a parameter

Add a pull request template

https://help.github.com/articles/creating-a-pull-request-template-for-your-repository/

Change dirname(__FILE__) references to __DIR__

http://php.net/manual/en/language.constants.predefined.php

Return value

Emulate return value of imagettftext--should be an array of coordinates for a success and false for a failure

Add a code of conduct

https://help.github.com/articles/adding-a-code-of-conduct-to-your-project/

Rewrite parameter descriptions

The first eight parameters are the same as PHP's imagettftext and since php.net has updated their parameter descriptions with better names we should follow suit.

Code review examples and ensure $text_(left|right|top|bottom) are all functioning and set correctly

I believe there is a typo or mislabeling of these variables (which were then copy/pasted into all other examples)

Please check and confirm all are correct or provide a bugfix

$color parameter ignores alpha

If you pass a color using imagecolorallocatealpha() rather than imagecolorallocate() the alpha level is ignored and a full 100% visible color is used

[Feature Request]: Update examples to work out of the box with Composer

Contact Details

No response

Describe the new feature versus the current behaviour

Right now we check file_exists('../source/imagettftextblur.php') but should add some kind of handling for function_exists('imagettftextblur') in the event the code has already loaded the function [presumably via Composer]

Is there any risk this change will not be backwards compatible with current integrations?

No response

Any other information

No response

Add contributing guidelines

https://help.github.com/articles/setting-guidelines-for-repository-contributors/

Confirm minimum PHP version

I believe using square bracket method for arrays ($x=[]; rather than $x=array();) requires at least PHP 5.4. Confirm whether or not this is the case & update the repo accordingly. If true, either the composer config needs to be updated or we need to stop using the square bracket method.

Setup GitHub Pages for this repository