图像处理类¶

初始化类¶

跟 CodeIgniter 中的其他类一样，可以在你的控制器中使用 $this->load->library() 方法加载图像处理类:

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

一旦加载，图像处理类就可以像下面这样使用:

$this->image_lib

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

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

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

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

添加图像水印¶

水印处理功能需要 GD/GD2 库的支持。

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

类参考¶

class CI_Image_lib¶

initialize([$props = array()])¶

参数:	$props (array) -- Image processing preferences
返回:	TRUE on success, FALSE in case of invalid settings
返回类型:	bool

初始化图像处理类。

resize()¶

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

该函数让你能调整原始图像的大小，创建一个副本（调整或未调整过的）， 或者创建一个缩略图。

创建一个副本和创建一个缩略图之间没有实际上的区别， 除了缩略图的文件名会有一个自定义的后缀（如：mypic_thumb.jpg）。

所有列在上面 参数 表中的参数对这个函数都可用， 除了这三个： rotation_angle 、 x_axis 和 y_axis 。

创建一个缩略图

resize 函数能用来创建缩略图（并保留原图），只要你把这个参数设为 TRUE

$config['create_thumb'] = TRUE;

这一个参数决定是否创建一个缩略图。

创建一个副本

resize 函数能创建一个图像的副本（并保留原图）， 只要你通过以下参数设置一个新的路径或者文件名:

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

注意以下规则：

• 如果只指定新图像的名字，那么它会被放在原图像所在的文件夹下。
• 如果只指定路径，新图像会被放在指定的文件夹下，并且名字和原图像相同。
• 如果同时定义了路径和新图像的名字，那么新图像会以指定的名字放在指定的文件夹下。

调整原图像的大小

如果上述两个参数（create_thumb 和 new_image）均未被指定， resize 函数的处理将直接作用于原图像。

crop()¶

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

crop 函数的用法与 resize 函数十分接近，除了它需要你设置用于裁剪的 X 和 Y 值 （单位是像素），如下:

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

前面那张 参数 表中所列的所有参数都可以用于这个函数， 除了这些：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();
}

注解

如果没有一个可视化的界面，是很难裁剪一张图片的。 因此，除非你打算制作这么一个界面，否则这个函数并不是很有用。 事实上我们在自己开发的 CMS 系统 ExpressionEngine 的相册模块中 添加的一个基于 JavaScript 的用户界面来选择裁剪的区域。

rotate()¶

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

rotate 函数需要通过参数设置旋转的角度:

$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 函数重置所有之前用于处理图片的值。当你用循环来处理一批图片时，你可能会想使用它。

$this->image_lib->clear();

display_errors([$open = '<p>[, $close = '</p>']])¶

参数:	$open (string) -- Error message opening tag $close (string) -- Error message closing tag
返回:	Error messages
返回类型:	string

返回所有检测到的错误信息。

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