MasterPress

Menu

WOOF_Image :: colorize( String $color, Arguments $attr = array(), $ )

Returns:

  • WOOF_Image A new image object representing the image with filter applied.

Colorizes the image, with a given color (while retaining the other colors in the image), and caches the result in the image cache.

Given the following unprocessed image:

The example code produces these images:

A more useful function might be the WOOF_Image::tint method, which applies a grayscale filter before colorizing the image, which produces a generally nicer effect.

Example:

Parameters:

  • String $color

    A 3 or 6 length hex string describing the color to use (3-length uses the same repeating convention as CSS), with or without hash.

  • Arguments $attr = array()

    An arguments string or array which supports the following parameters:

    • extension – the output extension to use, which also defines the output file type. This can be either “png”, “gif”, “jpeg”, or “jpg”, and if not set, the source image type will be used. default – not set
    • alpha – whether to save alpha information for PNGs – default true
    • prefix – a prefix to prepend to the cached output file name – default ”
    • suffix – a suffix to append to the end of the cached output file name – default ”
    • maxlength – the maximum length the output file name (sans-extension) can be before it will be replaced with the original filename followed by an md5 hash of all of the manipulations thus far. default – 72

    Note that the maxlength param can be important, as chaining multiple filters or resizes together can result in very long file names for the cached images.

  • $

Related Methods:

WOOF_Image::parse_color

Latest From the Blog

MasterPress 1.3.8 is now available

16th December 2022

MasterPress 1.3.8 is a bugfix release. Fixed a bug where MB, KB, and GB were being converted to bytes incorrectly via WOOF file functions. Fixed a bug where transparent images were losing their transparency on resize.

Plugin Requirements

MasterPress requires a minimum of WordPress version 4.9, MySQL 5.6, and PHP version 5.6.20.

We also recommend that PHP is configured to use a memory limit of 64MB per request (128MB may be required for sites with higher complexity).

This plug-in is not compatible with the WordPress.com hosted service.

Three AM