* 
 *   
 *   
 * 
 * 

 *  $handle = new upload($_FILES['image_field']);
 *  if ($handle->uploaded) {
 *      $handle->file_new_name_body   = 'image_resized';
 *      $handle->image_resize         = true;
 *      $handle->image_x              = 100;
 *      $handle->image_ratio_y        = true;
 *      $handle->process('/home/user/files/');
 *      if ($handle->processed) {
 *          echo 'image resized';
 *          $handle->clean();
 *      } else {
 *          echo 'error : ' . $handle->error;
 *      }
 *  }
 * 

 *  $handle = new upload('/home/user/myfile.jpg');
 * 

 *  $handle = new upload($_FILES['image_field'], 'fr_FR');
 *  $handle = new upload('/home/user/myfile.jpg', 'fr_FR');
 * 

 *  $handle = new upload($_FILES['image_field']);
 *  header('Content-type: ' . $handle->file_src_mime);
 *  echo $handle->Process();
 *  die();
 * 

 *  $handle = new upload($_FILES['image_field']);
 *  header('Content-type: ' . $handle->file_src_mime);
 *  header("Content-Disposition: attachment; filename=".rawurlencode($handle->file_src_name).";");
 *  echo $handle->Process();
 *  die();
 * 

*
• {@link file_new_name_body} replaces the name body (default: null)
  *

  $handle->file_new_name_body = 'new name';

*
• {@link file_name_body_add} appends to the name body (default: null)
  *

  $handle->file_name_body_add = '_uploaded';

*
• {@link file_name_body_pre} prepends to the name body (default: null)
  *

  $handle->file_name_body_pre = 'thumb_';

*
• {@link file_new_name_ext} replaces the file extension (default: null)
  *

  $handle->file_new_name_ext = 'txt';

*
• {@link file_safe_name} formats the filename (spaces changed to _) (default: true)
  *

  $handle->file_safe_name = true;

*
• {@link file_force_extension} forces an extension if there is't any (default: true)
  *

  $handle->file_force_extension = true;

*
• {@link file_overwrite} sets behaviour if file already exists (default: false)
  *

  $handle->file_overwrite = true;

*
• {@link file_auto_rename} automatically renames file if it already exists (default: true)
  *

  $handle->file_auto_rename = true;

*
• {@link dir_auto_create} automatically creates destination directory if missing (default: true)
  *

  $handle->auto_create_dir = true;

*
• {@link dir_auto_chmod} automatically attempts to chmod the destination directory if not writeable (default: true)
  *

  $handle->dir_auto_chmod = true;

*
• {@link dir_chmod} chmod used when creating directory or if directory not writeable (default: 0777)
  *

  $handle->dir_chmod = 0777;

*
• {@link file_max_size} sets maximum upload size (default: upload_max_filesize from php.ini)
  *

  $handle->file_max_size = '1024'; // 1KB

*
• {@link mime_check} sets if the class check the MIME against the {@link allowed} list (default: true)
  *

  $handle->mime_check = true;

*
• {@link no_script} sets if the class turns scripts into text files (default: true)
  *

  $handle->no_script = false;

