imageblendedcolorallocate is a function that will allocate a new blended color based on two existing allocated colors for your PHP GD images

v1.0.2 2022-11-23 00:08 UTC

This package is auto-updated.

Last update: 2024-07-01 00:14:23 UTC



MIT License Current Release GitHub Stars Contributors Packagist Downloads Issues Patreon


imageblendedcolorallocate is a function that will allocate a new blended color based on two existing allocated colors for your PHP GD images.

Patreon - Become a Patron

imageblendedcolorallocate is an project.


With Composer

This project offers support for the Composer dependency manager. You can find the imageblendedcolorallocate package online on

Install using Composer

Either run this command:

composer require andrewgjohnson/imageblendedcolorallocate

or add this to the require section of your composer.json file:

"andrewgjohnson/imageblendedcolorallocate": "1.*"

Without Composer

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

include_once 'source/imageblendedcolorallocate.php';


// standard method to allocate a color for an image
$red = imagecolorallocate($im, 0xFF, 0x00, 0x00);
$yellow = imagecolorallocate($im, 0xFF, 0xFF, 0x00);

// this will allocate an average of our two previously allocated colors
$orange = imageblendedcolorallocate($im, $red, $yellow);

// yes, we do support alpha if you want to use transparent or translucent colors
$opaqueBlack = imagecolorallocatealpha($im, 0x00, 0x00, 0x00, 0);
$translucentBlack = imagecolorallocatealpha($im, 0x00, 0x00, 0x00, 63);
$blendedBlack = imageblendedcolorallocate($im, $opaqueBlack, $translucentBlack);

// by default we do a 50/50 blend where we average the red, blue, green & alpha values for each color
// we also support non-50/50 blends
$blue = imagecolorallocate($im, 0x00, 0x00, 0xFF);
$cyan = imagecolorallocate($im, 0x00, 0xFF, 0xFF);
$blendedMostlyCyan = imageblendedcolorallocate($im, $blue, $cyan, 0.25); // 25% blue, 75% cyan
$blendedEvenly = imageblendedcolorallocate($im, $blue, $cyan); // 50% blue, 50% cyan
$blendedMostlyBlue = imageblendedcolorallocate($im, $blue, $cyan, 0.75); // 75% blue, 25% cyan

There are other examples included in the GitHub repository and on

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.


Please read our contributing guidelines if you want to contribute.

You can contribute financially by becoming a patron at to support imageblendedcolorallocate and other projects.

Patreon - Become a Patron


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.


You can find all notable changes in the changelog.