圖像處理類

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

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

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

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

初始化類

像 CodeIgniter 的大多數(shù)類一樣，圖像處理類在你的控制器里使用 $this->load->library 方法來初始化：

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

在圖像處理庫被載入后就已經(jīng)做好被使用的準備了。你將用來調用所有圖像處理方法的圖像處理庫對象是：$this->image_lib

處理一個圖像

不管你想進行何種圖像處理操作（調整大小，圖像裁剪，圖像旋轉，添加水?。?，通常過程都是一樣的。你先設置一些你想進行的圖像操作的參數(shù)，然后調用四個可用方法中的一個。例如，創(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 選項設為可用時，生成的縮略圖將在保持縱橫比例的同時，盡可能的在寬度和高度上接近所設定的width和height?？s略圖將被命名為類似 mypic_thumb.jpg的形式

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

Note: Image processing can require a considerable amount of server memory for some operations. If you are experiencing out of memory errors while processing images you may need to limit their maximum size, and/or adjust PHP memory limits.

處理函數(shù)

有五個處理函數(shù)可以調用:

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

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

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

像下面這樣當調用失敗時顯示錯誤，是一個好的例子來有條件的使用處理函數(shù):

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 - 調整圖像大小
• C - 圖像裁剪
• X - 圖像旋轉
• W - 添加圖像水紋

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

如果你不喜歡用以上的方式設置參數(shù)，你還能通過配置文件來設置它們。只要創(chuàng)建一個名為image_lib.php的文件, 在該文件中加入一個 $config 數(shù)組。 然后將這個文件保存到: config/image_lib.php ，它將會被自動調用。 如果你將參數(shù)保存在配置文件里，你就不需要再使用 $this->image_lib->initialize 函數(shù)。

$this->image_lib->resize()

這個圖像大小調整函數(shù)讓你能調整原始圖像的大小，創(chuàng)建一個備份（調整過的和未調整過的），或者創(chuàng)建一個縮略圖。

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

所有列在上面表中的參數(shù)對這個函數(shù)可用，除了這三個：rotation_angle, x_axis, and 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ī)則:

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

調整原圖像的大小

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

$this->image_lib->crop()

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

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

前面那張表中所列的所有參數(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ù)并不是很有用。事實上我們(譯注：指Ellislab公司，CodeIgniter的發(fā)行者)在自己開發(fā)的CMS系統(tǒng)ExpressionEngine的相冊模塊中添加的一個基于JavaScript的用戶界面來選擇裁剪的區(qū)域。

$this->image_lib->rotate()

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

$this->image_lib->clear()

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

$this->image_lib->clear();

?

圖像水印處理

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

水印處理的兩種類型

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

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

水印處理一個圖像

類似使用其他類型圖像函數(shù)(resizing, cropping, and 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像素的中底部位置，

注意: 當調用圖像類處理圖像時，任何目標圖片文件必須有 "寫入"的權限， 例如：777.

水印處理參數(shù)

這個表里列舉了兩種水印處理 (text or overlay) 的可設置的參數(shù)

Text參數(shù)

這個表格顯示了Text類型水印的可用參數(shù)。

Overlay 參數(shù)

這個表格顯示了Overlay類型水印的可用參數(shù)。

?

上一個主題:??HTML 表格類??·??頁首 ?·??用戶指南首頁??·??下一個主題:??輸入類

CodeIgniter ?·? 版權所有 ? 2006-2012 ?·? Ellislab, Inc.

中文化: CodeIgniter 中國 ?·? 制作: Hex ?·? 版本: 1.30 ?·? 鳴謝: 子非魚