php_image_magician.php

Go to the documentation of this file.

<?php
   # ========================================================================#
   #
   #  This work is licensed under the Creative Commons Attribution 3.0 Unported
   #  License. To view a copy of this license,
   #  visit http://creativecommons.org/licenses/by/3.0/ or send a letter to
   #  Creative Commons, 444 Castro Street, Suite 900, Mountain View, California,
   #  94041, USA.
   #
   #  All rights reserved.
   #
   #  Author:    Jarrod Oberto
   #  Version:   1.5.1
   #  Date:      10-05-11
   #  Purpose:   Provide tools for image manipulation using GD
   #  Param In:  See functions.
   #  Param Out: Produces a resized image
   #  Requires : Requires PHP GD library.
   #  Usage Example:
   #                     include("lib/php_image_magician.php");
   #                     $magicianObj = new resize('images/car.jpg');
   #                     $magicianObj -> resizeImage(150, 100, 0);
   #                     $magicianObj -> saveImage('images/car_small.jpg', 100);
   #
   #        - See end of doc for more examples -
   #
   #  Supported file types include: jpg, png, gif, bmp, psd (read)
   #
   #
   #
   #  The following functions are taken from phpThumb() [available from
   #    http://phpthumb.sourceforge.net], and are used with written permission
   #  from James Heinrich.
   #    - GD2BMPstring
   #      - GetPixelColor
   #      - LittleEndian2String
   #
   #  The following functions are from Marc Hibbins and are used with written
   #  permission (are also under the Attribution-ShareAlike
   #  [http://creativecommons.org/licenses/by-sa/3.0/] license.
   #    -
   #
   #  PhpPsdReader is used with written permission from Tim de Koning.
   #  [http://www.kingsquare.nl/phppsdreader]
   #
   #
   #
   #  Modificatoin history
   #  Date      Initials  Ver Description
   #  10-05-11  J.C.O   0.0 Initial build
   #  01-06-11  J.C.O   0.1.1   * Added reflections
   #              * Added Rounded corners
   #              * You can now use PNG interlacing
   #              * Added shadow
   #              * Added caption box
   #              * Added vintage filter
   #              * Added dynamic image resizing (resize on the fly)
   #              * minor bug fixes
   #  05-06-11  J.C.O   0.1.1.1 * Fixed undefined variables
   #  17-06-11  J.C.O   0.1.2   * Added image_batch_class.php class
   #              * Minor bug fixes
   #  26-07-11  J.C.O   0.1.4 * Added support for external images
   #              * Can now set the crop poisition
   #  03-08-11  J.C.O   0.1.5 * Added reset() method to reset resource to
   #                original input file.
   #              * Added method addTextToCaptionBox() to
   #                simplify adding text to a caption box.
   #              * Added experimental writeIPTC. (not finished)
   #              * Added experimental readIPTC. (not finished)
   #  11-08-11  J.C.O     * Added initial border presets.
   #  30-08-11  J.C.O     * Added 'auto' crop option to crop portrait
   #                images near the top.
   #  08-09-11  J.C.O     * Added cropImage() method to allow standalone
   #                cropping.
   #  17-09-11  J.C.O     * Added setCropFromTop() set method - set the
   #                percentage to crop from the top when using
   #                crop 'auto' option.
   #              * Added setTransparency() set method - allows you
   #                to turn transparency off (like when saving
   #                as a jpg).
   #              * Added setFillColor() set method - set the
   #                background color to use instead of transparency.
   #  05-11-11  J.C.O   0.1.5.1 * Fixed interlacing option
   #  0-07-12  J.C.O   1.0
   #
   #  Known issues & Limitations:
   # -------------------------------
   #  Not so much an issue, the image is destroyed on the deconstruct rather than
   #  when we have finished with it. The reason for this is that we don't know
   #  when we're finished with it as you can both save the image and display
   #  it directly to the screen (imagedestroy($this->imageResized))
   #
   #  Opening BMP files is slow. A test with 884 bmp files processed in a loop
   #  takes forever - over 5 min. This test inlcuded opening the file, then
   #  getting and displaying its width and height.
   #
   #  $forceStretch:
   # -------------------------------
   #  On by default.
   #  $forceStretch can be disabled by calling method setForceStretch with false
   #  parameter. If disabled, if an images original size is smaller than the size
   #  specified by the user, the original size will be used. This is useful when
   #  dealing with small images.
   #
   #  If enabled, images smaller than the size specified will be stretched to
   #  that size.
   #
   #  Tips:
   # -------------------------------
   #  * If you're resizing a transparent png and saving it as a jpg, set
   #  $keepTransparency to false with: $magicianObj->setTransparency(false);
   #
   #  FEATURES:
   #    * EASY TO USE
   #    * BMP SUPPORT (read & write)
   #    * PSD (photoshop) support (read)
   #    * RESIZE IMAGES
   #      - Preserve transparency (png, gif)
   #      - Apply sharpening (jpg) (requires PHP >= 5.1.0)
   #      - Set image quality (jpg, png)
   #      - Resize modes:
   #        - exact size
   #        - resize by width (auto height)
   #        - resize by height (auto width)
   #        - auto (automatically determine the best of the above modes to use)
   #        - crop - resize as best as it can then crop the rest
   #      - Force stretching of smaller images (upscale)
   #    * APPLY FILTERS
   #      - Convert to grey scale
   #      - Convert to black and white
   #      - Convert to sepia
   #      - Convert to negative
   #    * ROTATE IMAGES
   #      - Rotate using predefined "left", "right", or "180"; or any custom degree amount
   #    * EXTRACT EXIF DATA (requires exif module)
   #      - make
   #      - model
   #      - date
   #      - exposure
   #      - aperture
   #      - f-stop
   #      - iso
   #      - focal length
   #      - exposure program
   #      - metering mode
   #      - flash status
   #      - creator
   #      - copyright
   #    * ADD WATERMARK
   #      - Specify exact x, y placement
   #      - Or, specify using one of the 9 pre-defined placements such as "tl"
   #        (for top left), "m" (for middle), "br" (for bottom right)
   #        - also specify padding from edge amount (optional).
   #      - Set opacity of watermark (png).
   #    * ADD BORDER
   #    * USE HEX WHEN SPECIFYING COLORS (eg: #ffffff)
   #    * SAVE IMAGE OR OUTPUT TO SCREEN
   #
   #
   # ========================================================================#


class imageLib
{

    private $fileName;
    private $image;
    protected $imageResized;
    private $widthOriginal;     # Always be the original width
    private $heightOriginal;
    private $width;         # Current width (width after resize)
    private $height;
    private $imageSize;
  private $fileExtension;

  private $debug = true;
  private $errorArray = array();

  private $forceStretch = true;
  private $aggresiveSharpening = false;

  private $transparentArray = array('.png', '.gif');
  private $keepTransparency = true;
  private $fillColorArray = array('r'=>255, 'g'=>255, 'b'=>255);

  private $sharpenArray = array('jpg');

  private $psdReaderPath;
  private $filterOverlayPath;

  private $isInterlace;

  private $captionBoxPositionArray = array();

  private $fontDir = 'fonts';

  private $cropFromTopPercent = 10;


## --------------------------------------------------------

    function __construct($fileName)
    # Author:     Jarrod Oberto
  # Date:     27-02-08
    # Purpose:    Constructor
    # Param in:   $fileName: File name and path.
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
    if (!$this->testGDInstalled()) { if ($this->debug) { throw new Exception('The GD Library is not installed.'); }else{ throw new Exception(); }};

    $this->initialise();

        // *** Save the image file name. Only store this incase you want to display it
        $this->fileName = $fileName;
    $this->fileExtension = fix_strtolower(strrchr($fileName, '.'));

        // *** Open up the file
        $this->image = $this->openImage($fileName);


    // *** Assign here so we don't modify the original
    $this->imageResized = $this->image;

        // *** If file is an image
        if ($this->testIsImage($this->image))
        {
            // *** Get width and height
            $this->width  = imagesx($this->image);
            $this->widthOriginal = imagesx($this->image);
            $this->height = imagesy($this->image);
            $this->heightOriginal = imagesy($this->image);


        /*  Added 15-09-08
         *  Get the filesize using this build in method.
         *  Stores an array of size
         *
         *  $this->imageSize[1] = width
         *  $this->imageSize[2] = height
         *  $this->imageSize[3] = width x height
         *
         */
            $this->imageSize = getimagesize($this->fileName);

        } else {
      $this->errorArray[] = 'File is not an image';
    }
    }

## --------------------------------------------------------

  private function initialise () {

    $this->psdReaderPath = __DIR__ . '/classPhpPsdReader.php';
    $this->filterOverlayPath = __DIR__ . '/filters';

    // *** Set if image should be interlaced or not.
    $this->isInterlace = false;
  }



/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Resize
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/


    public function resizeImage($newWidth, $newHeight, $option = 0, $sharpen = false, $autoRotate = false)
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:    Resizes the image
    # Param in:   $newWidth:
    #             $newHeight:
    #             $option:     0 / exact = defined size;
    #                          1 / portrait = keep aspect set height;
    #                          2 / landscape = keep aspect set width;
    #                          3 / auto = auto;
  #                          4 / crop= resize and crop;
  #
  #         $option can also be an array containing options for
  #         cropping. E.G., array('crop', 'r')
  #
  #         This array only applies to 'crop' and the 'r' refers to
  #         "crop right". Other value include; tl, t, tr, l, m (default),
  #         r, bl, b, br, or you can specify your own co-ords (which
  #         isn't recommended.
  #
  #       $sharpen:    true: sharpen (jpg only);
  #                false: don't sharpen
    # Param out:  n/a
    # Reference:
    # Notes:      To clarify the $option input:
    #               0 = The exact height and width dimensions you set.
    #               1 = Whatever height is passed in will be the height that
    #                   is set. The width will be calculated and set automatically
    #                   to a the value that keeps the original aspect ratio.
    #               2 = The same but based on the width. We try make the image the
  #                  biggest size we can while stil fitting inside the box size
    #               3 = Depending whether the image is landscape or portrait, this
    #                   will automatically determine whether to resize via
    #                   dimension 1,2 or 0
  #               4 = Will resize and then crop the image for best fit
  #
  #       forceStretch can be applied to options 1,2,3 and 4
    #
    {

    // *** We can pass in an array of options to change the crop position
    $cropPos = 'm';
    if (is_array($option) && fix_strtolower($option[0]) == 'crop') {
      $cropPos = $option[1];         # get the crop option
    } else if (strpos($option, '-') !== false) {
      // *** Or pass in a hyphen seperated option
      $optionPiecesArray = explode('-', $option);
      $cropPos = end($optionPiecesArray);
    }

    // *** Check the option is valid
    $option = $this->prepOption($option);

    // *** Make sure the file passed in is valid
    if (!$this->image) { if ($this->debug) { throw new Exception('file ' . $this->getFileName() .' is missing or invalid'); }else{ throw new Exception(); }};

    // *** Get optimal width and height - based on $option
    $dimensionsArray = $this->getDimensions($newWidth, $newHeight, $option);

    $optimalWidth  = $dimensionsArray['optimalWidth'];
    $optimalHeight = $dimensionsArray['optimalHeight'];

    // *** Resample - create image canvas of x, y size
    $this->imageResized = imagecreatetruecolor($optimalWidth, $optimalHeight);
    $this->keepTransparancy($optimalWidth, $optimalHeight, $this->imageResized);
    imagecopyresampled($this->imageResized, $this->image, 0, 0, 0, 0, $optimalWidth, $optimalHeight, $this->width, $this->height);


    // *** If '4', then crop too
    if ($option == 4 || $option == 'crop') {

      if (($optimalWidth >= $newWidth && $optimalHeight >= $newHeight)) {
        $this->crop($optimalWidth, $optimalHeight, $newWidth, $newHeight, $cropPos);
      }
    }

    // *** If Rotate.
    if ($autoRotate) {

      $exifData = $this->getExif(false);
      if (count($exifData) > 0) {

        switch($exifData['orientation']) {
            case 8:
                $this->imageResized = imagerotate($this->imageResized,90,0);
                break;
            case 3:
                $this->imageResized = imagerotate($this->imageResized,180,0);
                break;
            case 6:
                $this->imageResized = imagerotate($this->imageResized,-90,0);
                break;
        }
      }
    }

    // *** Sharpen image (if jpg and the user wishes to do so)
    if ($sharpen && in_array($this->fileExtension, $this->sharpenArray)) {

      // *** Sharpen
      $this->sharpen();
    }
    }

