<?php 
/**
 * PHP Imagick的使用类
 * 
 * @example
 * <pre>
 *     $im = new Util_Image_Imagick('test.jpg', false, 'jpg');
 *     1. 生成缩略图. 处理后,图片保持完整
 *     $im->thumbnail(100, 100)->compress()->save('test1.jpg');
 *     2. 图片贴在白色背景上. 处理后,图片保持完整 (对应原来切图模式: 2)
 *     $im->paste(100, 100)->compress()->save('test2.jpg');
 *     3. 剪切图片. 处理后,图片不完整 (对应原来切图模式: 3)
 *     $im->crop(100, 100)->compress()->save('test3.jpg');
 *     4. 缩放尺寸. 处理后,图片保持完整  (对应原来切图模式: 4)
 *     $im->resize(100, 100)->compress()->save('test4.jpg');
 *     5. 缩略并从中间剪切. 处理后,图片不完整 (对应原来切图模式: 5)
 *     $im->autoCrop(100, 100)->compress()->save('test5.jpg');
 *     6. 自定义的切图. 处理后,图片的完整性不固定 (根据yoho.cn业务需求)
 *     $im->customCrop(100, 100)->compress()->save('test6.jpg');
 * </pre>
 * 
 * @name Util_Image_Imagick
 * @package util/image
 * @copyright yoho.inc
 * @version 1.2 (2013-08-08 17:25:54)
 * @author fei.hong <hf@yoho.cn>
 * @since 1.0 (2012-11-20 16:33:29)
 * @see http://docs.php.net/manual/zh/book.imagick.php
 */
class Util_Image_Imagick implements Util_Image_Interface
{
    /**
     * @var object (Imagick)
     */
    private $_handle;
    
    /**
     * @var integer (宽度)
     */
    private $_width;
    
    /**
     * @var integer (高度)
     */
    private $_height;
    
    /**
     * @var object (FastDFSClient)
     */
    private $_fastdfsHandle;
    
    /**
     * @var boolean (fastdfs状态)
     */
    private $_fastdfsStatus = false;
    
    /**
     * @var boolean (静态化图片的开关)
     * @since 1.2
     */
    private $_flatten = false;
    
    /**
     * @var string (格式)
     * @since 1.2
     */
    private $_format;
    
    /**
     * 构造函数
     * 
     * @param string $filename (源图片路径)
     * @param boolean $fastdfsStatus (是否启用fastDFS)
     */
    public function __construct($filename, $fastdfsStatus = false)
    {
    	if (false !== $fastdfsStatus) 
    	{
    	    $this->_fastdfsStatus = $fastdfsStatus;
    	    $this->_fastdfsHandle = new MyFastDFSClient();
    		$this->_handle = new Imagick();
    		$this->_handle->readImageBlob($this->_fastdfsHandle->download_file_to_buff($filename));
    	} 
    	else 
    	{
    		$this->_handle = new Imagick($filename);
    	}

        $this->_width = $this->_handle->getImageWidth();
        $this->_height = $this->_handle->getImageHeight();
        $this->_format = strtolower($this->_handle->getImageFormat());
    }
    
    /**
     * 析构函数
     */
    public function __destruct()
    {
    	if (null !== $this->_handle) 
    	{
    		$this->_handle->clear();
    		$this->_handle->destroy();
    		$this->_handle = null;
    	}
    	
    	if (false !== $this->_fastdfsStatus) 
    	{
    	    $this->_fastdfsHandle->close();
    	    $this->_fastdfsHandle = null;
    	}
    }
    
    /**
     * 缩略图
     * 
     * 更改图像大小为指定的尺寸, 并清除图片的所有相关属性信息. (体积小)
     * 
     * @param integer $w (缩略宽度, 当数值<=0或>=9999时表示按高度等比例缩放)
     * @param integer $h (缩略高度, 当数值<=0或>=9999时表示按宽度等比例缩放)
     * @param boolean $fit (控制是否按照宽高的最大值等比例缩放)
     * @return object
     */
    public function thumbnail($w, $h, $fit = true)
    {
    	$this->compareSize($w, $h, __FUNCTION__);
    	
    	if (false === $this->_flatten && $this->_format === 'gif') 
    	{
    		// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    		$images = $this->_handle->coalesceImages();
    		foreach ($images as $frame) 
    		{
    			$frame->thumbnailImage($w, $h, $fit);
    		}
    		// 删除重复像素内容. 注意这是自ImageMagick 6.2.9及以上支持的方法
    		$this->_handle = $images->optimizeImageLayers();
    	} 
    	else 
    	{
    		$this->_handle->thumbnailImage($w, $h, $fit);
    	}
        
    	return $this;
    }
    
