Download the PHP package net-tools/gd-indexed-color-converter without Composer
On this page you can find all versions of the php package net-tools/gd-indexed-color-converter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download net-tools/gd-indexed-color-converter
More information about net-tools/gd-indexed-color-converter
Files in net-tools/gd-indexed-color-converter
Package gd-indexed-color-converter
Short Description Composer library gd-indexed-color-converter
License MIT
Informations about the package gd-indexed-color-converter
GDIndexedColorConverter
GDIndexedColorConverter is a simple library that convert an image into indexed color mode. With indexed color mode, an image can be displayed with only a few specific colors.
To archieve image dithering effect, GDIndexedColorConverter uses [Floyd–Steinberg dithering] (http://en.wikipedia.org/wiki/Floyd%E2%80%93Steinberg_dithering) algorithm to apply error diffusion of each pixel onto its neighboring pixels.
Requirements
Since GDIndexedColorConverter uses some functions of the
GD extension, you need to the enable GD extension
in the PHP configuration file (php.ini
).
Usage
GDIndexedColorConverter provide a function named convertToIndexedColor
to convert an image
into indexed color mode, it accepts three parameters(listed below), and return a new image
resource of indexed color mode.
-
im
(imageresource) The image resource created by the functions of GD library. -
palette
(array) The palette which contains all the specific colors that the indexed-color-mode image will use. This parameter is an array which stores all the colors, each color is an indexed array that consists of red, green and blue color channel values. dither
(float) How much the Floyd–Steinberg dithering algorithm will affect the image. This parameter is optional, its default value is 0.75, and the value must be between 0 and 1.
Code example:
Dithers
Applying different dither values on indexed-color images, you can get various image effects.
In the example
folder, there is a simple example that creates three indexed images with
different dither values(0.2, 0.4, 0.8) and five colors(white, black, red, green and blue).
The example image shell.jpg
is
created by @sage_solar. The image is under
Creative Commons License.
License
GDIndexedColorConverter is licensed under the [MIT license] (https://raw.githubusercontent.com/ccpalettes/gd-indexed-color-converter/master/LICENSE).