## --------------------------------------------------------

  public function cropImage($newWidth, $newHeight, $cropPos = 'm')
    # Author:     Jarrod Oberto
    # Date:       08-09-11
    # Purpose:    Crops the image
    # Param in:   $newWidth: crop with
    #             $newHeight: crop height
  #       $cropPos: Can be any of the following:
  #             tl, t, tr, l, m, r, bl, b, br, auto
  #           Or:
  #             a custom position such as '30x50'
    # Param out:  n/a
    # Reference:
    # Notes:
    #
  {

    // *** Make sure the file passed in is valid
    if (!$this->image) { if ($this->debug) { throw new Exception('file ' . $this->getFileName() .' is missing or invalid'); }else{ throw new Exception(); }};

    $this->imageResized = $this->image;
    $this->crop($this->width, $this->height, $newWidth, $newHeight, $cropPos);

  }

## --------------------------------------------------------

  private function keepTransparancy($width, $height, $im)
    # Author:     Jarrod Oberto
    # Date:       08-04-11
    # Purpose:    Keep transparency for png and gif image
    # Param in:
    # Param out:  n/a
    # Reference:
    # Notes:
    #
  {
    // *** If PNG, perform some transparency retention actions (gif untested)
    if (in_array($this->fileExtension, $this->transparentArray) && $this->keepTransparency) {
      imagealphablending($im, false);
      imagesavealpha($im, true);
      $transparent = imagecolorallocatealpha($im, 255, 255, 255, 127);
      imagefilledrectangle($im, 0, 0, $width, $height, $transparent);
    } else {
      $color = imagecolorallocate($im, $this->fillColorArray['r'], $this->fillColorArray['g'], $this->fillColorArray['b']);
      imagefilledrectangle($im, 0, 0, $width, $height, $color);
    }
  }

## --------------------------------------------------------

    private function crop($optimalWidth, $optimalHeight, $newWidth, $newHeight, $cropPos)
    # Author:     Jarrod Oberto
    # Date:       15-09-08
    # Purpose:    Crops the image
    # Param in:   $newWidth:
    #             $newHeight:
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {

    // *** Get cropping co-ordinates
    $cropArray = $this->getCropPlacing($optimalWidth, $optimalHeight, $newWidth, $newHeight, $cropPos);
    $cropStartX = $cropArray['x'];
    $cropStartY = $cropArray['y'];

    // *** Crop this bad boy
    $crop = imagecreatetruecolor($newWidth , $newHeight);
    $this->keepTransparancy($optimalWidth, $optimalHeight, $crop);
    imagecopyresampled($crop, $this->imageResized, 0, 0, $cropStartX, $cropStartY, $newWidth, $newHeight , $newWidth, $newHeight);

    $this->imageResized = $crop;

    // *** Set new width and height to our variables
    $this->width = $newWidth;
    $this->height = $newHeight;

    }

## --------------------------------------------------------

  private function getCropPlacing($optimalWidth, $optimalHeight, $newWidth, $newHeight, $pos='m')
  #
  # Author:   Jarrod Oberto
  # Date:   July 11
  # Purpose:  Set the cropping area.
  # Params in:
  # Params out: (array) the crop x and y co-ordinates.
  # Notes:    When specifying the exact pixel crop position (eg 10x15), be
  #       very careful as it's easy to crop out of the image leaving
  #       black borders.
  #
  {
    $pos = fix_strtolower($pos);

    // *** If co-ords have been entered
    if (strstr($pos, 'x')) {
      $pos = str_replace(' ', '', $pos);

      $xyArray = explode('x', $pos);
      list($cropStartX, $cropStartY) = $xyArray;

    } else {

      switch ($pos) {
        case 'tl':
          $cropStartX = 0;
          $cropStartY = 0;
          break;

        case 't':
          $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
          $cropStartY = 0;
          break;

        case 'tr':
          $cropStartX = $optimalWidth - $newWidth;
          $cropStartY = 0;
          break;

        case 'l':
          $cropStartX = 0;
          $cropStartY = ( $optimalHeight/ 2) - ( $newHeight/2 );
          break;

        case 'm':
          $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
          $cropStartY = ( $optimalHeight/ 2) - ( $newHeight/2 );
          break;

        case 'r':
          $cropStartX = $optimalWidth - $newWidth;
          $cropStartY = ( $optimalHeight/ 2) - ( $newHeight/2 );
          break;

        case 'bl':
          $cropStartX = 0;
          $cropStartY = $optimalHeight - $newHeight;
          break;

        case 'b':
          $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
          $cropStartY = $optimalHeight - $newHeight;
          break;

        case 'br':
          $cropStartX = $optimalWidth - $newWidth;
          $cropStartY = $optimalHeight - $newHeight;
          break;

        case 'auto':
          // *** If image is a portrait crop from top, not center. v1.5
          if ($optimalHeight > $optimalWidth) {
            $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
            $cropStartY = ($this->cropFromTopPercent /100) * $optimalHeight;
          } else {

            // *** Else crop from the center
            $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
            $cropStartY = ( $optimalHeight/ 2) - ( $newHeight/2 );
          }
          break;

        default:
          // *** Default to center
          $cropStartX = ( $optimalWidth / 2) - ( $newWidth /2 );
          $cropStartY = ( $optimalHeight/ 2) - ( $newHeight/2 );
          break;
      }
    }

    return array('x' => $cropStartX, 'y' => $cropStartY);
  }

