CodeIgniter 圖像處理類

圖像處理類

CodeIgniter 的圖像處理類可以使你完成以下的操作：

• 調(diào)整圖像大小
• 創(chuàng)建縮略圖
• 圖像裁剪
• 圖像旋轉
• 添加圖像水印

可以很好的支持三個主流的圖像庫：GD/GD2、NetPBM 和 ImageMagick 。

注解

添加水印操作僅僅在使用 GD/GD2 時可用。另外，即使支持其他的圖像處理庫， 但是為了計算圖像的屬性，GD 仍是必需的。然而在進行圖像處理操作時， 還是會使用你指定的庫。

• 初始化類
  • 處理圖像
  • 處理函數(shù)
  • 參數(shù)
  • 在配置文件中設置參數(shù)
• 添加圖像水印
  • 水印的兩種類型
  • 給圖像添加水印
  • 水印處理參數(shù)
    • Text 參數(shù)
    • Overlay 參數(shù)
• 類參考

初始化類

跟 CodeIgniter 中的其他類一樣，可以在你的控制器中使用 $this->load->library() 方法加載圖像處理類:

$this->load->library('image_lib');

一旦加載，圖像處理類就可以像下面這樣使用:

$this->image_lib

處理圖像

不管你想進行何種圖像處理操作（調(diào)整大小，圖像裁剪，圖像旋轉，添加水?。?通常過程都是一樣的。你會先設置一些你想進行的圖像操作的參數(shù)， 然后調(diào)用四個可用方法中的一個。例如，創(chuàng)建一個圖像縮略圖:

$config['image_library'] = 'gd2';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['create_thumb'] = TRUE;
$config['maintain_ratio'] = TRUE;
$config['width']     = 75;
$config['height']   = 50;

$this->load->library('image_lib', $config);

$this->image_lib->resize();

以上代碼告訴 image_resize 函數(shù)去查找位于 source_image 目錄下的名為 mypic.jpg 的圖片，然后運用 GD2 圖像庫創(chuàng)建一個 75 X 50 像素的縮略圖。 當 maintain_ratio 選項設為 TRUE 時，生成的縮略圖將保持圖像的縱橫比例，同時盡可能的在寬度和 高度上接近所設定的 width 和 height 。 縮略圖將被命名為類似 mypic_thumb.jpg 的形式。

注解

為了讓圖像類能進行所有操作，包含圖片的文件夾必須開啟可寫權限。

注解

圖像處理的某些操作可能需要大量的服務器內(nèi)存。如果在處理圖像時， 你遇到了內(nèi)存不足錯誤，您可能需要限制圖像大小的最大值， 和/或調(diào)整 PHP 的內(nèi)存限制。

處理函數(shù)

有五個處理函數(shù)可以調(diào)用：

• $this->image_lib->resize()
• $this->image_lib->crop()
• $this->image_lib->rotate()
• $this->image_lib->watermark()

當調(diào)用成功時，這些函數(shù)會返回 TRUE ，否則會返回 FALSE 。 如果調(diào)用失敗時，用以下函數(shù)可以獲取錯誤信息:

echo $this->image_lib->display_errors();

下面是一個好的做法，將函數(shù)調(diào)用放在條件判斷里，當調(diào)用失敗時顯示錯誤的信息:

if ( ! $this->image_lib->resize())
{
    echo $this->image_lib->display_errors();
}

注解

你也可以給錯誤信息指定 HTML 格式，像下面這樣添加起始和結束標簽:

$this->image_lib->display_errors('<p>', '</p>');

參數(shù)

你可以用下面的參數(shù)來對圖像處理進行配置，滿足你的要求。

注意，不是所有的參數(shù)都可以應用到每一個函數(shù)中。例如，x/y 軸參數(shù)只能被圖像裁剪使用。 但是，寬度和高度參數(shù)對裁剪函數(shù)是無效的。下表的 "可用性" 一欄將指明哪些函數(shù)可以使用對應的參數(shù)。

"可用性" 符號說明：

• R - 調(diào)整圖像大小
• C - 圖像裁剪
• X - 圖像旋轉
• W - 添加圖像水印

在配置文件中設置參數(shù)

如果你不喜歡使用上面的方法來設置參數(shù)，你可以將參數(shù)保存到配置文件中。你只需簡單的創(chuàng)建一個文件 image_lib.php 并將 $config 數(shù)組放到該文件中，然后保存文件到 config/image_lib.php ，這些參數(shù)將會自動被使用。 如果你在配置文件中設置參數(shù)，那么你就不需要使用$this->image_lib->initialize() 方法了。

添加圖像水印

水印處理功能需要 GD/GD2 庫的支持。

水印的兩種類型

你可以使用以下兩種圖像水印處理方式：

• Text：水印信息將以文字方式生成，要么使用你所指定的 TrueType 字體， 要么使用 GD 庫所支持的內(nèi)部字體。如果你要使用 TrueType 版本， 那么你安裝的 GD 庫必須是以支持 TrueType 的形式編譯的（大多數(shù)都是，但不是所有）。
• Overlay：水印信息將以圖像方式生成，新生成的水印圖像 （通常是透明的 PNG 或者 GIF）將覆蓋在原圖像上。

給圖像添加水印

類似使用其他類型的圖像處理函數(shù)（resizing、cropping 和 rotating）， 你也要對水印處理函數(shù)進行參數(shù)設置來生成你要的結果，例子如下:

$config['source_image'] = '/path/to/image/mypic.jpg';
$config['wm_text'] = 'Copyright 2006 - John Doe';
$config['wm_type'] = 'text';
$config['wm_font_path'] = './system/fonts/texb.ttf';
$config['wm_font_size'] = '16';
$config['wm_font_color'] = 'ffffff';
$config['wm_vrt_alignment'] = 'bottom';
$config['wm_hor_alignment'] = 'center';
$config['wm_padding'] = '20';

$this->image_lib->initialize($config);

$this->image_lib->watermark();

上面的例子是使用 16 像素 True Type 字體來生成文本水印 "Copyright 2006 - John Doe" ， 該水印將出現(xiàn)在離圖像底部 20 像素的中下部位置。

注解

當調(diào)用圖像類處理圖像時，所有的目標圖片必須有 "寫入" 權限， 例如：777

水印處理參數(shù)

下表列舉的參數(shù)對于兩種水印處理方式（text 或 overlay）都適用。

Text 參數(shù)

下表列舉的參數(shù)只適用于 text 水印處理方式。

Overlay 參數(shù)

下表列舉的參數(shù)只適用于 overlay 水印處理方式。

類參考

classCI_Image_lib

initialize([$props = array()])

參數(shù):

• $props (array) -- Image processing preferences

返回: TRUE on success, FALSE in case of invalid settings

返回類型: bool

初始化圖像處理類。

resize()

返回: TRUE on success, FALSE on failure
返回類型: bool

該函數(shù)讓你能調(diào)整原始圖像的大小，創(chuàng)建一個副本（調(diào)整或未調(diào)整過的）， 或者創(chuàng)建一個縮略圖。

創(chuàng)建一個副本和創(chuàng)建一個縮略圖之間沒有實際上的區(qū)別， 除了縮略圖的文件名會有一個自定義的后綴（如：mypic_thumb.jpg）。

所有列在上面 參數(shù) 表中的參數(shù)對這個函數(shù)都可用， 除了這三個： rotation_angle 、 x_axis 和 y_axis 。

創(chuàng)建一個縮略圖

resize 函數(shù)能用來創(chuàng)建縮略圖（并保留原圖），只要你把這個參數(shù)設為 TRUE

$config['create_thumb'] = TRUE;

這一個參數(shù)決定是否創(chuàng)建一個縮略圖。

創(chuàng)建一個副本

resize 函數(shù)能創(chuàng)建一個圖像的副本（并保留原圖）， 只要你通過以下參數(shù)設置一個新的路徑或者文件名:

$config['new_image'] = '/path/to/new_image.jpg';

注意以下規(guī)則：

• 如果只指定新圖像的名字，那么它會被放在原圖像所在的文件夾下。
• 如果只指定路徑，新圖像會被放在指定的文件夾下，并且名字和原圖像相同。
• 如果同時定義了路徑和新圖像的名字，那么新圖像會以指定的名字放在指定的文件夾下。

調(diào)整原圖像的大小

如果上述兩個參數(shù)（create_thumb 和 new_image）均未被指定， resize 函數(shù)的處理將直接作用于原圖像。

crop()

返回: TRUE on success, FALSE on failure
返回類型: bool

crop 函數(shù)的用法與 resize 函數(shù)十分接近，除了它需要你設置用于裁剪的 X 和 Y 值 （單位是像素），如下:

$config['x_axis'] = 100;
$config['y_axis'] = 40;

前面那張 參數(shù) 表中所列的所有參數(shù)都可以用于這個函數(shù)， 除了這些：rotation_angle 、width 、height 、create_thumb 、new_image 。

這是一個如何裁剪一張圖片的示例:

$config['image_library'] = 'imagemagick';
$config['library_path'] = '/usr/X11R6/bin/';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['x_axis'] = 100;
$config['y_axis'] = 60;

$this->image_lib->initialize($config);

if ( ! $this->image_lib->crop())
{
    echo $this->image_lib->display_errors();
}

注解

如果沒有一個可視化的界面，是很難裁剪一張圖片的。 因此，除非你打算制作這么一個界面，否則這個函數(shù)并不是很有用。 事實上我們在自己開發(fā)的 CMS 系統(tǒng) ExpressionEngine 的相冊模塊中 添加的一個基于 JavaScript 的用戶界面來選擇裁剪的區(qū)域。

rotate()

返回: TRUE on success, FALSE on failure
返回類型: bool

rotate 函數(shù)需要通過參數(shù)設置旋轉的角度:

$config['rotation_angle'] = '90';

以下是 5 個可選項：

1. 90 - 逆時針旋轉90度。
2. 180 - 逆時針旋轉180度。
3. 270 - 逆時針旋轉270度。
4. hor - 水平翻轉。
5. vrt - 垂直翻轉。

下面是旋轉圖片的一個例子:

$config['image_library'] = 'netpbm';
$config['library_path'] = '/usr/bin/';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['rotation_angle'] = 'hor';

$this->image_lib->initialize($config);

if ( ! $this->image_lib->rotate())
{
    echo $this->image_lib->display_errors();
}

watermark()

返回: TRUE on success, FALSE on failure
返回類型: bool

在圖像上添加一個水印，更多信息請參考 給圖像添加水印 。

clear()

返回類型: void

clear 函數(shù)重置所有之前用于處理圖片的值。當你用循環(huán)來處理一批圖片時，你可能會想使用它。

$this->image_lib->clear();

display_errors([$open = '[, $close = '']])

參數(shù):

• $open (string) -- Error message opening tag
• $close (string) -- Error message closing tag

返回: Error messages

返回類型: string

返回所有檢測到的錯誤信息。

echo $this->image_lib->diplay_errors();