CodeIgniter 圖像處理類

圖像處理類

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

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

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

注解

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

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

初始化類

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

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

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

$this->image_lib

處理圖像

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

$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 的圖片，然后運(yùn)用 GD2 圖像庫創(chuàng)建一個(gè) 75 X 50 像素的縮略圖。 當(dāng) maintain_ratio 選項(xiàng)設(shè)為 TRUE 時(shí)，生成的縮略圖將保持圖像的縱橫比例，同時(shí)盡可能的在寬度和 高度上接近所設(shè)定的 width 和 height 。 縮略圖將被命名為類似 mypic_thumb.jpg 的形式。

注解

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

注解

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

處理函數(shù)

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

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

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

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

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

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

注解

你也可以給錯(cuò)誤信息指定 HTML 格式，像下面這樣添加起始和結(jié)束標(biāo)簽:

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

參數(shù)

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

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

"可用性" 符號(hào)說明：

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

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

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

添加圖像水印

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

水印的兩種類型

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

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

給圖像添加水印

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

$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 像素的中下部位置。

注解

當(dāng)調(diào)用圖像類處理圖像時(shí)，所有的目標(biāo)圖片必須有 "寫入" 權(quán)限， 例如：777

水印處理參數(shù)

下表列舉的參數(shù)對(duì)于兩種水印處理方式（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)建一個(gè)副本（調(diào)整或未調(diào)整過的）， 或者創(chuàng)建一個(gè)縮略圖。

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

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

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

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

$config['create_thumb'] = TRUE;

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

創(chuàng)建一個(gè)副本

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

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

注意以下規(guī)則：

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

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

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

crop()

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

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

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

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

這是一個(gè)如何裁剪一張圖片的示例:

$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();
}

注解

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

rotate()

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

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

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

以下是 5 個(gè)可選項(xiàng)：

1. 90 - 逆時(shí)針旋轉(zhuǎn)90度。
2. 180 - 逆時(shí)針旋轉(zhuǎn)180度。
3. 270 - 逆時(shí)針旋轉(zhuǎn)270度。
4. hor - 水平翻轉(zhuǎn)。
5. vrt - 垂直翻轉(zhuǎn)。

下面是旋轉(zhuǎn)圖片的一個(gè)例子:

$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

在圖像上添加一個(gè)水印，更多信息請(qǐng)參考 給圖像添加水印 。

clear()

返回類型: void

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

$this->image_lib->clear();

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

參數(shù):

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

返回: Error messages

返回類型: string

返回所有檢測(cè)到的錯(cuò)誤信息。

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