*
• {@link allowed} array of allowed mime-types (or one string). wildcard accepted, as in image/* (default: check {@link Init})
  *

  $handle->allowed = array('application/pdf','application/msword', 'image/*');

*
• {@link forbidden} array of forbidden mime-types (or one string). wildcard accepted, as in image/* (default: check {@link Init})
  *

  $handle->forbidden = array('application/*');

*

*
• {@link image_convert} if set, image will be converted (possible values : ''|'png'|'jpeg'|'gif'|'bmp'; default: '')
  *

  $handle->image_convert = 'jpg';

*
• {@link image_background_color} if set, will forcibly fill transparent areas with the color, in hexadecimal (default: null)
  *

  $handle->image_background_color = '#FF00FF';

*
• {@link image_default_color} fallback color background color for non alpha-transparent output formats, such as JPEG or BMP, in hexadecimal (default: #FFFFFF)
  *

  $handle->image_default_color = '#FF00FF';

*
• {@link jpeg_quality} sets the compression quality for JPEG images (default: 85)
  *

  $handle->jpeg_quality = 50;

*
• {@link jpeg_size} if set to a size in bytes, will approximate {@link jpeg_quality} so the output image fits within the size (default: null)
  *

  $handle->jpeg_size = 3072;

*

*
• {@link image_max_width} if set to a dimension in pixels, the upload will be invalid if the image width is greater (default: null)
  *

  $handle->image_max_width = 200;

*
• {@link image_max_height} if set to a dimension in pixels, the upload will be invalid if the image height is greater (default: null)
  *

  $handle->image_max_height = 100;

*
• {@link image_max_pixels} if set to a number of pixels, the upload will be invalid if the image number of pixels is greater (default: null)
  *

  $handle->image_max_pixels = 50000;

*
• {@link image_max_ratio} if set to a aspect ratio (width/height), the upload will be invalid if the image apect ratio is greater (default: null)
  *

  $handle->image_max_ratio = 1.5;

*
• {@link image_min_width} if set to a dimension in pixels, the upload will be invalid if the image width is lower (default: null)
  *

  $handle->image_min_width = 100;

*
• {@link image_min_height} if set to a dimension in pixels, the upload will be invalid if the image height is lower (default: null)
  *

  $handle->image_min_height = 500;

*
• {@link image_min_pixels} if set to a number of pixels, the upload will be invalid if the image number of pixels is lower (default: null)
  *

  $handle->image_min_pixels = 20000;

*
• {@link image_min_ratio} if set to a aspect ratio (width/height), the upload will be invalid if the image apect ratio is lower (default: null)
  *

  $handle->image_min_ratio = 0.5;

*

*
• {@link image_resize} determines is an image will be resized (default: false)
  *

  $handle->image_resize = true;

*

*
• {@link image_x} destination image width (default: 150)
  *

  $handle->image_x = 100;

*
• {@link image_y} destination image height (default: 150)
  *

  $handle->image_y = 200;

*

*
• {@link image_ratio} if true, resize image conserving the original sizes ratio, using {@link image_x} AND {@link image_y} as max sizes if true (default: false)
  *

  $handle->image_ratio = true;

*
• {@link image_ratio_crop} if true, resize image conserving the original sizes ratio, using {@link image_x} AND {@link image_y} as max sizes, and cropping excedent to fill the space. setting can also be a string, with one or more from 'TBLR', indicating which side of the image will be kept while cropping (default: false)
  *

  $handle->image_ratio_crop = true;

*
• {@link image_ratio_fill} if true, resize image conserving the original sizes ratio, using {@link image_x} AND {@link image_y} as max sizes, fitting the image in the space and coloring the remaining space. setting can also be a string, with one or more from 'TBLR', indicating which side of the space the image will be in (default: false)
  *

  $handle->image_ratio_fill = true;

*
• {@link image_ratio_no_zoom_in} same as {@link image_ratio}, but won't resize if the source image is smaller than {@link image_x} x {@link image_y} (default: false)
  *

  $handle->image_ratio_no_zoom_in = true;

*
• {@link image_ratio_no_zoom_out} same as {@link image_ratio}, but won't resize if the source image is bigger than {@link image_x} x {@link image_y} (default: false)
  *

  $handle->image_ratio_no_zoom_out = true;

*
• {@link image_ratio_x} if true, resize image, calculating {@link image_x} from {@link image_y} and conserving the original sizes ratio (default: false)
  *

  $handle->image_ratio_x = true;

*
• {@link image_ratio_y} if true, resize image, calculating {@link image_y} from {@link image_x} and conserving the original sizes ratio (default: false)
  *

  $handle->image_ratio_y = true;

*
• {@link image_ratio_pixels} if set to a long integer, resize image, calculating {@link image_y} and {@link image_x} to match a the number of pixels (default: false)
  *

  $handle->image_ratio_pixels = 25000;

*

*
• {@link image_brightness} if set, corrects the brightness. value between -127 and 127 (default: null)
  *

  $handle->image_brightness = 40;

*
• {@link image_contrast} if set, corrects the contrast. value between -127 and 127 (default: null)
  *

  $handle->image_contrast = 50;

*
• {@link image_opacity} if set, changes the image opacity. value between 0 and 100 (default: null)
  *

  $handle->image_opacity = 50;

*
• {@link image_tint_color} if set, will tint the image with a color, value as hexadecimal #FFFFFF (default: null)
  *

  $handle->image_tint_color = '#FF0000';

*
• {@link image_overlay_color} if set, will add a colored overlay, value as hexadecimal #FFFFFF (default: null)
  *

  $handle->image_overlay_color = '#FF0000';

*
• {@link image_overlay_opacity} used when {@link image_overlay_color} is set, determines the opacity (default: 50)
  *

  $handle->image_overlay_opacity = 20;

*
• {@link image_negative} inverts the colors in the image (default: false)
  *

  $handle->image_negative = true;

*
• {@link image_greyscale} transforms an image into greyscale (default: false)
  *

  $handle->image_greyscale = true;

*
• {@link image_threshold} applies a threshold filter. value between -127 and 127 (default: null)
  *

  $handle->image_threshold = 20;

*
• {@link image_unsharp} applies an unsharp mask, with alpha transparency support (default: false)
  *

  $handle->image_unsharp = true;

*
• {@link image_unsharp_amount} unsharp mask amount, typically 50 - 200 (default: 80)
  *

  $handle->image_unsharp_amount = 120;

*
• {@link image_unsharp_radius} unsharp mask radius, typically 0.5 - 1 (default: 0.5)
  *

  $handle->image_unsharp_radius = 0.8;

*
• {@link image_unsharp_threshold} unsharp mask threshold, typically 0 - 5 (default: 1)
  *

  $handle->image_unsharp_threshold = 0;

*

*
• {@link image_text} creates a text label on the image, value is a string, with eventual replacement tokens (default: null)
  *

  $handle->image_text = 'test';

*
• {@link image_text_direction} text label direction, either 'h' horizontal or 'v' vertical (default: 'h')
  *

  $handle->image_text_direction = 'v';

*
• {@link image_text_color} text color for the text label, in hexadecimal (default: #FFFFFF)
  *

  $handle->image_text_color = '#FF0000';

*
• {@link image_text_opacity} text opacity on the text label, integer between 0 and 100 (default: 100)
  *

  $handle->image_text_opacity = 50;

*
• {@link image_text_background} text label background color, in hexadecimal (default: null)
  *

  $handle->image_text_background = '#FFFFFF';

*
• {@link image_text_background_opacity} text label background opacity, integer between 0 and 100 (default: 100)
  *

  $handle->image_text_background_opacity = 50;

*
• {@link image_text_font} built-in font for the text label, from 1 to 5. 1 is the smallest (default: 5)
  *

  $handle->image_text_font = 4;

*
• {@link image_text_x} absolute text label position, in pixels from the left border. can be negative (default: null)
  *

  $handle->image_text_x = 5;

*
• {@link image_text_y} absolute text label position, in pixels from the top border. can be negative (default: null)
  *

  $handle->image_text_y = 5;

*
• {@link image_text_position} text label position withing the image, a combination of one or two from 'TBLR': top, bottom, left, right (default: null)
  *

  $handle->image_text_position = 'LR';

*
• {@link image_text_padding} text label padding, in pixels. can be overridden by {@link image_text_padding_x} and {@link image_text_padding_y} (default: 0)
  *

  $handle->image_text_padding = 5;

*
• {@link image_text_padding_x} text label horizontal padding (default: null)
  *

  $handle->image_text_padding_x = 2;

*
• {@link image_text_padding_y} text label vertical padding (default: null)
  *

  $handle->image_text_padding_y = 10;

*
• {@link image_text_alignment} text alignment when text has multiple lines, either 'L', 'C' or 'R' (default: 'C')
  *

  $handle->image_text_alignment = 'R';

*
• {@link image_text_line_spacing} space between lines in pixels, when text has multiple lines (default: 0)
  *

  $handle->image_text_line_spacing = 3;

*

*
• {@link image_flip} flips image, wither 'h' horizontal or 'v' vertical (default: null)
  *

  $handle->image_flip = 'h';

*
• {@link image_rotate} rotates image. possible values are 90, 180 and 270 (default: null)
  *

  $handle->image_rotate = 90;

*
• {@link image_crop} crops image. accepts 4, 2 or 1 values as 'T R B L' or 'TB LR' or 'TBLR'. dimension can be 20, or 20px or 20% (default: null)
  *

  $handle->image_crop = array(50,40,30,20); OR '-20 20%'...

*
• {@link image_precrop} crops image, before an eventual resizing. accepts 4, 2 or 1 values as 'T R B L' or 'TB LR' or 'TBLR'. dimension can be 20, or 20px or 20% (default: null)
  *

  $handle->image_precrop = array(50,40,30,20); OR '-20 20%'...

*

*
• {@link image_bevel} adds a bevel border to the image. value is thickness in pixels (default: null)
  *

  $handle->image_bevel = 20;

*
• {@link image_bevel_color1} top and left bevel color, in hexadecimal (default: #FFFFFF)
  *

  $handle->image_bevel_color1 = '#FFFFFF';

*
• {@link image_bevel_color2} bottom and right bevel color, in hexadecimal (default: #000000)
  *

  $handle->image_bevel_color2 = '#000000';

*
• {@link image_border} adds a unicolor border to the image. accepts 4, 2 or 1 values as 'T R B L' or 'TB LR' or 'TBLR'. dimension can be 20, or 20px or 20% (default: null)
  *

  $handle->image_border = '3px'; OR '-20 20%' OR array(3,2)...

*
• {@link image_border_color} border color, in hexadecimal (default: #FFFFFF)
  *

  $handle->image_border_color = '#FFFFFF';

*
• {@link image_border_opacity} border opacity, integer between 0 and 100 (default: 100)
  *

  $handle->image_border_opacity = 50;

*
• {@link image_border_transparent} adds a fading-to-transparent border to the image. accepts 4, 2 or 1 values as 'T R B L' or 'TB LR' or 'TBLR'. dimension can be 20, or 20px or 20% (default: null)
  *

  $handle->image_border_transparent = '3px'; OR '-20 20%' OR array(3,2)...

*
• {@link image_frame} type of frame: 1=flat 2=crossed (default: null)
  *

  $handle->image_frame = 2;

*
• {@link image_frame_colors} list of hex colors, in an array or a space separated string (default: '#FFFFFF #999999 #666666 #000000')
  *

  $handle->image_frame_colors = array('#999999',  '#FF0000', '#666666', '#333333', '#000000');

*
• {@link image_frame_opacity} frame opacity, integer between 0 and 100 (default: 100)
  *

  $handle->image_frame_opacity = 50;

*

*
• {@link image_watermark} adds a watermark on the image, value is a local filename. accepted files are GIF, JPG, BMP, PNG and PNG alpha (default: null)
  *

  $handle->image_watermark = 'watermark.png';

*
• {@link image_watermark_x} absolute watermark position, in pixels from the left border. can be negative (default: null)
  *

  $handle->image_watermark_x = 5;

*
• {@link image_watermark_y} absolute watermark position, in pixels from the top border. can be negative (default: null)
  *

  $handle->image_watermark_y = 5;

*
• {@link image_watermark_position} watermark position withing the image, a combination of one or two from 'TBLR': top, bottom, left, right (default: null)
  *

  $handle->image_watermark_position = 'LR';

*
• {@link image_watermark_no_zoom_in} prevents the watermark to be resized up if it is smaller than the image (default: true)
  *

  $handle->image_watermark_no_zoom_in = false;

*
• {@link image_watermark_no_zoom_out} prevents the watermark to be resized down if it is bigger than the image (default: false)
  *

  $handle->image_watermark_no_zoom_out = true;

*

*
• {@link image_reflection_height} if set, a reflection will be added. Format is either in pixels or percentage, such as 40, '40', '40px' or '40%' (default: null)
  *

  $handle->image_reflection_height = '25%';

*
• {@link image_reflection_space} space in pixels between the source image and the reflection, can be negative (default: null)
  *

  $handle->image_reflection_space = 3;

*
• {@link image_reflection_color} reflection background color, in hexadecimal. Now deprecated in favor of {@link image_default_color} (default: #FFFFFF)
  *

  $handle->image_default_color = '#000000';

*
• {@link image_reflection_opacity} opacity level at which the reflection starts, integer between 0 and 100 (default: 60)
  *

  $handle->image_reflection_opacity = 60;

*

*
• {@link file_src_name} Source file name
*
• {@link file_src_name_body} Source file name body
*
• {@link file_src_name_ext} Source file extension
*
• {@link file_src_pathname} Source file complete path and name
*
• {@link file_src_mime} Source file mime type
*
• {@link file_src_size} Source file size in bytes
*
• {@link file_src_error} Upload error code
*
• {@link file_is_image} Boolean flag, true if the file is a supported image type
*

*
• {@link image_src_x} Source file width in pixels
*
• {@link image_src_y} Source file height in pixels
*
• {@link image_src_pixels} Source file number of pixels
*
• {@link image_src_type} Source file type (png, jpg, gif or bmp)
*
• {@link image_src_bits} Source file color depth
*

*
• {@link file_dst_path} Destination file path
*
• {@link file_dst_name_body} Destination file name body
*
• {@link file_dst_name_ext} Destination file extension
*
• {@link file_dst_name} Destination file name
*
• {@link file_dst_pathname} Destination file complete path and name
*

*
• {@link image_dst_x} Destination file width
*
• {@link image_dst_y} Destination file height
*
• {@link image_convert} Destination file format
*

*
• v 0.31 11/04/2011
  * - added application/x-rar MIME type
  * - make sure exec() and ini_get_all()function are not disabled if we want to use them
  * - make sure that we don't divide by zero when calculating JPEG size
  * - {@link allowed} and {@link forbidden} can now accept strings
  * - try to guess the file extension from the MIME type if there is no file extension
  * - better class properties when changing the file extension
  * - added {@link file_force_extension} to allow extension-less files if needed
  * - better file safe conversion of the filename
  * - allow shorthand byte values, such as 1K, 2M, 3G for {@link file_max_size} and {@link jpeg_size}
  * - added {@link image_opacity} to change picture opacity
  * - added {@link image_border_opacity} to allow semi-transparent borders
  * - added {@link image_frame_opacity} to allow semi-transparent frames
  * - added {@link image_border_transparent} to allow borders fading to transparent
  * - duplicated {@link image_overlay_percent} into {@link image_overlay_opacity}
  * - duplicated {@link image_text_percent} into {@link image_text_opacity}
  * - duplicated {@link image_text_background_percent} into {@link image_text_background_opacity}
*
• v 0.30 05/09/2010
  * - implemented an unsharp mask, with alpha transparency support, activated if {@link image_unsharp} is true. added {@link image_unsharp_amount}, {@link image_unsharp_radius}, and {@link image_unsharp_threshold}
  * - added text/rtf MIME type, and no_script exception
  * - corrected bug when {@link no_script} is activated and several process() are called
  * - better error handling for finfo
  * - display upload_max_filesize information from php.ini in the log
  * - automatic extension for extension-less images
  * - fixed {@link image_ratio_fill} top and left filling
  * - fixed alphablending issue when applying a transparent PNG watermark on a transparent PNG
  * - added {@link image_watermark_no_zoom_in} and {@link image_watermark_no_zoom_out} to allow the watermark to be resized down (or up) to fit in the image. By default, the watermark may be resized down, but not up.
*
• v 0.29 03/02/2010
  * - added protection against malicious images
  * - added zip and torrent MIME type
  * - replaced split() with explode()
  * - initialise image_dst_x/y with image_src_x/y
  * - removed {@link mime_fileinfo}, {@link mime_file}, {@link mime_magic} and {@link mime_getimagesize} from the docs since they are used before {@link process}
  * - added more extensions and MIME types
  * - improved MIME type validation
  * - improved logging
*
• v 0.28 10/08/2009
  * - replaced ereg functions to be compatible with PHP 5.3
  * - added flv MIME type
  * - improved MIME type detection
  * - added {@link file_name_body_pre} to prepend a string to the file name
  * - added {@link mime_fileinfo}, {@link mime_file}, {@link mime_magic} and {@link mime_getimagesize} so that it is possible to deactivate some MIME type checking method
  * - use exec() rather than shell_exec(), to play better with safe mode
  * - added some error messages
  * - fix bug when checking on conditions, {@link processed} wasn't propagated properly
*
• v 0.27 14/05/2009
  * - look for the language files directory from __FILE__
  * - deactivate {@link file_auto_rename} if {@link file_overwrite} is set
  * - improved transparency replacement for true color images
  * - fixed calls to newer version of UNIX file utility
  * - fixed error when using PECL Fileinfo extension in SAFE MODE, and when using the finfo class
  * - added {@link image_precrop} to crop the image before an eventual resizing
*
• v 0.26 13/11/2008
  * - rewrote conversion from palette to true color to handle transparency better
  * - fixed imagecopymergealpha() when the overlayed image is of wrong dimensions
  * - fixed imagecreatenew() when the image to create have less than 1 pixels width or height
  * - rewrote MIME type detection to be more secure and not rely on browser information; now using Fileinfo PECL extension, UNIX file() command, MIME magic, and getimagesize(), in that order
  * - added support for Flash uploaders
  * - some bug fixing and error handling
*
• v 0.25 17/11/2007
  * - added translation files and mechanism to instantiate the class with a language different from English
  * - added {@link forbidden} to set an array of forbidden MIME types
  * - implemented support for simple wildcards in {@link allowed} and {@link forbidden}, such as image/*
  * - preset the file extension to the desired conversion format when converting an image
  * - added read and write support for BMP images
  * - added a flag {@link file_is_image} to determine if the file is a supported image type
  * - the class now provides some information about the image, before calling {@link process}(). Available are {@link image_src_x}, {@link image_src_y} and the newly introduced {@link image_src_bits}, {@link image_src_pixels} and {@link image_src_type}. Note that this will not work if open_basedir restrictions are in place
  * - improved logging; now provides useful system information
  * - added some more pre-processing checks for files that are images: {@link image_max_width}, {@link image_max_height}, {@link image_max_pixels}, {@link image_max_ratio}, {@link image_min_width}, {@link image_min_height}, {@link image_min_pixels} and {@link image_min_ratio}
  * - added {@link image_ratio_pixels} to resize an image to a number of pixels, keeping aspect ratio
  * - added {@link image_is_palette} and {@link image_is_transparent} and {@link image_transparent_color} for GIF images
  * - added {@link image_default_color} to define a fallback color for non alpha-transparent output formats, such as JPEG or BMP
  * - changed {@link image_background_color}, which now forces transparent areas to be painted
  * - improved reflections and color overlays so that it works with alpha transparent images
  * - {@link image_reflection_color} is now deprecated in favour of {@link image_default_color}
  * - transparent PNGs are now processed in true color, and fully preserving the alpha channel when doing merges
  * - transparent GIFs are now automatically detected. {@link preserve_transparency} is deprecated
  * - transparent true color images can be saved as GIF while retaining transparency, semi transparent areas being merged with {@link image_default_color}
  * - transparent true color images can be saved as JPG/BMP with the semi transparent areas being merged with {@link image_default_color}
  * - fixed conversion of images to true color
  * - the class can now output the uploaded files content as the return value of process() if the function is called with an empty or null argumenti, or no argument
*
• v 0.24 25/05/2007
  * - added {@link image_background_color}, to set the default background color of an image
  * - added possibility of using replacement tokens in text labels
  * - changed default JPEG quality to 85
  * - fixed a small bug when using greyscale filter and associated filters
  * - added {@link image_ratio_fill} in order to fit an image within some dimensions and color the remaining space. Very similar to {@link image_ratio_crop}
  * - improved the recursive creation of directories
  * - the class now converts palette based images to true colors before doing graphic manipulations
*
• v 0.23 23/12/2006
  * - fixed a bug when processing more than once the same uploaded file. If there is an open_basedir restriction, the class now creates a temporary file for the first call to process(). This file will be used for subsequent processes, and will be deleted upon calling clean()
*
• v 0.22 16/12/2006
  * - added automatic creation of a temporary file if the upload directory is not within open_basedir
  * - fixed a bug which was preventing to work on a local file by overwriting it with its processed copy
  * - added MIME types video/x-ms-wmv and image/x-png and fixed PNG support for IE weird MIME types
  * - modified {@link image_ratio_crop} so it can accept one or more from string 'TBLR', determining which side of the image is kept while cropping
  * - added support for multiple lines in the text, using "\n" as a line break
  * - added {@link image_text_line_spacing} which allow to set the space between several lines of text
  * - added {@link image_text_alignment} which allow to set the alignment when text has several lines
  * - {@link image_text_font} can now be set to the path of a GDF font to load external fonts
  * - added {@link image_reflection_height} to create a reflection of the source image, which height is in pixels or percentage
  * - added {@link image_reflection_space} to set the space in pixels between the source image and the reflection
  * - added {@link image_reflection_color} to set the reflection background color
  * - added {@link image_reflection_opacity} to set the initial level of opacity of the reflection
*
• v 0.21 30/09/2006
  * - added {@link image_ratio_crop} which resizes within {@link image_x} and {@link image_y}, keeping ratio, but filling the space by cropping excedent of image
  * - added {@link mime_check}, which default is true, to set checks against {@link allowed} MIME list
  * - if MIME is empty, the class now triggers an error
  * - color #000000 is OK for {@link image_text_color}, and related text transparency bug fixed
  * - {@link gd_version}() now uses gd_info(), or else phpinfo()
  * - fixed path issue when the destination path has no trailing slash on Windows systems
  * - removed inline functions to be fully PHP5 compatible
*
• v 0.20 11/08/2006
  * - added some more error checking and messages (GD presence, permissions...)
  * - fix when uploading files without extension
  * - changed values for {@link image_brightness} and {@link image_contrast} to be between -127 and 127
  * - added {@link dir_auto_create} to automatically and recursively create destination directory if missing.
  * - added {@link dir_auto_chmod} to automatically chmod the destination directory if not writeable.
  * - added {@link dir_chmod} to set the default chmod to use.
  * - added {@link image_crop} to crop images
  * - added {@link image_negative} to invert the colors on the image
  * - added {@link image_greyscale} to turn the image into greyscale
  * - added {@link image_threshold} to apply a threshold filter on the image
  * - added {@link image_bevel}, {@link image_bevel_color1} and {@link image_bevel_color2} to add a bevel border
  * - added {@link image_border} and {@link image_border_color} to add a single color border
  * - added {@link image_frame} and {@link image_frame_colors} to add a multicolored frame
*
• v 0.19 29/03/2006
  * - class is now compatible i18n (thanks Sylwester).
  * - the class can mow manipulate local files, not only uploaded files (instanciate the class with a local filename).
  * - {@link file_safe_name} has been improved a bit.
  * - added {@link image_brightness}, {@link image_contrast}, {@link image_tint_color}, {@link image_overlay_color} and {@link image_overlay_percent} to do color manipulation on the images.
  * - added {@link image_text} and all derivated settings to add a text label on the image.
  * - added {@link image_watermark} and all derivated settings to add a watermark image on the image.
  * - added {@link image_flip} and {@link image_rotate} for more image manipulations
  * - added {@link jpeg_size} to calculate the JPG compression quality in order to fit within one filesize.
*
• v 0.18 02/02/2006
  * - added {@link no_script} to turn dangerous scripts into text files.
  * - added {@link mime_magic_check} to set the class to use mime_magic.
  * - added {@link preserve_transparency} *experimental*. Thanks Gregor.
  * - fixed size and mime checking, wasn't working :/ Thanks Willem.
  * - fixed memory leak when resizing images.
  * - when resizing, it is not necessary anymore to set {@link image_convert}.
  * - il is now possible to simply convert an image, with no resizing.
  * - sets the default {@link file_max_size} to upload_max_filesize from php.ini. Thanks Edward
*
• v 0.17 28/05/2005
  * - the class can be used with any version of GD.
  * - added security check on the file with a list of mime-types.
  * - changed the license to GPL v2 only
*
• v 0.16 19/05/2005
  * - added {@link file_auto_rename} automatic file renaming if the same filename already exists.
  * - added {@link file_safe_name} safe formatting of the filename (spaces to _underscores so far).
  * - added some more error reporting to avoid crash if GD is not present
*
• v 0.15 16/04/2005
  * - added JPEG compression quality setting. Thanks Vad
*
• v 0.14 14/03/2005
  * - reworked the class file to allow parsing with phpDocumentor
*
• v 0.13 07/03/2005
  * - fixed a bug with {@link image_ratio}. Thanks Justin.
  * - added {@link image_ratio_no_zoom_in} and {@link image_ratio_no_zoom_out}
*
• v 0.12 21/01/2005
  * - added {@link image_ratio} to resize within max values, keeping image ratio
*
• v 0.11 22/08/2003
  * - update for GD2 (changed imageresized() into imagecopyresampled() and imagecreate() into imagecreatetruecolor())
*

     * gd_version    src_name       src_name_body src_name_ext
     * src_pathname  src_mime       src_x         src_y
     * src_type      src_bits       src_pixels
     * src_size      src_size_kb    src_size_mb   src_size_human
     * dst_path      dst_name_body  dst_pathname
     * dst_name      dst_name_ext   dst_x         dst_y
     * date          time           host          server        ip
     * 

     *                        TL  T  TR
     *                        L       R
     *                        BL  B  BR
     * 

     * $foo->image_crop = 20                  OR array(20);
     * $foo->image_crop = '20px'              OR array('20px');
     * $foo->image_crop = '20 40'             OR array('20', 40);
     * $foo->image_crop = '-20 25%'           OR array(-20, '25%');
     * $foo->image_crop = '20px 25%'          OR array('20px', '25%');
     * $foo->image_crop = '20% 25%'           OR array('20%', '25%');
     * $foo->image_crop = '20% 25% 10% 30%'   OR array('20%', '25%', '10%', '30%');
     * $foo->image_crop = '20px 25px 2px 2px' OR array('20px', '25%px', '2px', '2px');
     * $foo->image_crop = '20 25% 40px 10%'   OR array(20, '25%', '40px', '10%');
     * 

     * $foo->image_frame_colors = '#FFFFFF #999999 #666666 #000000';
     * $foo->image_frame_colors = array('#FFFFFF', '#999999', '#666666', '#000000');
     *