    /**
     * 缩放图片尺寸
     * 
     * 缩放图像到所需的尺寸(宽高), 可以带上滤镜效果.
     * 
     * 滤镜使用 @see http://www.php.net/manual/zh/gmagick.constants.php
     * 
     * @param integer $w (缩放宽度)
     * @param integer $h (缩放高度)
     * @param boolean $fit (控制是否按照宽高的最大值等比例缩放)
     * @return object
     */
    public function resize($w, $h, $fit = true)
    {
    	$this->compareSize($w, $h, __FUNCTION__);
    	
    	if (false === $this->_flatten && $this->_format === 'gif') 
    	{
    		// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    		$images = $this->_handle->coalesceImages();
    		foreach ($images as $frame) 
    		{
    			$frame->resizeImage($w, $h, Imagick::FILTER_CATROM, 1, $fit);
    		}
    		// 删除重复像素内容.注意这是自ImageMagick 6.2.9及以上支持的方法
    		$this->_handle = $images->optimizeImageLayers();
    	} 
    	else 
    	{
        	$this->_handle->resizeImage($w, $h, Imagick::FILTER_CATROM, 1, $fit);
    	}
        
        return $this;
    }
    
    /**
     * 背景贴图
     *
     * 生成一下指定背景的画布图, 再将图片复合贴在画布背景图的指定位置上.
     *
     * @param integer $w (需求宽度)
     * @param integer $h (需求高度)
     * @param string  $bg (背景图片)
     * @return object
     */
    public function paste($w, $h, $bg = '#FFFFFF')
    {
    	$this->compareSize($w, $h, __FUNCTION__);
    
    	// 静态化图片
    	if (false === $this->_flatten && $this->_format === 'gif') 
    	{
    		$this->flatten();
    	}
    	
    	// 如里需求图片的尺寸小于原图片的尺寸, 则生成缩略图
    	if ($w <= $this->_width && $h <= $this->_height) 
    	{
    		$this->_handle->resizeImage($w, $h, Imagick::FILTER_CATROM, 1, true);
    		 
    		return $this;
    	}
    
    	if ($w < $this->_width || $h < $this->_height) 
    	{
    		// 缩放图片
    		$this->_handle->scaleImage($w, $h, true);
    
    		// 缩放宽高
    		$sw = $this->_handle->getImageWidth();
    		$sh = $this->_handle->getImageHeight();
    
    		// 计算位置
    		$x = ($w - $sw) / 2;
    		$y = ($h - $sh) / 2;
    	} 
    	else 
    	{
    		$x = ($w - $this->_width) / 2;
    		$y = ($h - $this->_height) / 2;
    	}
    
    	// 新建背景图层
    	$canvas = new Imagick();
    	$canvas->newImage($w, $h, $bg, $this->_format);
    
    	// 将图片贴在背景图层上
    	$this->_handle->compositeImage($canvas, Imagick::COMPOSITE_OVERLAY , $x, $y);
    
    	return $this;
    }

    /**
     * 剪切图片
     *
     * 提取图像的一个指定区域. 默认是从原图片的左上角坐标(0,0)到($w,$h)的这个区域.
     *
     * @param integer $w (剪切宽度)
     * @param integer $h (剪切高度)
     * @param integer $x (坐标X轴位置)
     * @param integer $y (坐标Y轴位置)
     * @return object
     */
    public function crop($w, $h, $x = 0, $y = 0)
    {
    	$this->compareSize($w, $h, __FUNCTION__);
    	
    	if (false === $this->_flatten && $this->_format === 'gif')
    	{
    		// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    		$images = $this->_handle->coalesceImages();
    		foreach ($images as $frame) {
    			$frame->cropImage($w, $h, $x, $y);
    			$frame->setImagePage($w, $h, 0, 0);
    		}
    		$this->_handle = $images->deconstructImages();
    	} 
    	else 
    	{
    		$this->_handle->cropImage($w, $h, $x, $y);
    		$this->_handle->setImagePage($w, $h, 0, 0);
    	}
    	 
    	return $this;
    }
    
