WOOF_Image

Extends WOOF_File

Methods

A powerful class representing an image file within your WordPress site, which offers resizing, cropping, and manipulation features.

Example: Some of the many ways to obtain a WOOF_Image

Example: Obtaining other objects that delegate to WOOF_Image

List of Methods

Magic Methods

Property Methods

  • attr( String $key = null, Mixed $val = null )String OR Array

    Gets or sets the attributes stored inside this image object, which are used to output HTML attributes.

  • bit()Integer

    Retrieves the bit-depth of the image.

  • exif()WOOF_EXIF

    Retrieves a WOOF_EXIF object representing the EXIF data in the image, if available.

  • height()Integer

    Retrieves the height of the image in pixels.

  • info()Array

    Retrieves an associative array of info about this image file.

  • is_landscape()Boolean

    Returns true if the image is a landscape orientation (width is larger than height).

  • is_portrait()Boolean

    Returns true if the image is a portrait orientation (height is larger than width).

  • is_square()Boolean

    Returns true if the image is square (width equals height).

  • orientation()String

    Returns a string representing the orientation of the image:“landscape” – if the image is wider than it is tall“portrait” – if the image is taller than it is wide“square” – if the image is of equal width and height.

  • width()Integer

    Retrieves the width of the image in pixels.

Manipulation

  • save_image( String $path, Resource $image, String $mime_type, Arguments $attr = array(), Boolean $destroy = true )

    A utility method used by this class to save an image resource to disk, auto-detecting the correct format and required PHP function needed to do so.Note: this method is intended for internal use.

Theming

  • fluid( Arguments $args = array() )String

    Returns an image tag that removes the width and height attributes, for use with responsive image techniques.

  • html( Arguments $attr = array() )String

    An alias for the WOOF_Image::tag method to generate an HTML tag for the image.

  • picture( Arguments $args )String

    Outputs markup for use with the picturefill responsive images library by Scott Jehl, which allows you to specify a number of images to use at different media query breakpoints, as well as images for high-resolution displays. This method accepts a number of shorthand argument keys to quickly output the necessary media query min-width, max-width, and min-device-pixel ratio media query declarations, as well as smart values for these keys to define either separate image files to use, or a resize operation on this image. Note: MasterPress includes the picturefill.js and matchmedia.js libraries which can be enqueued with the following identifiers, anytime before wp_head().wp_enqueue_script(‘mp-matchmedia’);wp_enqueue_script(‘mp-picturefill’);.

  • picture_2x( Arguments $args )String

    A preset on the WOOF_Image::picture method to output markup for use with the picturefill responsive images library by Scott Jehl.

  • tag( Arguments $attr = array() )String

    Retrieves an HTML tag for the image.

Image Processing

  • crop( Arguments $args = array() )WOOF_Image

    A preset on the WOOF_Image::resize method which uses the argument “c=2” which will crop the image to a specified width and height without scaling the image.

  • generate( Arguments $args = array() )WOOF_Image

    An alias for the WOOF_Image::resize method to resize an image, with various cropping options.

  • res()Resource

    A convenience method to retrieve the GD image resource for the image this file represents.

  • resample( Arguments $args = array() )WOOF_Image

    An alias for woof-image which is a more appropriate method name when we just want to change the jpeg quality without resizing.

  • resize( Arguments $args = array() )WOOF_Image

    A highly useful method to resize an image, and cache the result in the image cache.

  • thumb( Arguments $args = array() )WOOF_Image

    An alias for WOOF_Image::resize to resize an image, and cache the result in the image cache.