## --------------------------------------------------------

  private function getDimensions($newWidth, $newHeight, $option)
    # Author:     Jarrod Oberto
    # Date:       17-11-09
    # Purpose:    Get new image dimensions based on user specificaions
    # Param in:   $newWidth:
    #             $newHeight:
    # Param out:  Array of new width and height values
    # Reference:
    # Notes:    If $option = 3 then this function is call recursivly
  #
  #       To clarify the $option input:
    #               0 = The exact height and width dimensions you set.
    #               1 = Whatever height is passed in will be the height that
    #                   is set. The width will be calculated and set automatically
    #                   to a the value that keeps the original aspect ratio.
    #               2 = The same but based on the width.
    #               3 = Depending whether the image is landscape or portrait, this
    #                   will automatically determine whether to resize via
    #                   dimension 1,2 or 0.
  #               4 = Resize the image as much as possible, then crop the
  #         remainder.
  {

        switch (strval($option))
        {
            case '0':
      case 'exact':
                $optimalWidth = $newWidth;
                $optimalHeight= $newHeight;
                break;
            case '1':
      case 'portrait':
                $dimensionsArray = $this->getSizeByFixedHeight($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
                break;
            case '2':
      case 'landscape':
                $dimensionsArray = $this->getSizeByFixedWidth($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
                break;
            case '3':
      case 'auto':
                $dimensionsArray = $this->getSizeByAuto($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
                break;
      case '4':
      case 'crop':
                $dimensionsArray = $this->getOptimalCrop($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
                break;
        }

    return array('optimalWidth' => $optimalWidth, 'optimalHeight' => $optimalHeight);
  }

## --------------------------------------------------------

    private function getSizeByFixedHeight($newWidth, $newHeight)
    {
    // *** If forcing is off...
    if (!$this->forceStretch) {

      // *** ...check if actual height is less than target height
      if ($this->height < $newHeight) {
        return array('optimalWidth' => $this->width, 'optimalHeight' => $this->height);
      }
    }

        $ratio = $this->width / $this->height;

        $newWidth = $newHeight * $ratio;

        //return $newWidth;
    return array('optimalWidth' => $newWidth, 'optimalHeight' => $newHeight);
    }

## --------------------------------------------------------

    private function getSizeByFixedWidth($newWidth, $newHeight)
    {
    // *** If forcing is off...
    if (!$this->forceStretch) {

      // *** ...check if actual width is less than target width
      if ($this->width < $newWidth) {
        return array('optimalWidth' => $this->width, 'optimalHeight' => $this->height);
      }
    }

    $ratio = $this->height / $this->width;

        $newHeight = $newWidth * $ratio;

        //return $newHeight;
    return array('optimalWidth' => $newWidth, 'optimalHeight' => $newHeight);
    }

## --------------------------------------------------------

    private function getSizeByAuto($newWidth, $newHeight)
    # Author:     Jarrod Oberto
    # Date:       19-08-08
    # Purpose:    Depending on the height, choose to resize by 0, 1, or 2
    # Param in:   The new height and new width
    # Notes:
    #
    {
    // *** If forcing is off...
    if (!$this->forceStretch) {

      // *** ...check if actual size is less than target size
      if ($this->width < $newWidth && $this->height < $newHeight) {
        return array('optimalWidth' => $this->width, 'optimalHeight' => $this->height);
      }
    }

        if ($this->height < $this->width)
        // *** Image to be resized is wider (landscape)
        {
            //$optimalWidth = $newWidth;
            //$optimalHeight= $this->getSizeByFixedWidth($newWidth);

            $dimensionsArray = $this->getSizeByFixedWidth($newWidth, $newHeight);
      $optimalWidth = $dimensionsArray['optimalWidth'];
      $optimalHeight = $dimensionsArray['optimalHeight'];
        }
        elseif ($this->height > $this->width)
        // *** Image to be resized is taller (portrait)
        {
            //$optimalWidth = $this->getSizeByFixedHeight($newHeight);
            //$optimalHeight= $newHeight;

            $dimensionsArray = $this->getSizeByFixedHeight($newWidth, $newHeight);
      $optimalWidth = $dimensionsArray['optimalWidth'];
      $optimalHeight = $dimensionsArray['optimalHeight'];
        }
    else
        // *** Image to be resizerd is a square
        {

      if ($newHeight < $newWidth) {
          //$optimalWidth = $newWidth;
        //$optimalHeight= $this->getSizeByFixedWidth($newWidth);
                $dimensionsArray = $this->getSizeByFixedWidth($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
      } else if ($newHeight > $newWidth) {
          //$optimalWidth = $this->getSizeByFixedHeight($newHeight);
            //$optimalHeight= $newHeight;
                $dimensionsArray = $this->getSizeByFixedHeight($newWidth, $newHeight);
        $optimalWidth = $dimensionsArray['optimalWidth'];
        $optimalHeight = $dimensionsArray['optimalHeight'];
      } else {
        // *** Sqaure being resized to a square
        $optimalWidth = $newWidth;
        $optimalHeight= $newHeight;
      }
        }

    return array('optimalWidth' => $optimalWidth, 'optimalHeight' => $optimalHeight);
    }

## --------------------------------------------------------

    private function getOptimalCrop($newWidth, $newHeight)
  # Author:     Jarrod Oberto
    # Date:       17-11-09
    # Purpose:    Get optimal crop dimensions
    # Param in:   width and height as requested by user (fig 3)
    # Param out:  Array of optimal width and height (fig 2)
    # Reference:
    # Notes:      The optimal width and height return are not the same as the
  #       same as the width and height passed in. For example:
  #
  #
  #   |-----------------|     |------------|       |-------|
  #   |             |   =>  |**|      |**|   =>  |       |
  #   |             |     |**|      |**|       |       |
    #   |           |       |------------|       |-------|
  #   |-----------------|
  #        original                optimal             crop
  #              size                   size               size
  #  Fig          1                      2                  3
  #
  #       300 x 250           150 x 125          150 x 100
  #
  #    The optimal size is the smallest size (that is closest to the crop size)
  #    while retaining proportion/ratio.
  #
  #  The crop size is the optimal size that has been cropped on one axis to
  #  make the image the exact size specified by the user.
  #
  #               * represent cropped area
  #
  {

    // *** If forcing is off...
    if (!$this->forceStretch) {

      // *** ...check if actual size is less than target size
      if ($this->width < $newWidth && $this->height < $newHeight) {
        return array('optimalWidth' => $this->width, 'optimalHeight' => $this->height);
      }
    }

    $heightRatio = $this->height / $newHeight;
    $widthRatio  = $this->width /  $newWidth;

    if ($heightRatio < $widthRatio) {
      $optimalRatio = $heightRatio;
    } else {
      $optimalRatio = $widthRatio;
    }

    $optimalHeight = round( $this->height / $optimalRatio );
    $optimalWidth  = round( $this->width  / $optimalRatio );

    return array('optimalWidth' => $optimalWidth, 'optimalHeight' => $optimalHeight);
  }

## --------------------------------------------------------

  private function sharpen()
    # Author:     Jarrod Oberto
    # Date:       08 04 2011
    # Purpose:    Sharpen image
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    # Credit:   Incorporates Joe Lencioni (August 6, 2008) code
  {

    if (version_compare(PHP_VERSION, '5.1.0') >= 0) {

      // ***
      if ($this->aggresiveSharpening) { # A more aggressive sharpening solution

        $sharpenMatrix = array( array( -1, -1, -1 ),
                         array( -1, 16, -1 ),
                         array( -1, -1, -1 ) );
        $divisor = 8;
        $offset = 0;

        imageconvolution($this->imageResized, $sharpenMatrix, $divisor, $offset);
      }
      else # More subtle and personally more desirable
      {
        $sharpness  = $this->findSharp($this->widthOriginal, $this->width);

        $sharpenMatrix  = array(
          array(-1, -2, -1),
          array(-2, $sharpness + 12, -2), //Lessen the effect of a filter by increasing the value in the center cell
          array(-1, -2, -1)
        );
        $divisor    = $sharpness; // adjusts brightness
        $offset     = 0;
        imageconvolution($this->imageResized, $sharpenMatrix, $divisor, $offset);
      }
    }
    else
    {
      if ($this->debug) { throw new Exception('Sharpening required PHP 5.1.0 or greater.'); }
    }
  }

  ## --------------------------------------------------------

  private function sharpen2($level)
  {
      $sharpenMatrix  = array(
        array($level, $level, $level),
        array($level, (8*$level)+1, $level), //Lessen the effect of a filter by increasing the value in the center cell
        array($level, $level, $level)
      );

  }

## --------------------------------------------------------

  private function findSharp($orig, $final)
    # Author:     Ryan Rud (http://adryrun.com)
    # Purpose:    Find optimal sharpness
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    #
  {
    $final  = $final * (750.0 / $orig);
    $a    = 52;
    $b    = -0.27810650887573124;
    $c    = .00047337278106508946;

    $result = $a + $b * $final + $c * $final * $final;

    return max(round($result), 0);
  }

## --------------------------------------------------------

  private function prepOption($option)
    # Author:     Jarrod Oberto
    # Purpose:    Prep option like change the passed in option to lowercase
    # Param in:   (str/int) $option: eg. 'exact', 'crop'. 0, 4
    # Param out:  lowercase string
    # Reference:
    # Notes:
    #
  {
    if (is_array($option)) {
      if (fix_strtolower($option[0]) == 'crop' && count($option) == 2) {
        return 'crop';
      } else {
        throw new Exception('Crop resize option array is badly formatted.');
      }
    } else if (strpos($option, 'crop') !== false) {
      return 'crop';
    }

    if (is_string($option)) {
      return fix_strtolower($option);
    }

    return $option;
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Presets
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

#
# Preset are pre-defined templates you can apply to your image.
#
# These are inteded to be applied to thumbnail images.
#


  public function borderPreset($preset)
  {
    switch ($preset)
    {

      case 'simple':
        $this->addBorder(7, '#fff');
        $this->addBorder(6, '#f2f1f0');
        $this->addBorder(2, '#fff');
        $this->addBorder(1, '#ccc');
        break;
      default:
        break;
    }

  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Draw border
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addBorder($thickness = 1, $rgbArray = array(255, 255, 255))
    # Author:     Jarrod Oberto
    # Date:       05-05-11
    # Purpose:    Add a border to the image
    # Param in:
    # Param out:
    # Reference:
    # Notes:    This border is added to the INSIDE of the image
    #
  {
    if ($this->imageResized) {

      $rgbArray = $this->formatColor($rgbArray);
      $r = $rgbArray['r'];
      $g = $rgbArray['g'];
      $b = $rgbArray['b'];


      $x1 = 0;
      $y1 = 0;
      $x2 = ImageSX($this->imageResized) - 1;
      $y2 = ImageSY($this->imageResized) - 1;

      $rgbArray = ImageColorAllocate($this->imageResized, $r, $g, $b);


      for($i = 0; $i < $thickness; $i++) {
        ImageRectangle($this->imageResized, $x1++, $y1++, $x2--, $y2--, $rgbArray);
      }
    }
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Gray Scale
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function greyScale()
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Make image greyscale
    # Param in:   n/a
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if ($this->imageResized) {
      imagefilter($this->imageResized, IMG_FILTER_GRAYSCALE);
    }

  }

  ## --------------------------------------------------------

  public function greyScaleEnhanced()
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Make image greyscale
    # Param in:   n/a
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if ($this->imageResized) {
      imagefilter($this->imageResized, IMG_FILTER_GRAYSCALE);
      imagefilter($this->imageResized, IMG_FILTER_CONTRAST, -15);
      imagefilter($this->imageResized, IMG_FILTER_BRIGHTNESS, 2);
      $this->sharpen($this->width);
    }
  }

  ## --------------------------------------------------------

  public function greyScaleDramatic()
  # Alias of gd_filter_monopin
  {
    $this->gd_filter_monopin();
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Black 'n White
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function blackAndWhite()
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Make image black and white
    # Param in:   n/a
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if ($this->imageResized) {

      imagefilter($this->imageResized, IMG_FILTER_GRAYSCALE);
      imagefilter($this->imageResized, IMG_FILTER_CONTRAST, -1000);
    }

  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Negative
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function negative()
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Make image negative
    # Param in:   n/a
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if ($this->imageResized) {

      imagefilter($this->imageResized, IMG_FILTER_NEGATE);
    }

  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Sepia
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function sepia()
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Make image sepia
    # Param in:   n/a
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if ($this->imageResized) {
      imagefilter($this->imageResized, IMG_FILTER_GRAYSCALE);
      imagefilter($this->imageResized, IMG_FILTER_BRIGHTNESS, -10);
      imagefilter($this->imageResized, IMG_FILTER_CONTRAST, -20);
      imagefilter($this->imageResized, IMG_FILTER_COLORIZE, 60, 30, -15);
    }
  }

  ## --------------------------------------------------------

  public function sepia2()

  {
    if ($this->imageResized) {

      $total = imagecolorstotal( $this->imageResized );
      for ( $i = 0; $i < $total; $i++ ) {
        $index = imagecolorsforindex( $this->imageResized, $i );
        $red = ( $index["red"] * 0.393 + $index["green"] * 0.769 + $index["blue"] * 0.189 ) / 1.351;
        $green = ( $index["red"] * 0.349 + $index["green"] * 0.686 + $index["blue"] * 0.168 ) / 1.203;
        $blue = ( $index["red"] * 0.272 + $index["green"] * 0.534 + $index["blue"] * 0.131 ) / 2.140;
        imagecolorset( $this->imageResized, $i, $red, $green, $blue );
      }


    }
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Vintage
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function vintage()
  # Alias of gd_filter_monopin
  {
    $this->gd_filter_vintage();
  }

/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Presets By Marc Hibbins
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/


  public function gd_filter_monopin()
  {

    if ($this->imageResized) {
      imagefilter($this->imageResized, IMG_FILTER_GRAYSCALE);
      imagefilter($this->imageResized, IMG_FILTER_BRIGHTNESS, -15);
      imagefilter($this->imageResized, IMG_FILTER_CONTRAST, -15);
      $this->imageResized = $this->gd_apply_overlay($this->imageResized, 'vignette', 100);
    }
  }

  ## --------------------------------------------------------

  public function gd_filter_vintage()
  {
    if ($this->imageResized) {
      $this->imageResized = $this->gd_apply_overlay($this->imageResized, 'vignette', 45);
      imagefilter($this->imageResized, IMG_FILTER_BRIGHTNESS, 20);
      imagefilter($this->imageResized, IMG_FILTER_CONTRAST, -35);
      imagefilter($this->imageResized, IMG_FILTER_COLORIZE, 60, -10, 35);
      imagefilter($this->imageResized, IMG_FILTER_SMOOTH, 7);
      $this->imageResized = $this->gd_apply_overlay($this->imageResized, 'scratch', 10);
    }
  }

  ## --------------------------------------------------------

  private function gd_apply_overlay($im, $type, $amount)
  #
  # Original Author:    Marc Hibbins
  # License:  Attribution-ShareAlike 3.0
  # Purpose:
  # Params in:
  # Params out:
  # Notes:
  #
  {
    $width = imagesx($im);
    $height = imagesy($im);
    $filter = imagecreatetruecolor($width, $height);

    imagealphablending($filter, false);
    imagesavealpha($filter, true);

    $transparent = imagecolorallocatealpha($filter, 255, 255, 255, 127);
    imagefilledrectangle($filter, 0, 0, $width, $height, $transparent);

    // *** Resize overlay
    $overlay = $this->filterOverlayPath . '/' . $type . '.png';
    $png = imagecreatefrompng($overlay);
    imagecopyresampled($filter, $png, 0, 0, 0, 0, $width, $height, imagesx($png), imagesy($png));

    $comp = imagecreatetruecolor($width, $height);
    imagecopy($comp, $im, 0, 0, 0, 0, $width, $height);
    imagecopy($comp, $filter, 0, 0, 0, 0, $width, $height);
    imagecopymerge($im, $comp, 0, 0, 0, 0, $width, $height, $amount);

    imagedestroy($comp);
    return $im;
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Colorise
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function image_colorize($rgb) {
    imageTrueColorToPalette($this->imageResized,true,256);
    $numColors = imageColorsTotal($this->imageResized);

    for ($x = 0; $x < $numColors; $x++) {
    list($r,$g,$b) = array_values(imageColorsForIndex($this->imageResized,$x));

    // calculate grayscale in percent
    $grayscale = ($r + $g + $b) / 3 / 0xff;

    imageColorSet($this->imageResized,$x,
      $grayscale * $rgb[0],
      $grayscale * $rgb[1],
      $grayscale * $rgb[2]
    );

    }

    return true;
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Reflection
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addReflection($reflectionHeight = 50, $startingTransparency = 30, $inside = false, $bgColor = '#fff', $stretch=false, $divider = 0)
  {

    // *** Convert color
    $rgbArray = $this->formatColor($bgColor);
    $r = $rgbArray['r'];
    $g = $rgbArray['g'];
    $b = $rgbArray['b'];

    $im = $this->imageResized;
    $li = imagecreatetruecolor($this->width, 1);

    $bgc = imagecolorallocate($li, $r, $g, $b);
    imagefilledrectangle($li, 0, 0, $this->width, 1, $bgc);

    $bg = imagecreatetruecolor($this->width, $reflectionHeight);
    $wh = imagecolorallocate($im, 255, 255, 255);

    $im = imagerotate($im, -180, $wh);
    imagecopyresampled($bg, $im, 0, 0, 0, 0, $this->width, $this->height, $this->width, $this->height);

    $im = $bg;

    $bg = imagecreatetruecolor($this->width, $reflectionHeight);

    for ($x = 0; $x < $this->width; $x++) {
      imagecopy($bg, $im, $x, 0, $this->width-$x -1, 0, 1, $reflectionHeight);
    }
    $im = $bg;

    $transaprencyAmount = $this->invertTransparency($startingTransparency, 100);


    // *** Fade
    if ($stretch) {
      $step = 100/($reflectionHeight + $startingTransparency);
    } else{
      $step = 100/$reflectionHeight;
    }
    for($i=0; $i<=$reflectionHeight; $i++){

      if($startingTransparency>100) $startingTransparency = 100;
      if($startingTransparency< 1) $startingTransparency = 1;
      imagecopymerge($bg, $li, 0, $i, 0, 0, $this->width, 1, $startingTransparency);
      $startingTransparency+=$step;
    }

    // *** Apply fade
    imagecopymerge($im, $li, 0, 0, 0, 0, $this->width, $divider, 100); // Divider


    // *** width, height of reflection.
    $x = imagesx($im);
    $y = imagesy($im);


    // *** Determines if the reflection should be displayed inside or outside the image
    if ($inside) {

      // Create new blank image with sizes.
      $final = imagecreatetruecolor($this->width, $this->height);

      imagecopymerge ($final, $this->imageResized, 0, 0, 0, $reflectionHeight, $this->width, $this->height - $reflectionHeight, 100);
      imagecopymerge ($final, $im, 0, $this->height - $reflectionHeight, 0, 0, $x, $y, 100);

    } else {

      // Create new blank image with sizes.
      $final = imagecreatetruecolor($this->width, $this->height + $y);

      imagecopymerge ($final, $this->imageResized, 0, 0, 0, 0, $this->width, $this->height, 100);
      imagecopymerge ($final, $im, 0, $this->height, 0, 0, $x, $y, 100);
    }

    $this->imageResized = $final;

    imagedestroy($li);
    imagedestroy($im);
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Rotate
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function rotate($value = 90, $bgColor = 'transparent')
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Rotate image
    # Param in:   (mixed) $degrees: (int) number of degress to rotate image
  #               (str) param "left": rotate left
  #               (str) param "right": rotate right
  #               (str) param "upside": upside-down image
    # Param out:
    # Reference:
    # Notes:    The default direction of imageRotate() is counter clockwise.
    #
  {
    if ($this->imageResized) {

      if (is_integer($value)) {
        $degrees = $value;
      }

      // *** Convert color
      $rgbArray = $this->formatColor($bgColor);
      $r = $rgbArray['r'];
      $g = $rgbArray['g'];
      $b = $rgbArray['b'];
      if (isset($rgbArray['a'])) {$a = $rgbArray['a']; }

      if (is_string($value)) {

        $value = fix_strtolower($value);

        switch ($value) {
          case 'left':
            $degrees = 90;
            break;
          case 'right':
            $degrees = 270;
            break;
          case 'upside':
            $degrees = 180;
            break;
          default:
            break;
        }

      }

      // *** The default direction of imageRotate() is counter clockwise
      //   * This makes it clockwise
      $degrees = 360 - $degrees;

      // *** Create background color
      $bg = ImageColorAllocateAlpha($this->imageResized, $r, $g, $b, $a);

      // *** Fill with background
      ImageFill($this->imageResized, 0, 0 , $bg);

      // *** Rotate
      $this->imageResized = imagerotate($this->imageResized, $degrees, $bg); // Rotate 45 degrees and allocated the transparent colour as the one to make transparent (obviously)

      // Ensure alpha transparency
      ImageSaveAlpha($this->imageResized,true);

    }
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Round corners
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function roundCorners($radius = 5,  $bgColor = 'transparent')
    # Author:     Jarrod Oberto
    # Date:       19-05-2011
    # Purpose:    Create rounded corners on your image
    # Param in:   (int) radius = the amount of curvature
  #       (mixed) $bgColor = the corner background color
    # Param out:  n/a
    # Reference:
    # Notes:
    #
  {

    // *** Check if the user wants transparency
    $isTransparent = false;
    if (!is_array($bgColor)) {
      if (fix_strtolower($bgColor) == 'transparent') {
        $isTransparent = true;
      }
    }


    // *** If we use transparency, we need to color our curved mask with a unique color
    if ($isTransparent) {
      $bgColor = $this->findUnusedGreen();
    }

    // *** Convert color
    $rgbArray = $this->formatColor($bgColor);
    $r = $rgbArray['r'];
    $g = $rgbArray['g'];
    $b = $rgbArray['b'];
    if (isset($rgbArray['a'])) {$a = $rgbArray['a']; }



    // *** Create top-left corner mask (square)
    $cornerImg = imagecreatetruecolor($radius, $radius);
    //$cornerImg = imagecreate($radius, $radius);

      //imagealphablending($cornerImg, true);
      //imagesavealpha($cornerImg, true);

      //imagealphablending($this->imageResized, false);
      //imagesavealpha($this->imageResized, true);

    // *** Give it a color
    $maskColor = imagecolorallocate($cornerImg, 0, 0, 0);



    // *** Replace the mask color (black) to transparent
    imagecolortransparent($cornerImg, $maskColor);



    // *** Create the image background color
    $imagebgColor = imagecolorallocate($cornerImg, $r, $g, $b);



    // *** Fill the corner area to the user defined color
    imagefill($cornerImg, 0, 0, $imagebgColor);


    imagefilledellipse($cornerImg, $radius, $radius, $radius * 2, $radius * 2, $maskColor );


    // *** Map to top left corner
    imagecopymerge($this->imageResized, $cornerImg, 0, 0, 0, 0, $radius, $radius, 100); #tl

    // *** Map rounded corner to other corners by rotating and applying the mask
    $cornerImg = imagerotate($cornerImg, 90, 0);
    imagecopymerge($this->imageResized, $cornerImg, 0, $this->height - $radius, 0, 0, $radius, $radius, 100); #bl

    $cornerImg = imagerotate($cornerImg, 90, 0);
    imagecopymerge($this->imageResized, $cornerImg, $this->width - $radius, $this->height - $radius, 0, 0, $radius, $radius, 100); #br

    $cornerImg = imagerotate($cornerImg, 90, 0);
    imagecopymerge($this->imageResized, $cornerImg, $this->width - $radius, 0, 0, 0, $radius, $radius, 100); #tr


    // *** If corners are to be transparent, we fill our chromakey color as transparent.
    if ($isTransparent) {
      //imagecolortransparent($this->imageResized, $imagebgColor);
      $this->imageResized = $this->transparentImage($this->imageResized);
      imagesavealpha($this->imageResized, true);
    }

  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Shadow
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addShadow($shadowAngle=45, $blur=15, $bgColor='transparent')
  #
  # Author:   Jarrod Oberto (Adapted from Pascal Naidon)
  # Ref:    http://www.les-stooges.org/pascal/webdesign/vignettes/index.php?la=en
  # Purpose:  Add a drop shadow to your image
  # Params in:  (int) $angle: the angle of the shadow
  #       (int) $blur: the blur distance
  #       (mixed) $bgColor: the color of the background
  # Params out:
  # Notes:
  #
  {
    // *** A higher number results in a smoother shadow
    define('STEPS', $blur*2);

    // *** Set the shadow distance
    $shadowDistance = $blur*0.25;

    // *** Set blur width and height
    $blurWidth = $blurHeight = $blur;


    if ($shadowAngle == 0) {
      $distWidth = 0;
      $distHeight = 0;
    } else {
      $distWidth = $shadowDistance * cos(deg2rad($shadowAngle));
      $distHeight = $shadowDistance * sin(deg2rad($shadowAngle));
    }


    // *** Convert color
    if (fix_strtolower($bgColor) != 'transparent') {
      $rgbArray = $this->formatColor($bgColor);
      $r0 = $rgbArray['r'];
      $g0 = $rgbArray['g'];
      $b0 = $rgbArray['b'];
    }


    $image = $this->imageResized;
    $width = $this->width;
    $height = $this->height;


      $newImage = imagecreatetruecolor($width, $height);
    imagecopyresampled($newImage, $image, 0, 0, 0, 0, $width, $height, $width, $height);


    // *** RGB
    $rgb = imagecreatetruecolor($width+$blurWidth,$height+$blurHeight);
    $colour = imagecolorallocate($rgb, 0, 0, 0);
    imagefilledrectangle($rgb, 0, 0, $width+$blurWidth, $height+$blurHeight, $colour);
    $colour = imagecolorallocate($rgb, 255, 255, 255);
    //imagefilledrectangle($rgb, $blurWidth*0.5-$distWidth, $blurHeight*0.5-$distHeight, $width+$blurWidth*0.5-$distWidth, $height+$blurWidth*0.5-$distHeight, $colour);
    imagefilledrectangle($rgb, $blurWidth*0.5-$distWidth, $blurHeight*0.5-$distHeight, $width+$blurWidth*0.5-$distWidth, $height+$blurWidth*0.5-$distHeight, $colour);
    //imagecopymerge($rgb, $newImage, 1+$blurWidth*0.5-$distWidth, 1+$blurHeight*0.5-$distHeight, 0,0, $width, $height, 100);
    imagecopymerge($rgb, $newImage, $blurWidth*0.5-$distWidth, $blurHeight*0.5-$distHeight, 0,0, $width+$blurWidth, $height+$blurHeight, 100);


    // *** Shadow (alpha)
    $shadow = imagecreatetruecolor($width+$blurWidth,$height+$blurHeight);
      imagealphablending($shadow, false);
    $colour = imagecolorallocate($shadow, 0, 0, 0);
    imagefilledrectangle($shadow, 0, 0, $width+$blurWidth, $height+$blurHeight, $colour);


    for($i=0;$i<=STEPS;$i++) {

      $t = ((1.0*$i)/STEPS);
      $intensity = 255*$t*$t;

      $colour = imagecolorallocate($shadow, $intensity, $intensity, $intensity);
      $points = array(
        $blurWidth*$t,        $blurHeight,     // Point 1 (x, y)
        $blurWidth,         $blurHeight*$t,  // Point 2 (x, y)
        $width,           $blurHeight*$t,  // Point 3 (x, y)
        $width+$blurWidth*(1-$t), $blurHeight,     // Point 4 (x, y)
        $width+$blurWidth*(1-$t), $height,     // Point 5 (x, y)
        $width,           $height+$blurHeight*(1-$t),  // Point 6 (x, y)
        $blurWidth,         $height+$blurHeight*(1-$t),  // Point 7 (x, y)
        $blurWidth*$t,        $height      // Point 8 (x, y)
      );
      imagepolygon($shadow, $points, 8, $colour);
    }

    for($i=0;$i<=STEPS;$i++) {

      $t = ((1.0*$i)/STEPS);
        $intensity = 255*$t*$t;

      $colour = imagecolorallocate($shadow, $intensity, $intensity, $intensity);
      imagefilledarc($shadow, $blurWidth-1, $blurHeight-1, 2*(1-$t)*$blurWidth, 2*(1-$t)*$blurHeight, 180, 268, $colour, IMG_ARC_PIE);
      imagefilledarc($shadow, $width, $blurHeight-1, 2*(1-$t)*$blurWidth, 2*(1-$t)*$blurHeight, 270, 358, $colour, IMG_ARC_PIE);
      imagefilledarc($shadow, $width, $height, 2*(1-$t)*$blurWidth, 2*(1-$t)*$blurHeight, 0, 90, $colour, IMG_ARC_PIE);
      imagefilledarc($shadow, $blurWidth-1, $height, 2*(1-$t)*$blurWidth, 2*(1-$t)*$blurHeight, 90, 180, $colour, IMG_ARC_PIE);
    }


    $colour = imagecolorallocate($shadow, 255, 255, 255);
    imagefilledrectangle($shadow, $blurWidth, $blurHeight, $width, $height, $colour);
    imagefilledrectangle($shadow, $blurWidth*0.5-$distWidth, $blurHeight*0.5-$distHeight, $width+$blurWidth*0.5-1-$distWidth, $height+$blurHeight*0.5-1-$distHeight, $colour);


    // *** The magic
        imagealphablending($rgb, false);

        for ($theX=0;$theX<imagesx($rgb);$theX++){
      for ($theY=0;$theY<imagesy($rgb);$theY++){

        // *** Get the RGB values for every pixel of the RGB image
        $colArray = imagecolorat($rgb,$theX,$theY);
        $r = ($colArray >> 16) & 0xFF;
        $g = ($colArray >> 8) & 0xFF;
        $b = $colArray & 0xFF;

        // *** Get the alpha value for every pixel of the shadow image
        $colArray = imagecolorat($shadow,$theX,$theY);
        $a = $colArray & 0xFF;
        $a = 127-floor($a/2);
        $t = $a/128.0;

        // *** Create color
        if(fix_strtolower($bgColor) == 'transparent') {
          $myColour = imagecolorallocatealpha($rgb,$r,$g,$b,$a);
        } else {
          $myColour = imagecolorallocate($rgb,$r*(1.0-$t)+$r0*$t,$g*(1.0-$t)+$g0*$t,$b*(1.0-$t)+$b0*$t);
        }

        // *** Add color to new rgb image
        imagesetpixel($rgb, $theX, $theY, $myColour);
      }
    }

    imagealphablending($rgb, true);
    imagesavealpha($rgb, true);

    $this->imageResized = $rgb;

    imagedestroy($image);
    imagedestroy($newImage);
    imagedestroy($shadow);
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Add Caption Box
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addCaptionBox($side='b', $thickness=50, $padding=0, $bgColor='#000', $transaprencyAmount=30)
  #
  # Author:   Jarrod Oberto
  # Date:   26 May 2011
  # Purpose:  Add a caption box
  # Params in:  (str) $side: the side to add the caption box (t, r, b, or l).
  #       (int) $thickness: how thick you want the caption box to be.
  #       (mixed) $bgColor: The color of the caption box.
  #       (int) $transaprencyAmount: The amount of transparency to be
  #       applied.
  # Params out: n/a
  # Notes:
  #
  {
      $side = fix_strtolower($side);

      // *** Convert color
      $rgbArray = $this->formatColor($bgColor);
      $r = $rgbArray['r'];
      $g = $rgbArray['g'];
      $b = $rgbArray['b'];

      $positionArray = $this->calculateCaptionBoxPosition($side, $thickness, $padding);

      // *** Store incase we want to use method addTextToCaptionBox()
      $this->captionBoxPositionArray = $positionArray;


      $transaprencyAmount = $this->invertTransparency($transaprencyAmount, 127, false);
      $transparent = imagecolorallocatealpha($this->imageResized, $r, $g, $b, $transaprencyAmount);
      imagefilledrectangle($this->imageResized, $positionArray['x1'], $positionArray['y1'], $positionArray['x2'], $positionArray['y2'], $transparent);
  }

  ## --------------------------------------------------------

  public function addTextToCaptionBox($text, $fontColor='#fff', $fontSize = 12, $angle = 0, $font = null)
  #
  # Author:   Jarrod Oberto
  # Date:   03 Aug 11
  # Purpose:  Simplify adding text to a caption box by automatically
  #       locating the center of the caption box
  # Params in:  The usually text paams (less a couple)
  # Params out: n/a
  # Notes:
  #
  {

    // *** Get the caption box measurements
    if (count($this->captionBoxPositionArray) == 4) {
      $x1 = $this->captionBoxPositionArray['x1'];
      $x2 = $this->captionBoxPositionArray['x2'];
      $y1 = $this->captionBoxPositionArray['y1'];
      $y2 = $this->captionBoxPositionArray['y2'];
    } else {
      if ($this->debug) { throw new Exception('No caption box found.'); }else{ return false; }
    }


    // *** Get text font
    $font = $this->getTextFont($font);

    // *** Get text size
    $textSizeArray = $this->getTextSize($fontSize, $angle, $font, $text);
    $textWidth = $textSizeArray['width'];
    $textHeight = $textSizeArray['height'];

    // *** Find the width/height middle points
    $boxXMiddle = (($x2 - $x1) / 2);
    $boxYMiddle = (($y2 - $y1) / 2);

    // *** Box middle - half the text width/height
    $xPos = ($x1 + $boxXMiddle) - ($textWidth/2);
    $yPos = ($y1 + $boxYMiddle) - ($textHeight/2);

    $pos = $xPos . 'x' . $yPos;

    $this->addText($text, $pos, $padding = 0, $fontColor, $fontSize, $angle, $font);

  }

  ## --------------------------------------------------------

  private function calculateCaptionBoxPosition($side, $thickness, $padding)
  {
    $positionArray = array();

    switch ($side) {
      case 't':
        $positionArray['x1'] = 0;
        $positionArray['y1'] = $padding;
        $positionArray['x2'] = $this->width;
        $positionArray['y2'] = $thickness + $padding;
        break;
      case 'r':
        $positionArray['x1'] = $this->width - $thickness - $padding;
        $positionArray['y1'] = 0;
        $positionArray['x2'] = $this->width - $padding;
        $positionArray['y2'] = $this->height;
        break;
      case 'b':
        $positionArray['x1'] = 0;
        $positionArray['y1'] = $this->height - $thickness - $padding;
        $positionArray['x2'] = $this->width;
        $positionArray['y2'] = $this->height - $padding;
        break;
      case 'l':
        $positionArray['x1'] = $padding;
        $positionArray['y1'] = 0;
        $positionArray['x2'] = $thickness + $padding;
        $positionArray['y2'] = $this->height;
        break;

      default:
        break;
    }

    return $positionArray;

  }

/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Get EXIF Data
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function getExif($debug=false)
    # Author:     Jarrod Oberto
    # Date:       07-05-2011
    # Purpose:    Get image EXIF data
    # Param in:   n/a
    # Param out:  An associate array of EXIF data
    # Reference:
    # Notes:
    # 23 May 13 : added orientation flag -jco
    #
  {

    if (!$this->debug || !$debug) { $debug = false; }

    // *** Check all is good - check the EXIF library exists and the file exists, too.
    if (!$this->testEXIFInstalled()) { if ($debug) { throw new Exception('The EXIF Library is not installed.'); }else{ return array(); }};
    if (!file_exists($this->fileName)) { if ($debug) { throw new Exception('Image not found.'); }else{ return array(); }};
    if ($this->fileExtension != '.jpg') { if ($debug) { throw new Exception('Metadata not supported for this image type.'); }else{ return array(); }};
    $exifData = exif_read_data($this->fileName, 'IFD0');

    // *** Format the apperture value
    $ev = $exifData['ApertureValue'];
    $apPeicesArray = explode('/', $ev);
    if (count($apPeicesArray) == 2) {
      $apertureValue = round($apPeicesArray[0] / $apPeicesArray[1], 2, PHP_ROUND_HALF_DOWN) . ' EV';
    } else { $apertureValue = '';}

    // *** Format the focal length
    $focalLength = $exifData['FocalLength'];
    $flPeicesArray = explode('/', $focalLength);
    if (count($flPeicesArray) == 2) {
      $focalLength = $flPeicesArray[0] / $flPeicesArray[1] . '.0 mm';
    } else { $focalLength = '';}

    // *** Format fNumber
    $fNumber = $exifData['FNumber'];
    $fnPeicesArray = explode('/', $fNumber);
    if (count($fnPeicesArray) == 2) {
      $fNumber = $fnPeicesArray[0] / $fnPeicesArray[1];
    } else { $fNumber = '';}

    // *** Resolve ExposureProgram
    if (isset($exifData['ExposureProgram'])) { $ep =  $exifData['ExposureProgram']; }
    if (isset($ep)) { $ep = $this->resolveExposureProgram($ep); }


    // *** Resolve MeteringMode
    $mm = $exifData['MeteringMode'];
    $mm = $this->resolveMeteringMode($mm);

    // *** Resolve Flash
    $flash = $exifData['Flash'];
    $flash = $this->resolveFlash($flash);


    if (isset($exifData['Make'])) {
      $exifDataArray['make'] = $exifData['Make'];
    } else { $exifDataArray['make'] = ''; }

    if (isset($exifData['Model'])) {
      $exifDataArray['model'] = $exifData['Model'];
    } else { $exifDataArray['model'] = ''; }

    if (isset($exifData['DateTime'])) {
      $exifDataArray['date'] = $exifData['DateTime'];
    } else { $exifDataArray['date'] = ''; }

    if (isset($exifData['ExposureTime'])) {
      $exifDataArray['exposure time'] = $exifData['ExposureTime'] . ' sec.';
    } else { $exifDataArray['exposure time'] = ''; }

    if ($apertureValue != '') {
      $exifDataArray['aperture value'] = $apertureValue;
    } else { $exifDataArray['aperture value'] = ''; }

    if (isset($exifData['COMPUTED']['ApertureFNumber'])) {
      $exifDataArray['f-stop'] = $exifData['COMPUTED']['ApertureFNumber'];
    } else { $exifDataArray['f-stop'] = ''; }

    if (isset($exifData['FNumber'])) {
      $exifDataArray['fnumber'] = $exifData['FNumber'];
    } else { $exifDataArray['fnumber'] = ''; }

    if ($fNumber != '') {
      $exifDataArray['fnumber value'] = $fNumber;
    } else { $exifDataArray['fnumber value'] = ''; }

    if (isset($exifData['ISOSpeedRatings'])) {
      $exifDataArray['iso'] = $exifData['ISOSpeedRatings'];
    } else { $exifDataArray['iso'] = ''; }

    if ($focalLength != '') {
      $exifDataArray['focal length'] = $focalLength;
    } else { $exifDataArray['focal length'] = ''; }

    if (isset($ep)) {
      $exifDataArray['exposure program'] = $ep;
    } else { $exifDataArray['exposure program'] = ''; }

    if ($mm != '') {
      $exifDataArray['metering mode'] = $mm;
    } else { $exifDataArray['metering mode'] = ''; }

    if ($flash != '') {
      $exifDataArray['flash status'] = $flash;
    } else { $exifDataArray['flash status'] = ''; }

    if (isset($exifData['Artist'])) {
      $exifDataArray['creator'] = $exifData['Artist'] ;
    } else { $exifDataArray['creator'] = ''; }

    if (isset($exifData['Copyright'])) {
      $exifDataArray['copyright'] = $exifData['Copyright'];
    } else { $exifDataArray['copyright'] = ''; }

    // *** Orientation
    if (isset($exifData['Orientation'])) {
        $exifDataArray['orientation'] = $exifData['Orientation'];
    } else { $exifDataArray['orientation'] = ''; }

    return $exifDataArray;
  }

  ## --------------------------------------------------------

  private function resolveExposureProgram($ep)
  {
    switch ($ep) {
      case 0:
        $ep = '';
        break;
      case 1:
        $ep = 'manual';
        break;
      case 2:
        $ep = 'normal program';
        break;
      case 3:
        $ep = 'aperture priority';
        break;
      case 4:
        $ep = 'shutter priority';
        break;
      case 5:
        $ep = 'creative program';
        break;
      case 6:
        $ep = 'action program';
        break;
      case 7:
        $ep = 'portrait mode';
        break;
      case 8:
        $ep = 'landscape mode';
        break;

      default:
        break;
    }

    return $ep;
  }

  ## --------------------------------------------------------

  private function resolveMeteringMode($mm)
  {
    switch ($mm) {
      case 0:
        $mm = 'unknown';
        break;
      case 1:
        $mm = 'average';
        break;
      case 2:
        $mm = 'center weighted average';
        break;
      case 3:
        $mm = 'spot';
        break;
      case 4:
        $mm = 'multi spot';
        break;
      case 5:
        $mm = 'pattern';
        break;
      case 6:
        $mm = 'partial';
        break;
      case 255:
        $mm = 'other';
        break;

      default:
        break;
    }

    return $mm;
  }

  ## --------------------------------------------------------

  private function resolveFlash($flash)
  {
    switch ($flash) {
      case 0:
        $flash = 'flash did not fire';
        break;
      case 1:
        $flash = 'flash fired';
        break;
      case 5:
        $flash = 'strobe return light not detected';
        break;
      case 7:
        $flash = 'strobe return light detected';
        break;
      case 9:
        $flash = 'flash fired, compulsory flash mode';
        break;
      case 13:
        $flash = 'flash fired, compulsory flash mode, return light not detected';
        break;
      case 15:
        $flash = 'flash fired, compulsory flash mode, return light detected';
        break;
      case 16:
        $flash = 'flash did not fire, compulsory flash mode';
        break;
      case 24:
        $flash = 'flash did not fire, auto mode';
        break;
      case 25:
        $flash = 'flash fired, auto mode';
        break;
      case 29:
        $flash = 'flash fired, auto mode, return light not detected';
        break;
      case 31:
        $flash = 'flash fired, auto mode, return light detected';
        break;
      case 32:
        $flash = 'no flash function';
        break;
      case 65:
        $flash = 'flash fired, red-eye reduction mode';
        break;
      case 69:
        $flash = 'flash fired, red-eye reduction mode, return light not detected';
        break;
      case 71:
        $flash = 'flash fired, red-eye reduction mode, return light detected';
        break;
      case 73:
        $flash = 'flash fired, compulsory flash mode, red-eye reduction mode';
        break;
      case 77:
        $flash = 'flash fired, compulsory flash mode, red-eye reduction mode, return light not detected';
        break;
      case 79:
        $flash = 'flash fired, compulsory flash mode, red-eye reduction mode, return light detected';
        break;
      case 89:
        $flash = 'flash fired, auto mode, red-eye reduction mode';
        break;
      case 93:
        $flash = 'flash fired, auto mode, return light not detected, red-eye reduction mode';
        break;
      case 95:
        $flash = 'flash fired, auto mode, return light detected, red-eye reduction mode';
        break;

      default:
        break;
    }

    return $flash;

  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Get IPTC Data
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Write IPTC Data
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function writeIPTCcaption($value)
  # Caption
  {
    $this->writeIPTC(120, $value);
  }

  ## --------------------------------------------------------

  public function writeIPTCwriter($value)
  {
    //$this->writeIPTC(65, $value);
  }

  ## --------------------------------------------------------

  private function writeIPTC($dat, $value)
  {

    # LIMIT TO JPG

    $caption_block = $this->iptc_maketag(2, $dat, $value);
    $image_string = iptcembed($caption_block, $this->fileName);
    file_put_contents('iptc.jpg', $image_string);
  }

## --------------------------------------------------------

  private function iptc_maketag($rec,$dat,$val)
  # Author:   Thies C. Arntzen
  # Purpose:    Function to format the new IPTC text
  # Param in:   $rec: Application record. (We’re working with #2)
  #       $dat: Index. (120 for caption, 118 for contact. See the IPTC IIM
  #         specification:
  #         http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf
  #       $val: Value/data/text. Make sure this is within the length
  #         constraints of the IPTC IIM specification
  # Ref:      http://blog.peterhaza.no/working-with-image-meta-data-in-exif-and-iptc-headers-from-php/
  #       http://php.net/manual/en/function.iptcembed.php
  #
  {
    $len = strlen($val);
    if ($len < 0x8000)
      return chr(0x1c).chr($rec).chr($dat).
      chr($len >> 8).
      chr($len & 0xff).
      $val;
    else
      return chr(0x1c).chr($rec).chr($dat).
      chr(0x80).chr(0x04).
      chr(($len >> 24) & 0xff).
      chr(($len >> 16) & 0xff).
      chr(($len >> 8 ) & 0xff).
      chr(($len ) & 0xff).
      $val;
  }



/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Write XMP Data
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  //http://xmpphptoolkit.sourceforge.net/


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Add Text
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addText($text, $pos = '20x20', $padding = 0, $fontColor='#fff', $fontSize = 12, $angle = 0, $font = null)
    # Author:     Jarrod Oberto
  # Date:       18-11-09
    # Purpose:    Add text to an image
    # Param in:
    # Param out:
    # Reference:  http://php.net/manual/en/function.imagettftext.php
    # Notes:      Make sure you supply the font.
    #
  {

    // *** Convert color
    $rgbArray = $this->formatColor($fontColor);
    $r = $rgbArray['r'];
    $g = $rgbArray['g'];
    $b = $rgbArray['b'];

    // *** Get text font
    $font = $this->getTextFont($font);

    // *** Get text size
    $textSizeArray = $this->getTextSize($fontSize, $angle, $font, $text);
    $textWidth = $textSizeArray['width'];
    $textHeight = $textSizeArray['height'];

    // *** Find co-ords to place text
    $posArray = $this->calculatePosition($pos, $padding, $textWidth, $textHeight, false);
    $x = $posArray['width'];
    $y = $posArray['height'];

    $fontColor = imagecolorallocate($this->imageResized, $r, $g, $b);

    // *** Add text
    imagettftext($this->imageResized, $fontSize, $angle, $x, $y, $fontColor, $font, $text);
  }

  ## --------------------------------------------------------

  private function getTextFont($font)
  {
    // *** Font path (shou
    $fontPath =  __DIR__ . '/' . $this->fontDir;


    // *** The below is/may be needed depending on your version (see ref)
    putenv('GDFONTPATH=' . realpath('.'));

    // *** Check if the passed in font exsits...
    if ($font == null || !file_exists($font)) {

      // *** ...If not, default to this font.
      $font = $fontPath . '/arimo.ttf';

      // *** Check our default font exists...
      if (!file_exists($font)) {

        // *** If not, return false
        if ($this->debug) { throw new Exception('Font not found'); }else{ return false; }
      }
    }

    return $font;

  }

  ## --------------------------------------------------------

  private function getTextSize($fontSize, $angle, $font, $text)
  {

    // *** Define box (so we can get the width)
    $box = @imageTTFBbox($fontSize, $angle, $font, $text);

    // ***  Get width of text from dimensions
    $textWidth = abs($box[4] - $box[0]);

    // ***  Get height of text from dimensions (should also be same as $fontSize)
    $textHeight = abs($box[5] - $box[1]);

    return array('height' => $textHeight, 'width' => $textWidth);
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  Add Watermark
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  public function addWatermark($watermarkImage, $pos, $padding = 0, $opacity = 0)
    # Author:     Jarrod Oberto
    # Date:       18-11-09
    # Purpose:    Add watermark image
    # Param in:   (str) $watermark: The watermark image
  #       (str) $pos: Could be a pre-determined position such as:
  #           tl = top left,
  #           t  = top (middle),
  #           tr = top right,
  #           l  = left,
  #           m  = middle,
  #           r  = right,
  #           bl = bottom left,
  #           b  = bottom (middle),
  #           br = bottom right
  #         Or, it could be a co-ordinate position such as: 50x100
  #
  #       (int) $padding: If using a pre-determined position you can
  #         adjust the padding from the edges by passing an amount
  #         in pixels. If using co-ordinates, this value is ignored.
    # Param out:
    # Reference:  http://www.php.net/manual/en/image.examples-watermark.php
    # Notes:      Based on example in reference.
  #
    #
  {

    // Load the stamp and the photo to apply the watermark to
    $stamp = $this->openImage ($watermarkImage);    # stamp
    $im = $this->imageResized;            # photo

    // *** Get stamps width and height
    $sx = imagesx($stamp);
    $sy = imagesy($stamp);

    // *** Find co-ords to place image
    $posArray = $this->calculatePosition($pos, $padding, $sx, $sy);
    $x = $posArray['width'];
    $y = $posArray['height'];

    // *** Set watermark opacity
    if (fix_strtolower(strrchr($watermarkImage, '.')) == '.png') {

      $opacity = $this->invertTransparency($opacity, 100);
      $this->filterOpacity($stamp, $opacity);
    }

    // Copy the watermark image onto our photo
    imagecopy($im, $stamp, $x, $y, 0, 0, imagesx($stamp), imagesy($stamp));

  }

  ## --------------------------------------------------------

  private function calculatePosition($pos, $padding, $assetWidth, $assetHeight, $upperLeft = true)
  #
  # Author:   Jarrod Oberto
  # Date:   08-05-11
  # Purpose:  Calculate the x, y pixel cordinates of the asset to place
  # Params in:  (str) $pos: Either something like: "tl", "l", "br" or an
  #         exact position like: "100x50"
  #       (int) $padding: The amount of padding from the edge. Only
  #         used for the predefined $pos.
  #       (int) $assetWidth: The width of the asset to add to the image
  #       (int) $assetHeight: The height of the asset to add to the image
  #       (bol) $upperLeft: if true, the asset will be positioned based
  #         on the upper left x, y coords. If false, it means you're
  #         using the lower left as the basepoint and this will
  #         convert it to the upper left position
  # Params out:
  # NOTE: this is done from the UPPER left corner!! But will convert lower
  #   left basepoints to upper left if $upperleft is set to false
  #
  #
  {
    $pos = fix_strtolower($pos);

    // *** If co-ords have been entered
    if (strstr($pos, 'x')) {
      $pos = str_replace(' ', '', $pos);

      $xyArray = explode('x', $pos);
      list($width, $height) = $xyArray;

    } else {

      switch ($pos) {
        case 'tl':
          $width = 0 + $padding;
          $height = 0 + $padding;
          break;

        case 't':
          $width = ($this->width / 2) - ($assetWidth / 2);
          $height = 0 + $padding;
          break;

        case 'tr':
          $width = $this->width - $assetWidth - $padding;
          $height = 0 + $padding;;
          break;

        case 'l':
          $width = 0 + $padding;
          $height = ($this->height / 2) - ($assetHeight / 2);
          break;

        case 'm':
          $width = ($this->width / 2) - ($assetWidth / 2);
          $height = ($this->height / 2) - ($assetHeight / 2);
          break;

        case 'r':
          $width = $this->width - $assetWidth - $padding;
          $height = ($this->height / 2) - ($assetHeight / 2);
          break;

        case 'bl':
          $width = 0 + $padding;
          $height = $this->height - $assetHeight - $padding;
          break;

        case 'b':
          $width = ($this->width / 2) - ($assetWidth / 2);
          $height = $this->height - $assetHeight - $padding;
          break;

        case 'br':
          $width = $this->width - $assetWidth - $padding;
          $height = $this->height - $assetHeight - $padding;
          break;

        default:
          $width = 0;
          $height = 0;
          break;
      }
    }

    if (!$upperLeft) {
      $height = $height + $assetHeight;
    }

    return array('width' => $width, 'height' => $height);
  }


  ## --------------------------------------------------------

  private function filterOpacity(&$img, $opacity = 75)
  #
  # Author:     aiden dot mail at freemail dot hu
  # Author date:  29-03-08 08:16
  # Date added:   08-05-11
  # Purpose:    Change opacity of image
  # Params in:    $img: Image resource id
  #         (int) $opacity: the opacity amount: 0-100, 100 being not opaque.
  # Params out:   (bool) true on success, else false
  # Ref:      http://www.php.net/manual/en/function.imagefilter.php#82162
  # Notes:      png only
  #
  {

    if (!isset($opacity)) {
      return false;
    }

    if ($opacity == 100) {
      return true;
    }

    $opacity /= 100;

    //get image width and height
    $w = imagesx($img);
    $h = imagesy($img);

    //turn alpha blending off
    imagealphablending($img, false);

    //find the most opaque pixel in the image (the one with the smallest alpha value)
    $minalpha = 127;
    for ($x = 0; $x < $w; $x++)
      for ($y = 0; $y < $h; $y++) {
        $alpha = ( imagecolorat($img, $x, $y) >> 24 ) & 0xFF;
        if ($alpha < $minalpha) {
          $minalpha = $alpha;
        }
      }

    //loop through image pixels and modify alpha for each
    for ($x = 0; $x < $w; $x++) {
      for ($y = 0; $y < $h; $y++) {
        //get current alpha value (represents the TANSPARENCY!)
        $colorxy = imagecolorat($img, $x, $y);
        $alpha = ( $colorxy >> 24 ) & 0xFF;
        //calculate new alpha
        if ($minalpha !== 127) {
          $alpha = 127 + 127 * $opacity * ( $alpha - 127 ) / ( 127 - $minalpha );
        } else {
          $alpha += 127 * $opacity;
        }
        //get the color index with new alpha
        $alphacolorxy = imagecolorallocatealpha($img, ( $colorxy >> 16 ) & 0xFF, ( $colorxy >> 8 ) & 0xFF, $colorxy & 0xFF, $alpha);
        //set pixel with the new color + opacity
        if (!imagesetpixel($img, $x, $y, $alphacolorxy)) {

          return false;
        }
      }
    }

    return true;
  }

## --------------------------------------------------------

    private function openImage($file)
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:
    # Param in:
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {

    if (!file_exists($file) && !$this->checkStringStartsWith('http://', $file)) { if ($this->debug) { throw new Exception('Image not found.'); }else{ throw new Exception(); }};

        // *** Get extension
        $extension = strrchr($file, '.');
        $extension = fix_strtolower($extension);
        switch($extension)
        {
            case '.jpg':
            case '.jpeg':
                $img = @imagecreatefromjpeg($file);
                break;
            case '.gif':
                $img = @imagecreatefromgif($file);
                break;
            case '.png':
                $img = @imagecreatefrompng($file);
                break;
            case '.bmp':
                $img = @$this->imagecreatefrombmp($file);
                break;
            case '.psd':
                $img = @$this->imagecreatefrompsd($file);
                break;


            // ... etc

            default:
                $img = false;
                break;
        }

        return $img;
    }

## --------------------------------------------------------

  public function reset()
  #
  # Author:   Jarrod Oberto
  # Date:   30-08-11
  # Purpose:  Reset the resource (allow further editing)
  # Params in:
  # Params out:
  # Notes:
  #
  {
    $this->__construct($this->fileName);
  }

## --------------------------------------------------------

    public function saveImage($savePath, $imageQuality="100")
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:    Saves the image
    # Param in:   $savePath: Where to save the image including filename:
    #             $imageQuality: image quality you want the image saved at 0-100
    # Param out:  n/a
    # Reference:
    # Notes:    * gif doesn't have a quality parameter
  #       * jpg has a quality setting 0-100 (100 being the best)
    #       * png has a quality setting 0-9 (0 being the best)
  #
  #             * bmp files have no native support for bmp files. We use a
  #       third party class to save as bmp.
    {

    // *** Perform a check or two.
    if (!is_resource($this->imageResized)) { if ($this->debug) { throw new Exception('saveImage: This is not a resource.'); }else{ throw new Exception(); }}
    $fileInfoArray = pathInfo($savePath);
    clearstatcache();
    if (!is_writable($fileInfoArray['dirname'])) {  if ($this->debug) { throw new Exception('The path is not writable. Please check your permissions.'); }else{ throw new Exception(); }}

    // *** Get extension
        $extension = strrchr($savePath, '.');
        $extension = fix_strtolower($extension);

    $error = '';

        switch($extension)
        {
            case '.jpg':
            case '.jpeg':
        $this->checkInterlaceImage($this->isInterlace);
        if (imagetypes() & IMG_JPG) {
          imagejpeg($this->imageResized, $savePath, $imageQuality);
        } else { $error = 'jpg'; }
                break;

            case '.gif':
        $this->checkInterlaceImage($this->isInterlace);
        if (imagetypes() & IMG_GIF) {
          imagegif($this->imageResized, $savePath);
        } else { $error = 'gif'; }
                break;

            case '.png':
        // *** Scale quality from 0-100 to 0-9
        $scaleQuality = round(($imageQuality/100) * 9);

        // *** Invert qualit setting as 0 is best, not 9
        $invertScaleQuality = 9 - $scaleQuality;

        $this->checkInterlaceImage($this->isInterlace);
        if (imagetypes() & IMG_PNG) {
           imagepng($this->imageResized, $savePath, $invertScaleQuality);
        } else { $error = 'png'; }
                break;

            case '.bmp':
        file_put_contents($savePath, $this->GD2BMPstring($this->imageResized));
          break;


            // ... etc

            default:
        // *** No extension - No save.
        $this->errorArray[] = 'This file type (' . $extension . ') is not supported. File not saved.';
                break;
        }

    //imagedestroy($this->imageResized);

    // *** Display error if a file type is not supported.
    if ($error != '') {
      $this->errorArray[] = $error . ' support is NOT enabled. File not saved.';
    }
    }

## --------------------------------------------------------

  public function displayImage($fileType = 'jpg', $imageQuality="100")
    # Author:     Jarrod Oberto
    # Date:       18-11-09
    # Purpose:    Display images directly to the browser
    # Param in:   The image type you want to display
    # Param out:
    # Reference:
    # Notes:
    #
  {

    if (!is_resource($this->imageResized)) { if ($this->debug) { throw new Exception('saveImage: This is not a resource.'); }else{ throw new Exception(); }}

        switch($fileType)
        {
            case 'jpg':
            case 'jpeg':
        header('Content-type: image/jpeg');
        imagejpeg($this->imageResized, '', $imageQuality);
                break;
            case 'gif':
        header('Content-type: image/gif');
        imagegif($this->imageResized);
                break;
            case 'png':
        header('Content-type: image/png');

        // *** Scale quality from 0-100 to 0-9
        $scaleQuality = round(($imageQuality/100) * 9);

        // *** Invert qualit setting as 0 is best, not 9
        $invertScaleQuality = 9 - $scaleQuality;

        imagepng($this->imageResized, '', $invertScaleQuality);
        break;
      case 'bmp':
        echo 'bmp file format is not supported.';
        break;

            // ... etc

            default:
        // *** No extension - No save.
                break;
        }


    //imagedestroy($this->imageResized);
  }

## --------------------------------------------------------

  public function setTransparency($bool)
  # Sep 2011
  {
    $this->keepTransparency = $bool;
  }

## --------------------------------------------------------

  public function setFillColor($value)
  # Sep 2011
    # Param in:   (mixed) $value: (array) Could be an array of RGB
  #               (str) Could be hex #ffffff or #fff, fff, ffffff
  #
  # If the keepTransparency is set to false, then no transparency is to be used.
  # This is ideal when you want to save as jpg.
  #
  # this method allows you to set the background color to use instead of
  # transparency.
  #
  {
    $colorArray = $this->formatColor($value);
    $this->fillColorArray = $colorArray;
  }

## --------------------------------------------------------

  public function setCropFromTop($value)
  # Sep 2011
  {
    $this->cropFromTopPercent = $value;
  }

## --------------------------------------------------------

    public function testGDInstalled()
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:    Test to see if GD is installed
    # Param in:   n/a
    # Param out:  (bool) True is gd extension loaded otherwise false
    # Reference:
    # Notes:
    #
    {
        if(extension_loaded('gd') && function_exists('gd_info'))
        {
            $gdInstalled = true;
        }
        else
        {
            $gdInstalled = false;
        }

        return $gdInstalled;
    }

## --------------------------------------------------------

    public function testEXIFInstalled()
    # Author:     Jarrod Oberto
    # Date:       08-05-11
    # Purpose:    Test to see if EXIF is installed
    # Param in:   n/a
    # Param out:  (bool) True is exif extension loaded otherwise false
    # Reference:
    # Notes:
    #
    {
        if(extension_loaded('exif'))
        {
            $exifInstalled = true;
        }
        else
        {
            $exifInstalled = false;
        }

        return $exifInstalled;
    }

## --------------------------------------------------------

    public function testIsImage($image)
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:    Test if file is an image
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
        if ($image)
        {
            $fileIsImage = true;
        }
        else
        {
            $fileIsImage = false;
        }

        return $fileIsImage;
    }

## --------------------------------------------------------

    public function testFunct()
    # Author:     Jarrod Oberto
    # Date:       27-02-08
    # Purpose:    Test Function
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
        echo $this->height;
    }

## --------------------------------------------------------

    public function setForceStretch($value)
    # Author:     Jarrod Oberto
    # Date:       23-12-10
    # Purpose:
    # Param in:   (bool) $value
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
        $this->forceStretch = $value;
    }

## --------------------------------------------------------

    public function setFile($fileName)
    # Author:     Jarrod Oberto
    # Date:       28-02-08
    # Purpose:
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
        self::__construct($fileName);
    }

## --------------------------------------------------------

  public function getFileName()
    # Author:     Jarrod Oberto
    # Date:       10-09-08
    # Purpose:
    # Param in:   n/a
    # Param out:  n/a
    # Reference:
    # Notes:
    #
    {
      return $this->fileName;
    }

## --------------------------------------------------------

  public function getHeight()
    {
      return $this->height;
    }

## --------------------------------------------------------

  public function getWidth()
    {
      return $this->width;
    }

## --------------------------------------------------------

  public function getOriginalHeight()
    {
      return $this->heightOriginal;
    }

## --------------------------------------------------------

  public function getOriginalWidth()
    {
      return $this->widthOriginal;
    }

## --------------------------------------------------------

  public function getErrors()
    # Author:     Jarrod Oberto
    # Date:       19-11-09
    # Purpose:    Returns the error array
    # Param in:   n/a
    # Param out:  Array of errors
    # Reference:
    # Notes:
    #
  {
    return $this->errorArray;
  }

## --------------------------------------------------------

  private function checkInterlaceImage($isEnabled)
  # jpg will use progressive (they don't use interace)
  {
    if ($isEnabled) {
      imageinterlace($this->imageResized, $isEnabled);
    }
  }

## --------------------------------------------------------

  protected function formatColor($value)
    # Author:     Jarrod Oberto
    # Date:       09-05-11
    # Purpose:    Determine color method passed in and return color as RGB
    # Param in:   (mixed) $value: (array) Could be an array of RGB
  #               (str) Could be hex #ffffff or #fff, fff, ffffff
    # Param out:
    # Reference:
    # Notes:
    #
  {
    $rgbArray = array();

    // *** If it's an array it should be R, G, B
    if (is_array($value)) {

      if (key($value) == 0 && count($value) == 3) {

        $rgbArray['r'] = $value[0];
        $rgbArray['g'] = $value[1];
        $rgbArray['b'] = $value[2];

      } else {
        $rgbArray = $value;
      }
    } else if (fix_strtolower($value) == 'transparent') {

      $rgbArray = array(
        'r' => 255,
        'g' => 255,
        'b' => 255,
        'a' => 127
      );

    } else {

      // *** ...Else it should be hex. Let's make it RGB
      $rgbArray = $this -> hex2dec($value);
    }

    return $rgbArray;
  }

  ## --------------------------------------------------------

  function hex2dec($hex)
  # Purpose:  Convert #hex color to RGB
  {
    $color = str_replace('#', '', $hex);

    if (strlen($color) == 3) {
      $color = $color . $color;
    }

    $rgb = array(
      'r' => hexdec(substr($color, 0, 2)),
      'g' => hexdec(substr($color, 2, 2)),
      'b' => hexdec(substr($color, 4, 2)),
      'a' => 0
    );
    return $rgb;
  }

  ## --------------------------------------------------------

  private function createImageColor ($colorArray)
  {
    $r = $colorArray['r'];
    $g = $colorArray['g'];
    $b = $colorArray['b'];

    return imagecolorallocate($this->imageResized, $r, $g, $b);
  }

  ## --------------------------------------------------------

  private function testColorExists($colorArray)
  {
    $r = $colorArray['r'];
    $g = $colorArray['g'];
    $b = $colorArray['b'];

    if (imagecolorexact($this->imageResized, $r, $g, $b) == -1) {
      return false;
    } else {
      return true;
    }
  }

  ## --------------------------------------------------------

  private function findUnusedGreen()
  # Purpose:  We find a green color suitable to use like green-screen effect.
  #     Therefore, the color must not exist in the image.
  {
    $green = 255;

    do {

      $greenChroma = array(0, $green, 0);
      $colorArray = $this->formatColor($greenChroma);
      $match = $this->testColorExists($colorArray);
      $green--;

    } while ($match == false && $green > 0);

    // *** If no match, just bite the bullet and use green value of 255
    if (!$match) {
      $greenChroma = array(0, $green, 0);
    }

    return $greenChroma;
  }

  ## --------------------------------------------------------

  private function findUnusedBlue()
  # Purpose:  We find a green color suitable to use like green-screen effect.
  #     Therefore, the color must not exist in the image.
  {
    $blue = 255;

    do {

      $blueChroma = array(0, 0, $blue);
      $colorArray = $this->formatColor($blueChroma);
      $match = $this->testColorExists($colorArray);
      $blue--;

    } while ($match == false && $blue > 0);

    // *** If no match, just bite the bullet and use blue value of 255
    if (!$match) {
      $blueChroma = array(0, 0, $blue);
    }

    return $blueChroma;
  }

  ## --------------------------------------------------------

  private function invertTransparency($value, $originalMax, $invert=true)
  # Purpose:  This does two things:
  #       1) Convert the range from 0-127 to 0-100
  #       2) Inverts value to 100 is not transparent while 0 is fully
  #          transparent (like Photoshop)
  {
    // *** Test max range
    if ($value > $originalMax) {
      $value = $originalMax;
    }

    // *** Test min range
    if ($value < 0) {
      $value = 0;
    }

    if ($invert) {
      return $originalMax - (($value/100) * $originalMax);
    } else {
      return ($value/100) * $originalMax;
    }
  }

  ## --------------------------------------------------------

  private function transparentImage($src)
  {
    // *** making images with white bg transparent
    $r1 = 0;
    $g1 = 255;
    $b1 = 0;
    for ($x = 0; $x < imagesx($src); ++$x) {
      for ($y = 0; $y < imagesy($src); ++$y) {
        $color = imagecolorat($src, $x, $y);
        $r = ($color >> 16) & 0xFF;
        $g = ($color >> 8) & 0xFF;
        $b = $color & 0xFF;
        for ($i = 0; $i < 270; $i++) {
          //if ($r . $g . $b == ($r1 + $i) . ($g1 + $i) . ($b1 + $i)) {
          if ($r == 0 && $g == 255 && $b == 0) {
          //if ($g == 255) {
            $trans_colour = imagecolorallocatealpha($src, 0, 0, 0, 127);
            imagefill($src, $x, $y, $trans_colour);
          }
        }
      }
    }

    return $src;
  }

  ## --------------------------------------------------------

  function checkStringStartsWith($needle, $haystack)
  # Check if a string starts with a specific pattern
  {
    return (substr($haystack, 0, strlen($needle))==$needle);
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  BMP SUPPORT (SAVING) - James Heinrich
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  private function GD2BMPstring(&$gd_image)
    # Author:     James Heinrich
    # Purpose:    Save file as type bmp
    # Param in:   The image canvas (passed as ref)
    # Param out:
    # Reference:
    # Notes:    This code was stripped out of two external files
  #       (phpthumb.bmp.php,phpthumb.functions.php) and added below to
  #       avoid dependancies.
    #
  {
    $imageX = ImageSX($gd_image);
    $imageY = ImageSY($gd_image);

    $BMP = '';
    for ($y = ($imageY - 1); $y >= 0; $y--) {
      $thisline = '';
      for ($x = 0; $x < $imageX; $x++) {
        $argb = $this->GetPixelColor($gd_image, $x, $y);
        $thisline .= chr($argb['blue']).chr($argb['green']).chr($argb['red']);
      }
      while (strlen($thisline) % 4) {
        $thisline .= "\x00";
      }
      $BMP .= $thisline;
    }

    $bmpSize = strlen($BMP) + 14 + 40;
    // BITMAPFILEHEADER [14 bytes] - http://msdn.microsoft.com/library/en-us/gdi/bitmaps_62uq.asp
    $BITMAPFILEHEADER  = 'BM';                                    // WORD    bfType;
    $BITMAPFILEHEADER .= $this->LittleEndian2String($bmpSize, 4); // DWORD   bfSize;
    $BITMAPFILEHEADER .= $this->LittleEndian2String(       0, 2); // WORD    bfReserved1;
    $BITMAPFILEHEADER .= $this->LittleEndian2String(       0, 2); // WORD    bfReserved2;
    $BITMAPFILEHEADER .= $this->LittleEndian2String(      54, 4); // DWORD   bfOffBits;

    // BITMAPINFOHEADER - [40 bytes] http://msdn.microsoft.com/library/en-us/gdi/bitmaps_1rw2.asp
    $BITMAPINFOHEADER  = $this->LittleEndian2String(      40, 4); // DWORD  biSize;
    $BITMAPINFOHEADER .= $this->LittleEndian2String( $imageX, 4); // LONG   biWidth;
    $BITMAPINFOHEADER .= $this->LittleEndian2String( $imageY, 4); // LONG   biHeight;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(       1, 2); // WORD   biPlanes;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(      24, 2); // WORD   biBitCount;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(       0, 4); // DWORD  biCompression;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(       0, 4); // DWORD  biSizeImage;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(    2835, 4); // LONG   biXPelsPerMeter;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(    2835, 4); // LONG   biYPelsPerMeter;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(       0, 4); // DWORD  biClrUsed;
    $BITMAPINFOHEADER .= $this->LittleEndian2String(       0, 4); // DWORD  biClrImportant;

    return $BITMAPFILEHEADER.$BITMAPINFOHEADER.$BMP;
  }

## --------------------------------------------------------

  private function GetPixelColor(&$img, $x, $y)
    # Author:     James Heinrich
    # Purpose:
    # Param in:
    # Param out:
    # Reference:
    # Notes:
    #
  {
    if (!is_resource($img)) {
      return false;
    }
    return @ImageColorsForIndex($img, @ImageColorAt($img, $x, $y));
  }

## --------------------------------------------------------

  private function LittleEndian2String($number, $minbytes=1)
    # Author:     James Heinrich
    # Purpose:    BMP SUPPORT (SAVING)
    # Param in:
    # Param out:
    # Reference:
    # Notes:
    #
  {
    $intstring = '';
    while ($number > 0) {
      $intstring = $intstring.chr($number & 255);
      $number >>= 8;
    }
    return str_pad($intstring, $minbytes, "\x00", STR_PAD_RIGHT);
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  BMP SUPPORT (READING)
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  private function ImageCreateFromBMP($filename)
    # Author:     DHKold
    # Date:     The 15th of June 2005
  # Version:    2.0B
    # Purpose:    To create an image from a BMP file.
    # Param in:   BMP file to open.
    # Param out:  Return a resource like the other ImageCreateFrom functions
    # Reference:  http://us3.php.net/manual/en/function.imagecreate.php#53879
  # Bug fix:    Author:   domelca at terra dot es
  #       Date:   06 March 2008
  #       Fix:    Correct 16bit BMP support
    # Notes:
  #
  {

    //Ouverture du fichier en mode binaire
    if (! $f1 = fopen($filename,"rb")) return FALSE;

    //1 : Chargement des ent�tes FICHIER
    $FILE = unpack("vfile_type/Vfile_size/Vreserved/Vbitmap_offset", fread($f1,14));
    if ($FILE['file_type'] != 19778) return FALSE;

    //2 : Chargement des ent�tes BMP
    $BMP = unpack('Vheader_size/Vwidth/Vheight/vplanes/vbits_per_pixel'.
           '/Vcompression/Vsize_bitmap/Vhoriz_resolution'.
           '/Vvert_resolution/Vcolors_used/Vcolors_important', fread($f1,40));
    $BMP['colors'] = pow(2,$BMP['bits_per_pixel']);

    if ($BMP['size_bitmap'] == 0) $BMP['size_bitmap'] = $FILE['file_size'] - $FILE['bitmap_offset'];

    $BMP['bytes_per_pixel'] = $BMP['bits_per_pixel']/8;
    $BMP['bytes_per_pixel2'] = ceil($BMP['bytes_per_pixel']);
    $BMP['decal'] = ($BMP['width']*$BMP['bytes_per_pixel']/4);
       $BMP['decal'] -= floor($BMP['width']*$BMP['bytes_per_pixel']/4);
    $BMP['decal'] = 4-(4*$BMP['decal']);

    if ($BMP['decal'] == 4) $BMP['decal'] = 0;

    //3 : Chargement des couleurs de la palette
    $PALETTE = array();
    if ($BMP['colors'] < 16777216)
    {
      $PALETTE = unpack('V'.$BMP['colors'], fread($f1,$BMP['colors']*4));
    }

    //4 : Cr�ation de l'image
    $IMG = fread($f1,$BMP['size_bitmap']);
    $VIDE = chr(0);

    $res = imagecreatetruecolor($BMP['width'],$BMP['height']);
    $P = 0;
    $Y = $BMP['height']-1;
    while ($Y >= 0)
    {
      $X=0;
      while ($X < $BMP['width'])
      {
        if ($BMP['bits_per_pixel'] == 24)
          $COLOR = unpack("V",substr($IMG,$P,3).$VIDE);
        elseif ($BMP['bits_per_pixel'] == 16)
        {

          /*
           * BMP 16bit fix
           * =================
           *
           * Ref: http://us3.php.net/manual/en/function.imagecreate.php#81604
           *
           * Notes:
           * "don't work with bmp 16 bits_per_pixel. change pixel
           * generator for this."
           *
           */

          // *** Original code (don't work)
          //$COLOR = unpack("n",substr($IMG,$P,2));
          //$COLOR[1] = $PALETTE[$COLOR[1]+1];

          $COLOR = unpack("v",substr($IMG,$P,2));
          $blue = ($COLOR[1] & 0x001f) << 3;
          $green = ($COLOR[1] & 0x07e0) >> 3;
          $red = ($COLOR[1] & 0xf800) >> 8;
          $COLOR[1] = $red * 65536 + $green * 256 + $blue;

        }
        elseif ($BMP['bits_per_pixel'] == 8)
        {
          $COLOR = unpack("n",$VIDE.substr($IMG,$P,1));
          $COLOR[1] = $PALETTE[$COLOR[1]+1];
        }
        elseif ($BMP['bits_per_pixel'] == 4)
        {
          $COLOR = unpack("n",$VIDE.substr($IMG,floor($P),1));
          if (($P*2)%2 == 0) $COLOR[1] = ($COLOR[1] >> 4) ; else $COLOR[1] = ($COLOR[1] & 0x0F);
          $COLOR[1] = $PALETTE[$COLOR[1]+1];
        }
        elseif ($BMP['bits_per_pixel'] == 1)
        {
          $COLOR = unpack("n",$VIDE.substr($IMG,floor($P),1));
          if     (($P*8)%8 == 0) $COLOR[1] =  $COLOR[1]        >>7;
          elseif (($P*8)%8 == 1) $COLOR[1] = ($COLOR[1] & 0x40)>>6;
          elseif (($P*8)%8 == 2) $COLOR[1] = ($COLOR[1] & 0x20)>>5;
          elseif (($P*8)%8 == 3) $COLOR[1] = ($COLOR[1] & 0x10)>>4;
          elseif (($P*8)%8 == 4) $COLOR[1] = ($COLOR[1] & 0x8)>>3;
          elseif (($P*8)%8 == 5) $COLOR[1] = ($COLOR[1] & 0x4)>>2;
          elseif (($P*8)%8 == 6) $COLOR[1] = ($COLOR[1] & 0x2)>>1;
          elseif (($P*8)%8 == 7) $COLOR[1] = ($COLOR[1] & 0x1);
          $COLOR[1] = $PALETTE[$COLOR[1]+1];
        }
        else
          return FALSE;

        imagesetpixel($res,$X,$Y,$COLOR[1]);
        $X++;
        $P += $BMP['bytes_per_pixel'];
      }

      $Y--;
      $P+=$BMP['decal'];
    }
    //Fermeture du fichier
    fclose($f1);

    return $res;
  }


/*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*-
  PSD SUPPORT (READING)
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-**-*-*-*-*-*-*-*-*-*-*-*-*-*/

  private function imagecreatefrompsd($fileName)
  # Author:     Tim de Koning
  # Version:    1.3
  # Purpose:    To create an image from a PSD file.
  # Param in:   PSD file to open.
  # Param out:  Return a resource like the other ImageCreateFrom functions
  # Reference:  http://www.kingsquare.nl/phppsdreader
  # Notes:
  #
  {
    if (file_exists($this->psdReaderPath)) {


      include_once($this->psdReaderPath);

      $psdReader = new PhpPsdReader($fileName);

      if (isset($psdReader->infoArray['error'])) return '';
      else return $psdReader->getImage();
    } else {
      return false;
    }
  }

## --------------------------------------------------------

    public function __destruct() {
    if (is_resource($this->imageResized)) {
      imagedestroy($this->imageResized);
    }
  }

## --------------------------------------------------------

}




/*
 *    Example with some API calls (outdated):
 *
 *
 *      ===============================
 *      Compulsary
 *      ===============================
 *
 *      include("classes/resize_class.php");
 *
 *      // *** Initialise object
 *      $magicianObj = new resize('images/cars/large/a.jpg');
 *
 *      // *** Turn off stretching (optional)
 *      $magicianObj -> setForceStretch(false);
 *
 *      // *** Resize object
 *      $magicianObj -> resizeImage(150, 100, 0);
 *
 *      ===============================
 *      Image options - can run none, one, or all.
 *      ===============================
 *
 *      //  *** Add watermark
 *        $magicianObj -> addWatermark('stamp.png');
 *
 *          // *** Add text
 *      $magicianObj -> addText('testing...');
 *
 *      ===============================
 *      Output options - can run one, or the other, or both.
 *      ===============================
 *
 *      // *** Save image to disk
 *      $magicianObj -> saveImage('images/cars/large/b.jpg', 100);
 *
 *          // *** Or output to screen (params in can be jpg, gif, png)
 *      $magicianObj -> displayImage('png');
 *
 *      ===============================
 *      Return options - return errors. nice for debuggin.
 *      ===============================
 *
 *      // *** Return error array
 *      $errorArray = $magicianObj -> getErrors();
 *
 *
 *      ===============================
 *      Cleanup options - not really neccessary, but good practice
 *      ===============================
 *
 *      // *** Free used memory
 *      $magicianObj -> __destruct();
 */
?>