    /**
     * 自动切图
     *
     * 先缩放图像, 再从中心指定的区域剪切图片, 创建一个固定宽度和高度的缩略图.
     *
     * @param integer $w (宽度)
     * @param integer $h (高度)
     * @return object
     */
    public function autoCrop($w, $h)
    {
    	$this->compareSize($w, $h, __FUNCTION__);
    	 
    	if (false === $this->_flatten && $this->_format === 'gif') 
    	{
    		// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    		$images = $this->_handle->coalesceImages();
    		foreach ($images as $frame) 
    		{
    			$frame->cropThumbnailImage($w, $h);
    		}
    		// 删除重复像素内容.注意这是自ImageMagick 6.2.9及以上支持的方法
    		$this->_handle = $images->optimizeImageLayers();
    	} 
    	else 
    	{
    		$this->_handle->cropThumbnailImage($w, $h);
    	}
    	 
    	return $this;
    }
    
    /**
     * [yoho.cn]自定义切图
     *
     * @param integer $w (剪切宽度, 当数值<=0或>=9999表示最大宽度)
     * @param integer $h (剪切高度, 当数值<=0或>=9999表示最大高度)
     * @return object
     * @since 1.1
     */
    public function customCrop($w, $h)
    {
    	if ($w >= $this->_width && $h >= $this->_height)
    	{
    		return $this->paste($w, $h);
    	}
    		
    	$this->compareSize($w, $h, __FUNCTION__);
    	
    	// 获取自定义的缩放比例
    	list($sw, $sh) = $this->getScale($w, $h);
    		
        // 水平居中剪切
        if ($sw > $w && $this->_width >= $this->_height) 
    	{
    		if (false === $this->_flatten && $this->_format === 'gif')
    		{
    			// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    			$images = $this->_handle->coalesceImages();
    			foreach ($images as $frame)
    			{
    				$frame->resizeImage($sw, $sh, Imagick::FILTER_CATROM, 1, false);
    				$frame->cropImage($w, $h, ($sw - $w) / 2, 0);
    				$frame->setImagePage($w, $h, 0, 0);
    			}
    			$this->_handle = $images->deconstructImages();
    		}
    		else
    		{
	    		$this->_handle->resizeImage($sw, $sh, Imagick::FILTER_CATROM, 1, false);
	    		$this->_handle->cropImage($w, $h, ($sw - $w) / 2, 0);
	    		$this->_handle->setImagePage($w, $h, 0, 0);
    		}
    	}
    	// 垂直上下剪切
    	elseif ($sh > $h)
    	{
    		if (false === $this->_flatten && $this->_format === 'gif')
    		{
    			// 按顺序相同尺寸的帧对象, 并对每一帧进行处理
    			$images = $this->_handle->coalesceImages();
    			foreach ($images as $frame)
    			{
    				$frame->resizeImage($sw, $sh, Imagick::FILTER_CATROM, 1, false);
    				$frame->cropImage($w, $h, 0, 0);
    				$frame->setImagePage($w, $h, 0, 0);
    			}
    			$this->_handle = $images->deconstructImages();
    		}
    		else
    		{
    			$this->_handle->resizeImage($sw, $sh, Imagick::FILTER_CATROM, 1, false);
    			$this->_handle->cropImage($w, $h, 0, 0);
    			$this->_handle->setImagePage($w, $h, 0, 0);
    		}
    	}
    	// 白色背景贴图
    	else
    	{
    		$this->paste($w, $h);
    	}

    	return $this;
    }
    
    /**
     * [yoho.cn] 自定义的活动瀑布流的切图
     *
     * @param integer $w (剪切宽度)
     * @param integer $h (剪切高度)
     * @return object
     * @since 1.3
     * @see http://wiki.yoho.cn/#789-zh
     */
    public function waterfallCrop($w, $h)
    {
    	$this->_handle->thumbnailImage($w, 0, false);
    	
    	$thumbHeight = $this->_handle->getImageHeight();
    	if ($thumbHeight > $h)
    	{
    		$this->_handle->cropImage($w, $h, 0, 0);
    		$this->_handle->setImagePage($w, $h, 0, 0);
    	}
    
    	return $this;
    }
    
    /**
     * 拼合图片
     * 
     * 作用是将多个图层的图片转变成单一静态化的图片
     *
     * @return object
     * @since 1.1
     */
    public function flatten()
    {
    	// 如果: 图片有上一张或下一张图层(存在多张图片如gif动画)
    	if ($this->_handle->hasNextImage() || $this->_handle->hasPreviousImage())
    	{
    		$this->_flatten = true;
    		
    		$this->_handle = $this->_handle->flattenImages();
    	}
    	return $this;
    }
    
