이미지 Image Manipulation Class¶

클래스 초기화 Initializing the Class¶

다른 클래스들과 같이, 이미지 클래스또한 $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>');

워터마크 Image Watermarking¶

워터마크를 사용하려면 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 Reference¶

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)

Preferences 테이블에 나열된 모든 설정은 이 목적을 위해 사용됩니다. 단 3가지 제외 : : rotation_angle, x_axis and y_axis.

썸네일 생성 Creating a Thumbnail

아래의 값을 TRUE 로 설정하면, 리사이징 함수는 썸네일 파일을 만들 것입니다. (그리고 원본을 보존합니다). :

$config['create_thumb'] = TRUE;

이 하나의 설정값이 썸네일을 생성할지 말지를 결정합니다.

복사본 생성 Creating a Copy

아래의 변수를 이용하여 path 와 파일명을 설정하면, 리사이징 함수는 이미지 파일의 복사본을 생성할 것입니다. (그리고 원본은 보존합니다):

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

이 설정의 주의사항 Notes regarding this preference:

• 만약 새로운 파일의 이름만 지정이 되면, 원본과 같은 디렉토리에 저장됩니다.
• 만약에 경로가 지정이 되면, 새로운 이미지는 원본과 같은 파일명으로 새로운 경로에 저장될 것입니다.
• 만약에 경로와 파일명이 둘 다 지정이 되면, 주어진 경로와 파일명에 저장됩니다.

원본 이미지의 리사이징 Resizing the Original Image

위에 나열된 2개의 값(create_thumb, new_image)을 설정하지 않으면, 리사이징 함수는 원본 이미지를 대상으로 진행합니다.

crop()¶

반환값:	TRUE on success, FALSE on failure
반환형:	bool

크롭 함수는 크롭할 위치의 X축과 Y축의 값을 픽셀로 설정하는 것만 제외하면 리사이징 함수와 거의 비슷합니다. 다음과 같습니다:

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

Preferences 테이블에 나열된 모든 설정값은 이것을 위해 존재합니다. 단 다음은 제외: rotation_angle, 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();
}

Note

Without a visual interface it is difficult to crop images, so this method is not very useful unless you intend to build such an interface. That’s exactly what we did using for the photo gallery module in ExpressionEngine, the CMS we develop. We added a JavaScript UI that lets the cropping area be selected.

rotate()¶

반환값:	TRUE on success, FALSE on failure
반환형:	bool

이미지 회전 함수는 회전 각도가 다음 설정을 통해 세팅되어야 합니다:

$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

이미지 위에 워터마크를 생성합니다. 더 많은 정보를 위해서는 이미지 워터마크 (Watermarking an Image) 페이지를 참조하세요.

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
반환형:	문자열

모든 발견된 에러를 문자형으로 반환.

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