Image Filters

  • blur( Arguments $attr = array() )WOOF_Image

    A more concise alias for the WOOF_Image::selective_blur filter to apply a selective blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • brightness( Integer $val, Arguments $attr = array() )WOOF_Image

    Adjusts the brightness of the image, and caches the result in the image cache.

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

    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.

  • contrast( Integer $val, Arguments $attr = array() )WOOF_Image

    Adjusts the brightness of the image, and caches the result in the image cache.

  • convolute( Array $matrix, Arguments $attr = array(), Float $offset = 0 )WOOF_Image

    Applies a convolution filter to the image, using the imageconvolution PHP function.

  • edgedetect( Arguments $attr = array() )WOOF_Image

    Creates an image based on edge detection of the source, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • emboss( Arguments $attr = array() )WOOF_Image

    Creates an embossed-look version of the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • gaussian_blur( Arguments $attr = array() )WOOF_Image

    Applies a gaussian blur to the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • gblur( Arguments $attr = array() )WOOF_Image

    A more concise alias for the WOOF_Image::gaussian_blur method (“gaussian” is rather annoying to type), to apply a gaussian blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • grayscale( Arguments $attr = array() )WOOF_Image

    Removes the color from the image, and caches the result in the image cache.Given the following unprocessed image:The example code produces this image:.

  • laplace( Arguments $attr = array() )WOOF_Image

    Applies a laplace effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • laplace_diag( Arguments $attr = array() )WOOF_Image

    Applies a laplace diagonal effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • mean_removal( Arguments $attr = array() )WOOF_Image

    Applies a mean removal effect (giving a “sketched” appearance) to the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • pixelate( Integer $block_size, Boolean $advanced = false, Arguments $attr = array() )WOOF_Image

    Generates a pixelated version of the image, and caches the result in the image cache.Given the following unprocessed image:   The example code produces these images:.

  • selective_blur( Arguments $attr = array() )WOOF_Image

    The WOOF_Image::selective_blur filter to apply a selective blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • sepia( String $color = #5f370e, Arguments $attr = array() )WOOF_Image

    A specialisation of the WOOF_Image::tint method, to create a sepia-tone effect on the image, and save the result to the image cache.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 this image: .

  • sharpen( Arguments $attr = array() )WOOF_Image

    Sharpens an image via convolution, and caches the result.Given the following unprocessed image:  The example code produces this image:.

  • sketchy( Arguments $attr = array() )WOOF_Image

    An alias for the WOOF_Image::mean_removal to give the image a “sketched” appearance, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • smooth( Integer $val, Arguments $attr = array() )WOOF_Image

    Smooths the image, and caches the result in the image cache. Given the following unprocessed image:   The example code produces these images:.

  • sobel( Arguments $attr = array() )WOOF_Image

    Applies a sobel effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • tint( String $color = #5f370e, Arguments $attr = array() )WOOF_Image

    Applies a grayscale filter and then colorize to generate a tinted effect on the image, and saves the result to the image cache.Given the following unprocessed image:The example code produces these images: .

Image Effects

  • border( Arguments $attr = array() )WOOF_Image

    Generates a solid color border around the image.Given the following unprocessed image:  The example code produces the images below:.

  • reflection( Arguments $attr = array() )WOOF_Image

    Generates an upside down reflection underneath the image, giving the appearance of the image resting on a glossy surface, and caches the result in the image cache.Given the following unprocessed image:   The example code produces these images:.

  • watermark( WOOF_Image $watermark, Arguments $attr = array() )WOOF_Image

    A powerful method to apply another image as a watermark on top of this image, and then cache the result in the image cache. Given the following two images (marked $play and $cat in the example code respectively): The example code produces the following images:.

Utility

Column Listings

  • mp_thumb( Arguments $args = array() )String

    Creates a thumbnail link to the fullsize image which is intended to be augmented with the JavaScript fancyzoom plugin bundled with MasterPress  (mp_thumb abbreviates MasterPress Thumbnail).

  • mt( Arguments $args = array() )String

    An alias for the WOOF_Image::mp_thumb to create a thumbnail link to the fullsize image which is intended to be augmented with the JavaScript fancyzoom plugin bundled with MasterPress (mt abbreviates “MasterPress Thumbnail”).

Internal Use

  • cacheinfo( Arguments $attr = array() )Array

    Returns an associative array describing the path and URL of an output image, given the arguments passed.

  • filter( Integer $filter, Arguments $attr = array(), Array $args = array() )WOOF_Image

    A utility method that handles all of the code to call a PHP image filter via the imagefilter function.

  • get_at_coord( Integer $dw, Integer $dh, Integer $sw, Integer $sh, String $at = c )Array

    Gets co-ordinates to use for the anchoring points usable by the WOOF_Image::watermark method to determine where the watermark is placed.Note: this method is intended for internal use.

  • get_offset( Integer $inset, String $at = c )Array

    Gets offset co-ordinates for the anchoring points usable by the WOOF_Image::watermark method to determine where the watermark is placed.Note: this method is intended for internal use.

  • save_image( String $path, Resource $image, String $mime_type, Arguments $attr = array(), Boolean $destroy = true )

    A utility method used by this class to save an image resource to disk, auto-detecting the correct format and required PHP function needed to do so.Note: this method is intended for internal use.

  • sizeinfo()Array

    Retrieves size and other info for the image via PHP’s getimagesize function. Note: this method is intended for internal use.

  • __toString()String

    Implements the __toString PHP magic method to convert this object to an HTML tag when it is echoed.

  • attr( String $key = null, Mixed $val = null )String OR Array

    Gets or sets the attributes stored inside this image object, which are used to output HTML attributes.

  • bit()Integer

    Retrieves the bit-depth of the image.

  • blur( Arguments $attr = array() )WOOF_Image

    A more concise alias for the WOOF_Image::selective_blur filter to apply a selective blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • border( Arguments $attr = array() )WOOF_Image

    Generates a solid color border around the image.Given the following unprocessed image:  The example code produces the images below:.

  • brightness( Integer $val, Arguments $attr = array() )WOOF_Image

    Adjusts the brightness of the image, and caches the result in the image cache.

  • cacheinfo( Arguments $attr = array() )Array

    Returns an associative array describing the path and URL of an output image, given the arguments passed.

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

    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.

  • contrast( Integer $val, Arguments $attr = array() )WOOF_Image

    Adjusts the brightness of the image, and caches the result in the image cache.

  • convolute( Array $matrix, Arguments $attr = array(), Float $offset = 0 )WOOF_Image

    Applies a convolution filter to the image, using the imageconvolution PHP function.

  • crop( Arguments $args = array() )WOOF_Image

    A preset on the WOOF_Image::resize method which uses the argument “c=2” which will crop the image to a specified width and height without scaling the image.

  • edgedetect( Arguments $attr = array() )WOOF_Image

    Creates an image based on edge detection of the source, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • emboss( Arguments $attr = array() )WOOF_Image

    Creates an embossed-look version of the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • exif()WOOF_EXIF

    Retrieves a WOOF_EXIF object representing the EXIF data in the image, if available.

  • filter( Integer $filter, Arguments $attr = array(), Array $args = array() )WOOF_Image

    A utility method that handles all of the code to call a PHP image filter via the imagefilter function.

  • fluid( Arguments $args = array() )String

    Returns an image tag that removes the width and height attributes, for use with responsive image techniques.

  • gaussian_blur( Arguments $attr = array() )WOOF_Image

    Applies a gaussian blur to the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • gblur( Arguments $attr = array() )WOOF_Image

    A more concise alias for the WOOF_Image::gaussian_blur method (“gaussian” is rather annoying to type), to apply a gaussian blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • generate( Arguments $args = array() )WOOF_Image

    An alias for the WOOF_Image::resize method to resize an image, with various cropping options.

  • get_at_coord( Integer $dw, Integer $dh, Integer $sw, Integer $sh, String $at = c )Array

    Gets co-ordinates to use for the anchoring points usable by the WOOF_Image::watermark method to determine where the watermark is placed.Note: this method is intended for internal use.

  • get_offset( Integer $inset, String $at = c )Array

    Gets offset co-ordinates for the anchoring points usable by the WOOF_Image::watermark method to determine where the watermark is placed.Note: this method is intended for internal use.

  • grayscale( Arguments $attr = array() )WOOF_Image

    Removes the color from the image, and caches the result in the image cache.Given the following unprocessed image:The example code produces this image:.

  • height()Integer

    Retrieves the height of the image in pixels.

  • html( Arguments $attr = array() )String

    An alias for the WOOF_Image::tag method to generate an HTML tag for the image.

  • imagecopymerge_alpha( Resource $dst_im, Resource $src_im, Integer $dst_x, Integer $dst_y, Integer $src_x, Integer $src_y, Integer $src_w, Integer $src_h, Integer $pct, Array $trans = null )WOOF_Image

    Copy and merge part of an image, while respecting alpha channels. .

  • info()Array

    Retrieves an associative array of info about this image file.

  • is_landscape()Boolean

    Returns true if the image is a landscape orientation (width is larger than height).

  • is_portrait()Boolean

    Returns true if the image is a portrait orientation (height is larger than width).

  • is_square()Boolean

    Returns true if the image is square (width equals height).

  • laplace( Arguments $attr = array() )WOOF_Image

    Applies a laplace effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • laplace_diag( Arguments $attr = array() )WOOF_Image

    Applies a laplace diagonal effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • mean_removal( Arguments $attr = array() )WOOF_Image

    Applies a mean removal effect (giving a “sketched” appearance) to the image, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • mp_thumb( Arguments $args = array() )String

    Creates a thumbnail link to the fullsize image which is intended to be augmented with the JavaScript fancyzoom plugin bundled with MasterPress  (mp_thumb abbreviates MasterPress Thumbnail).

  • mt( Arguments $args = array() )String

    An alias for the WOOF_Image::mp_thumb to create a thumbnail link to the fullsize image which is intended to be augmented with the JavaScript fancyzoom plugin bundled with MasterPress (mt abbreviates “MasterPress Thumbnail”).

  • orientation()String

    Returns a string representing the orientation of the image:“landscape” – if the image is wider than it is tall“portrait” – if the image is taller than it is wide“square” – if the image is of equal width and height.

  • parse_color( Array / String $color )Array

    Parses a color string into an array containing an RGB array and a hex string representing the color.

  • parse_coord( String $pair )Array

    Parses an x,y coordinate string into an array made up of an x and y integer components.

  • picture( Arguments $args )String

    Outputs markup for use with the picturefill responsive images library by Scott Jehl, which allows you to specify a number of images to use at different media query breakpoints, as well as images for high-resolution displays. This method accepts a number of shorthand argument keys to quickly output the necessary media query min-width, max-width, and min-device-pixel ratio media query declarations, as well as smart values for these keys to define either separate image files to use, or a resize operation on this image. Note: MasterPress includes the picturefill.js and matchmedia.js libraries which can be enqueued with the following identifiers, anytime before wp_head().wp_enqueue_script(‘mp-matchmedia’);wp_enqueue_script(‘mp-picturefill’);.

  • picture_2x( Arguments $args )String

    A preset on the WOOF_Image::picture method to output markup for use with the picturefill responsive images library by Scott Jehl.

  • pixelate( Integer $block_size, Boolean $advanced = false, Arguments $attr = array() )WOOF_Image

    Generates a pixelated version of the image, and caches the result in the image cache.Given the following unprocessed image:   The example code produces these images:.

  • reflection( Arguments $attr = array() )WOOF_Image

    Generates an upside down reflection underneath the image, giving the appearance of the image resting on a glossy surface, and caches the result in the image cache.Given the following unprocessed image:   The example code produces these images:.

  • res()Resource

    A convenience method to retrieve the GD image resource for the image this file represents.

  • resample( Arguments $args = array() )WOOF_Image

    An alias for woof-image which is a more appropriate method name when we just want to change the jpeg quality without resizing.

  • resize( Arguments $args = array() )WOOF_Image

    A highly useful method to resize an image, and cache the result in the image cache.

  • save_image( String $path, Resource $image, String $mime_type, Arguments $attr = array(), Boolean $destroy = true )

    A utility method used by this class to save an image resource to disk, auto-detecting the correct format and required PHP function needed to do so.Note: this method is intended for internal use.

  • selective_blur( Arguments $attr = array() )WOOF_Image

    The WOOF_Image::selective_blur filter to apply a selective blur to the image, and cache the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • sepia( String $color = #5f370e, Arguments $attr = array() )WOOF_Image

    A specialisation of the WOOF_Image::tint method, to create a sepia-tone effect on the image, and save the result to the image cache.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 this image: .

  • sharpen( Arguments $attr = array() )WOOF_Image

    Sharpens an image via convolution, and caches the result.Given the following unprocessed image:  The example code produces this image:.

  • sizeinfo()Array

    Retrieves size and other info for the image via PHP’s getimagesize function. Note: this method is intended for internal use.

  • sketchy( Arguments $attr = array() )WOOF_Image

    An alias for the WOOF_Image::mean_removal to give the image a “sketched” appearance, and caches the result in the image cache.Given the following unprocessed image:  The example code produces this image:.

  • smooth( Integer $val, Arguments $attr = array() )WOOF_Image

    Smooths the image, and caches the result in the image cache. Given the following unprocessed image:   The example code produces these images:.

  • sobel( Arguments $attr = array() )WOOF_Image

    Applies a sobel effect to the image via convolution.Given the following unprocessed image:  The example code produces this image:.

  • tag( Arguments $attr = array() )String

    Retrieves an HTML tag for the image.

  • thumb( Arguments $args = array() )WOOF_Image

    An alias for WOOF_Image::resize to resize an image, and cache the result in the image cache.

  • tint( String $color = #5f370e, Arguments $attr = array() )WOOF_Image

    Applies a grayscale filter and then colorize to generate a tinted effect on the image, and saves the result to the image cache.Given the following unprocessed image:The example code produces these images: .

  • watermark( WOOF_Image $watermark, Arguments $attr = array() )WOOF_Image

    A powerful method to apply another image as a watermark on top of this image, and then cache the result in the image cache. Given the following two images (marked $play and $cat in the example code respectively): The example code produces the following images:.

  • width()Integer

    Retrieves the width of the image in pixels.

Base Class Methods

View method list from the base class WOOF_File.

Latest From the Blog

MasterPress 1.3.10 is now available

9th November 2023

MasterPress 1.3.10 is a feature and bugfix release. Workaround for fatal error introduced by changes to WordPress’ wpdb class in WordPress 6.4. Added actions to MPC files upload_field & WF image save_image functions.

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