    /**
     * 压缩图片处理
     * 
     * @param integer $quality (图片的质量)
     * @return object
     */
    public function compress($quality = 90) 
    {
        // 转换色彩CMYK为RGB
        $cs = $this->_handle->getImageColorspace();
		if ($cs == Imagick::COLORSPACE_CMYK) 
		{ 
			$this->_handle->setImageColorspace(Imagick::COLORSPACE_SRGB); 
		}

		// 除去图像的exif档案信息
		$this->_handle->stripImage();

		// Imagick设置生成图片质量的方法，Imagick默认生成的图片质量有点差。
		// 这里设置质量为90, 注意设置质量为90以上的(包括90)可能会导致生成后的图片所占的空间比原图还要大，
		// 还要注意在write()的时候再设置这个压缩质量，不要在把图片经过各种处理之前设置这个值，
		// 这样write的时候质量就不生效了，生成的图片可以用picasa等软件来查看质量。
		// 注意: 这是Graphicsmagick1.3.7以上才支持的方法
		$this->_handle->setCompressionQuality($quality); 
		
		return $this;
    }
    
    /**
     * 保存图片
     * 
     * @param mixed $filename (指定的文件 | null 源文件)
     * @return void
     */
    public function save($filename = null) 
    {
    	if ($this->_fastdfsStatus)
    	{
    		$this->_fastdfsHandle->delete($filename);
    		$this->_fastdfsHandle->uploadByStream($filename, $this->_handle->getImagesBlob());
    	}
    	else
    	{
    		$this->_handle->writeImages($filename, true);
    	}
    }
    
    /**
     * 显示图片
     * 
     * @return string
     * @since 1.1
     */
    public function show()
    {
    	header('Content-Type: ' . $this->getMimeType($this->_format));
    	
    	echo $this->_handle->getImagesBlob();
    }
    
    /**
     * 获取图片的格式
     */
    public function getFormat()
    {
    	return isset($this->_format) ? $this->_format : strtolower($this->_handle->getImageFormat());
    }
    
    /**
     * 获取缩放的比例 (根据实际业务需求)
     *
     * @param integer $w (缩放宽度--数值<=0或>=9999:最大宽度)
     * @param integer $h (缩放高度--数值<=0或>=9999:最大高度)
     * @return array (缩放宽度, 缩放高度)
     * @since 1.1
     */
    private function getScale($w, $h)
    {
    	// 默认缩放的比例
    	$sw = $w; $sh = $h;
    
    	// 原图与缩略图的宽高比例
    	$widthRate = $this->_width / $w;
    	$heightRate = $this->_height / $h;
    	// 计算缩放的宽高值
    	if ($widthRate > 1 || $heightRate > 1)
    	{
    		if ($widthRate > $heightRate)
    		{
    			$sw = $this->_width / $heightRate;
    		}
    		else
    		{
    			$sh = $this->_height / $widthRate;
    		}
    	}
    
    	return array($sw, $sh);
    }
    
    /**
     * 获取图片的MIME类型
     * 
     * @param string $format (图片格式)
     * @return string
     */
    private function getMimeType($format)
    {
    	$mineType = 'image/jpeg';
    	
        switch ($format)
        {
            case 'jpeg':
            case 'jpg':
                $mineType = 'image/jpeg';
                break;
            case 'gif':
                $mineType = 'image/gif';
                break;
            case 'png':
                $mineType = 'image/png';
                break;
            case 'bmp':
                $mineType = 'image/bmp';
                break;
            case 'xbm':
                $mineType = 'image/xbm';
                break;
            case 'wbmp':
                $mineType = 'image/vnd.wap.wbmp';
                break;
        }
        
        return $mineType;
    }
    
    /**
     * 比较原图宽高与需求宽高 (根据实际业务需求)
     *
     * 比较过程中可能会改变需求的宽和高($w和$h)
     *
     * @param integer $w (需求的宽度)
     * @param integer $h (需求的高度)
     * @param string $func (方法名称)
     * @return void
     * @since 1.2
     */
    private function compareSize(&$w, &$h, $func)
    {
    	switch ($func)
    	{
    		case 'thumbnail':
    		case 'resize':
    		case 'crop':
    		case 'autoCrop':
    			($w > $this->_width) ? $w = $this->_width : true;
    			($h > $this->_height) ? $h = $this->_height : true;
    			break;
    		case 'customCrop':
    		case 'paste':
    			($w >= 9999 || $w <= 0) ? $w = $this->_width : true;
    			($h >= 9999 || $h <= 0) ? $h = $this->_height : true;
    			break;
    	}
    }
    
}