Added parameter "far" from phpThumb as forceAspectRatio on MeioUpload

README.markdown

@@ -55,4 +55,91 @@ Make sure your directory (app/webroot/uploads/image/ in this case, image changes
 The behavior code will save the uploaded file's name in the 'filename' field in database, it will not overwrite existing files, instead it will create a new filename based on the original plus a counter. For thumbnails, when the file is uploaded, it will automatically create 3 thumbnail sizes (this can be configured) and prepend the name to the thumbfiles as directories(i.e. app/webroot/uploads/image/image_001.jpg will produced app/webroot/uploads/thumb/small/image/image_001.jpg, app/webroot/uploads/thumb/medium/image/image_001.jpg, app/webroot/uploads/thumb/large/image/image_001.jpg)
 
 ### Deleting an uploaded file while keeping the record
-Flag the file for deletion by setting `data[Model][filename][remove]` to something non-empty, e.g. `TRUE`. The uploaded file including possible thumbnails will then be deleted together with adherent database fields upon save. Note that the record will be preserved, only the file meta-data columns will be reset.
+Flag the file for deletion by setting `data[Model][filename][remove]` to something non-empty, e.g. `TRUE`. The uploaded file including possible thumbnails will then be deleted together with adherent database fields upon save. Note that the record will be preserved, only the file meta-data columns will be reset.
+
+## Creating thumbnails
+
+### Installation
+
+Download the latest copy of phpThumb and extract it into your vendors directory. Should end up like: /vendors/phpThumb/{files}. (http://phpthumb.sourceforge.net)
+
+### Basic usage
+
+In a model that needs uploading with thumbnails generation, replace the class declaration with something similar to the following:
+
+	<?php
+	class Image extends AppModel {
+		var $name = 'Image';
+		var $actsAs = array(
+			'MeioUpload.MeioUpload' => array(
+				'filename' => array(
+					'thumbsizes' => array(
+						'320x90' => array(
+							'width' => 320,
+							'height' => 90
+						)
+					)    	            
+				)
+			)
+		);
+	}
+	?>
+
+in that case we generate one thumb with size of 320x90px. Recalling that on controller and on views the procedure still the same of the default usage.
+
+By default the thumbnails are generated on a dir with the name of the key of our array thumbsizes. In our case the structure created is uploads/image/filename/thumb/320x90.
+
+### Passing params for thumbnails generations
+
+When we are creating thumbnails we are capable of pass params for our thumbnails, in our case we used two params width and height. Lets see these and others.
+
+#### width
+
+How you could imagine it's define the width of our thumbnail, its is defined on pixels.
+
+If not defined the default value are 150.
+
+#### height
+
+Again how you could imagine it's define the height of our thumbnail, its is defined on pixels.
+
+If not defined the default value are 225.
+
+#### forceAspectRatio
+
+Create a  thumbnail with the values specified by "width" and "height" and resizes the original proportionally, it's not cropped, to fit the sizes, if the image is not proporcional the excess will be filled with whitespace. The generated thumbnail image always have the value specified on "width" and "height" and if the image not be proporcional the excess will be filled with whitespace.
+
+We need pass the params of the alignment of our original image is be positioned, the rest of image will be filled with whitespace if the image is not proporcional. The possible values are:
+
+- L = left
+- R = right
+- T = top
+- B = bottom
+- C = center
+- BL = bottom left
+- BR = bottom right
+- TL = top left
+- TR = top right
+
+See on example:
+
+	<?php
+	class Image extends AppModel {
+		var $name = 'Image';
+		var $actsAs = array(
+			'MeioUpload.MeioUpload' => array(
+				'filename' => array(
+					'thumbsizes' => array(
+						'320x90' => array(
+							'width' => 320,
+							'height' => 90,
+							'forceAspectRatio' => 'C',
+						)
+					)    	            
+				)
+			)
+		);
+	}
+	?>
+
+On this example create a thumb image for 320x90px and resizes the original proportionally to fit the sizes, if the image is not proporcional the excedent will be filled with whitespace. And how we used the param "C" the image is aligned on the center of the thumb.

models/behaviors/meio_upload.php

@@ -41,6 +41,7 @@ class MeioUploadBehavior extends ModelBehavior {
 		'allowedExt' => array('.jpg', '.jpeg', '.png', '.gif', '.bmp', '.ico'),
 		'default' => false, // Not sure what this does
 		'zoomCrop' => false, // Whether to use ZoomCrop or not with PHPThumb
+	    'forceAspectRatio' => false,
 		'thumbnails' => true,
 		'thumbsizes' => array(
 			// Place any custom thumbsize in model config instead,
@@ -854,6 +855,9 @@ function _createThumbnails(&$model, $data, $fieldName, $saveAs, $ext, $options)
 			if (isset($value['zoomCrop'])) {
 				$params['zoomCrop'] = $value['zoomCrop'];
 			}
+		    if (isset($value['forceAspectRatio'])) {
+				$params['forceAspectRatio'] = $value['forceAspectRatio'];
+			}
 			if (isset($value['watermark'])) {
 				$params['watermark'] = $value['watermark'];
 			}
@@ -879,7 +883,8 @@ function _createThumbnail(&$model, $source, $target, $fieldName, $params = array
 				'thumbHeight' => 225,
 				'maxDimension' => '',
 				'thumbnailQuality' => $this->__fields[$model->alias][$fieldName]['thumbnailQuality'],
-				'zoomCrop' => false
+				'zoomCrop' => false,
+			    'forceAspectRatio' => false
 			),
 			$params);
 
@@ -903,6 +908,9 @@ function _createThumbnail(&$model, $source, $target, $fieldName, $params = array
 		if (isset($params['zoomCrop'])){
 			$phpThumb->setParameter('zc', $params['zoomCrop']);
 		}
+	    if (isset($params['forceAspectRatio'])){
+			$phpThumb->setParameter('far', $params['forceAspectRatio']);
+		}
 		if (isset($params['watermark'])){
 			$phpThumb->fltr = array("wmi|". IMAGES . $params['watermark']."|BR|50|5");
 		}