이미지 Image Manipulation Class

CodeIgniter의 이미지 처리 클래스 는 다음 기능을 제공합니다:

이미지 크기 변경 Image Resizing
썸네일 생성 Thumbnail Creation
이미지 자르기 Image Cropping
이미지 회전 Image Rotating
이미지 워터마크(이미지위에 글자따위를 새기는것)Image Watermarking

3개의 주요 이미지 라이브러리는 다음 라이브러리가 필요합니다: GD/GD2, NetPBM, 그리고 ImageMagick

주의: 워터마크는 GD/GD2 라이브러리가 사용가능해야 합니다. 그리고,다른 라이브러리들이 있더라도, 이미지 속성정보를 계산하기 위해 GD 는 기본으로 필요합니다. 그러나 이미지 처리는 여러분이 정의한 라이브러리를 가지고 수행할 수 있습니다.

클래스 초기화 Initializing the Class

다른 클래스들과 같이 ,이미지 클래스또한 $this->load->library 함수로 초기화 합니다:

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

일단 초기화하면 바로 사용하실 수 있습니다. 이미지 라이브러리 객체는 다음과같이 사용합니다: $this->image_lib

이미지 처리 Processing an Image

이미지를 어떻게 처리하고자 하든지 (예를들어 크기조절,자르기,돌리기,워터마크),일반적인 사용법은 동일합니다. 어떤 처리를 할것인지에 따라서 약간의 속성을 설정한후 , 사용가능한 처리 함수를 호출하면 됩니다. 예를 들어, 썸네일을 만들고자한다면 아래와 같이 합니다:

$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 함수는 source_image 폴더에 있는 mypic.jpg 이미지를 찾은후 GD2 이미지 라이브러리 를 사용하여 75 X 50 사이즈의 썸네일을 생성합니다.maintain_ratio 옵션이 켜져 있으므로 ,썸네일은 원본의 가로세로 비율을 유지하면서 지정한 너비 와 높이 에 최대한 가깝게 생성될것입니다.썸네일은 mypic_thumb.jpg 라는 이름으로 생성됩니다.

주의: 이미지 처리가 정상적으로 진행되기 위해서는 이미지가 들어있는 폴더에 쓰기권한이 있어야 합니다.

처리 함수들 Processing Functions

처리함수는 4개가 있습니다:

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

함수들은 처리성공시 TRUE 를 실패시 FALSE 를 리턴합니다. 만약 실패하면 아래 함수를 이용하여 에러메세지를 출력할 수 있습니다:

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

아래와 같이 조건문안에서 이미지를 처리하고 에러가 있을때만 에러메세지를 출력하도록 하면 좋습니다:

if ( ! $this->image_lib->resize())

{

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

}

참고: 아래와같이 에러메세지의 시작부분과 끝부분에 원하는 html 코드를 추가하시면 보다 보기좋게 꾸밀수 있습니다:

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

속성 Preferences

아래 설명되어있는 속성들을통해서 이미지를원하는대로 재단 할수 있습니다.

아래 속성들을 모든 이미지 처리함수에서 사용할수는 없습니다. 예를들어, x/y 축(axis) 속성은 이미지 자르기에서만 사용가능 합니다. 그리고, 너비(width) 와 높이(height) 속성은 자르기에서 아무런 소용이 없습니다. "지원함수(availability)" 칼럼에서 어떤 함수에 사용가능한지 표시해 줍니다..

지원함수 범례 (Availability Legend):

R - 이미지 크기 조절 Image Resizing
C - 자르기 Image Cropping
X - 회전 Image Rotation
W - 워터마크 Image Watermarking

속성	기본값	옵션	설명	사용가능성
image_library	GD2	GD, GD2, ImageMagick, NetPBM	이미지 라이브러리를 사용가능하도록 세팅합니다.	R, C, X, W
library_path	None	None	ImageMagick 이나 NetPBM 라이브러리의 서버경로(path)를 설정합니다. 둘중 어떤 라이브러리를 사용하더라도 , 경로를 설정해야합니다.	R, C, X
source_image	None	None	소스이미지의 경로/이름을 설정합니다. 경로는 URL이 아니라 절대경로나 혹은 상대경로로 설정합니다.	R, C, S, W
dynamic_output	FALSE	TRUE/FALSE (boolean)	이미지 파일이 동적으로 생성될지, 디스크에 저장될지를 결정합니다. 참고: 동적생성으로 설정할경우 한번에 하나의 이미지만 보여집니다 그리고, 페이지내에서 위치를 설정할 수 없습니다.단지 이미지 헤더와 함께 동적으로 브라우저에 출력됩니다.	R, C, X, W
quality	90%	1 - 100%	이미지의 품질을 설정합니다. 고품질일수록 파일의 크기는 커집니다.	R, C, X, W
new_image	None	None	이미지의 출력경로(destination)를 설정합니다. 이미지의 복사복을 생성할때 이 속성을 이용할수 있습니다. 경로는 URL이 아니라 절대경로나 혹은 상대경로로 설정합니다.	R, C, X, W
width	None	None	원하는 이미지의 너비를 설정합니다.	R, C
height	None	None	원하는 이미지의 높이를 설정합니다.	R, C
create_thumb	FALSE	TRUE/FALSE (boolean)	이미지 처리함수에 썸네일을 생성할것이라고 지정합니다.	R
thumb_marker	_thumb	None	썸네일지시자를 명시합니다.지시자는 파일 확장자 바로 앞에삽입됩니다. 예를들어 mypic.jpg 는 mypic_thumb.jpg 이 될것입니다	R
maintain_ratio	TRUE	TRUE/FALSE (boolean)	원본이미지의 가로세로비율을 유지할지 혹은 입력된 수치대로 이미지 크기조절을 수행할지를 결정합니다.	R, C
master_dim	auto	auto, width, height	크기조절이나, 썸네일 생성시 어느축을 주축으로 할지를 정의합니다. 예를들어, 어떤 이미지를 100 X 75 로 리사이징 한다고할때, 이미지 원본의 비율이 이와달라서 완벽하게 처리될수 없다면 이 설정은 너비나 높이중 어느쪽을 중심으로 처리할것인지를 지정합니다. "auto" 는 이미지가 넓은 형태인지 높은 형태인지를 가지고 자동으로 주축을 결정합니다.	R
rotation_angle	None	90, 180, 270, vrt, hor	이미지를 회전할때 몇도로 회전할지를 결정합니다. PHP 는 시계반대방향으로 회전시키므로 ,90도를 회전시키고자한다면 270 을 지정하셔야 합니다.	X
x_axis	None	None	이미지를 자를때 X 좌표를 픽셀단위로 설정합니다. 예를들어 , 30을 설정하면 왼쪽으로부터 30픽셀만큼 잘라냅니다.	C
y_axis	None	None	이미지를 자를때 Y 좌표를 픽셀단위로 설정합니다. 예를들어 , 30을 설정하면 위쪽으로부터 30픽셀만큼 잘라냅니다.	C

속성을 설정파일에 저장하기 Setting preferences in a config file

속성을 위와같이 설정하는대신에 설정파일에 저장하고싶다면 image_lib.php라는 이름으로 새파일을 만드신후 $config 배열을 그안에 추가하시기 바랍니다. 그런다음 파일을 config/image_lib.php 로 저장하시면 자동으로 설정이 로드됩니다.설정파일에 저장하시면 $this->image_lib->initialize 함수를 호출할필요가 없습니다.

$this->image_lib->resize()

크기변경(resizing)함수를 이용하시면 크기변경,복사본생성(크기변경과 동시에 혹은 크기변경없이) 그리고 썸네일 생성 작업이 가능합니다..

실재 썸네일마커를 썸네일파일이름에 추가하는것(예, mypic_thumb.jpg)을 제외한다면, 복사본생성과 썸네일 생성은 아무런 차이가 없습니다 .

위에서 열거한 속성중 다음 세가지를 제외한 모든속성이 적용가능합니다: rotation_angle, x_axis, and y_axis.

썸네일 생성 Creating a Thumbnail

속성을 TRUE 로 설정하시면 크기변경함수는 썸네일파일을 생성하고 원본은 보존합니다:

$config['create_thumb'] = TRUE;

위 하나의 속성은 썸네일을 생성할지 말지를 결정합니다.

복사본 생성 Creating a Copy

아래의 속성에 복사본이 저장될 경로와 파일명을 지정해주시면 크기변환함수는 원본을 보존한채 복사본을 생성합니다:

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

이 속성에대한 참고사항:

파일이름만 지정하시면 복사본은 원본과같은 폴더에 저장됩니다
경로만 지정하시면 , 지정한 경로에 원본과 같은 이름으로 복사본을 생성합니다.
경로와 파일명을 모두 지정하시면 지정한위치에 지정한 이름으로 복사본이 생성됩니다.

원본이미지의 크기변환 Resizing the Original Image

위 두 속성중 아무것도 지정하지않으면 크기변환함수는 원본이미지를 변환합니다.

$this->image_lib->crop()

어느만큼 잘라낼지에대한 X,Y 값을 요구한다는점을 제외하면 자르기(cropping)함수는 크기변환 함수와 동일합니다.예제:

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

}

참고 : 비주얼한 UI가 없다면 이미지를 잘라내는것은 어렵습니다. 그러므로 비주얼한 UI를 제작하지 않는다면, 이함수는 그다지 유용하지 않습니다.우리는 우리가 개발한 CMS 프로그램인 ExpressionEngine에 사용된 포토갤러리에서 비주얼한 UI를 만들었습니다.자바스크립트를 이용해서 잘라낼 영역을 선택할수 있는 UI 를 말이죠 .

$this->image_lib->rotate()

이미지 회전 함수는 속성을 통해서 회전할 각도를 입력받습니다:

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

회전옵션은 5 가지가 있습니다:

90 - 반시계방향 90도.
180 - 반시계방향 180 도.
270 - r반시계방향 270 도.
hor - 이미지를 가로로 대칭(flips)되도록 변환 .
vrt - 이미지를 세로로 대칭(flips)되도록 변환 .

아래는 이미지 회전에 대한 예제입니다:

$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 함수는 이미지처리에 쓰였던 모든값을 제거(clear)합니다. 이미지처리를 루프에서 한다면 이함수를 사용하게 될것입니다.

$this->image_lib->clear();

워터마크 Image Watermarking

워터마크를 사용하려면 GD/GD2 라이브러리가 필요합니다.

두개 타입의 워터마크 Two Types of Watermarking

사용가능한 워터마크는 아래와같이 2개의 타입이 있습니다:

텍스트 Text: 텍스트를 사용하여 워터마크를 생성합니다. 트루타입폰트를 지정하여 사용할 수도 있고 ,GD 라이브러리에서 지원하는 네이티브 텍스트를 사용할 수도 있습니다. 트루타입을 사용하시려면 GD 는 트루타입지원(True Type support)으로 컴파일 되어 설치되어야합니다 (대부분은 그러하나, 그렇지않은경우도 있습니다).
오버레이 Overlay: 이미지 오버레이를 사용하여 워터마크를 생성합니다. 일반적으로 투명 PNG 나 GIF 를 사용합니다.

이미지에 워터마크 하기 Watermarking an Image

다른 함수들과 마찬가지로 (크기변환, 자르기, 회전) 워터마크도 필요한 속성을 설정하고 워터마크 함수를 호출하면 됩니다. 아래예제를 참고하세요:


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

참고: 이미지 클래스를 사용하기위해서는 이미지파일에 쓰기권한이 설정되어있어야 합니다. 예를들어 777 등으로 설정해주세요.

워터마크 속성 Watermarking Preferences

아래 테이블은 텍스트나 오버레이 워터마크에 사용할수 있는 속성을 보여줍니다.

속성	기본값	옵션	설명
wm_type	text	text, overlay	워터마크 타입을 설정합니다.
source_image	None	None	소스이미지의 경로와 파일이름을 설정합니다.경로는 URL 이 아니라 절대경로나 상대경로로 설정해야합니다.
dynamic_output	FALSE	TRUE/FALSE (boolean)	이미지 파일이 동적으로 생성될지, 디스크에 저장될지를 결정합니다. 참고: 동적생성으로 설정할경우 한번에 하나의 이미지만 보여집니다 그리고, 페이지내에서 위치를 설정할 수 없습니다.단지 이미지 헤더와 함께 동적으로 브라우저에 출력됩니다.
quality	90%	1 - 100%	이미지의 품질을 설정합니다. 고품질일수록 파일의 크기는 커집니다.
padding	None	A number	워터마크가 이미지의 경계로부터 기본적으로 얼마나 떨어질지에 대한 패딩(padding) 을 픽셀로 설정합니다. (html 테이블에서 padding 설정하는것과 같은개념).
wm_vrt_alignment	bottom	top, middle, bottom	워터마크이미지의 세로 정렬을 설정합니다
wm_hor_alignment	center	left, center, right	워터마크이미지의 가로 정렬을 설정합니다
wm_hor_offset	None	None	워터마크 이미지의 가로 위치를 픽셀로 설정합니다. 통상 오프셋을 설정하면 워터마크는 설정값 만큼 오른쪽으로 이동하게 됩니다. 그러나 alignment를 right 로 설장하면 왼쪽으로 이동합니다.
wm_vrt_offset	None	None	워터마크 이미지의 세로 위치를 픽셀로 설정합니다. 통상 오프셋을 설정하면 워터마크는 설정값 만큼 아래로 이동하게 됩니다. 그러나 alignment를 bottom으로 설장하면 위쪽으로 이동합니다.

텍스트 속성 Text Preferences

아래테이블은 워터마크가 텍스트 타입일때 사용할수 있는 속성입니다.

속성	기본값	옵션	설명
wm_text	None	None	워터마크로 사용할 텍스트를 설정합니다. 일반적으로는 저작권(copyright)관련 텍스트를 쓰겠지요.
wm_font_path	None	None	사용할 트루타입폰트의 서버경로를 설정합니다.이 옵션을 설정하지 않으시면 GD에 내장된 폰트가 사용됩니다.
wm_font_size	16	None	폰트크기입니다. 참고: 위의 트루타입 옵션을 사용하지 않으면, 숫자는1 - 5 까지 설정할수 있습니다. 그렇지않다면, 사용하는 폰트에 대해 가능한 크기를 모두 사용할수 있습니다(픽셀단위로 설정).
wm_font_color	ffffff	None	폰트색상을 16진수로 설정합니다. 참고, 3글자의 축소버전(예 fff) 컬러설정대신 반드시 6 글자의 16진수값을 모두 사용해야합니다(예, 993300).
wm_shadow_color	None	None	그림자의 색상을 16진수로 설정합니다. 이설정을 사용하지않으면 그림자는 생성되지 않습니다. 참고, 3글자의 축소버전(예 fff) 컬러설정대신 반드시 6 글자의 16진수값을 모두 사용해야합니다(예, 993300).
wm_shadow_distance	3	None	그림자가 얼마나 떨어져서 표시될지를 픽셀단위로 지정합니다.

오버레이 속성 Overlay Preferences

아래테이블은 워터마크가 오버레이 타입일때 사용할수 있는 속성입니다.

속성	기본값	옵션	설명
wm_overlay_path	None	None	워터마크로 사용할 이미지의 서버경로를 설정합니다. 오버레이타입의 워터마크 생성시에만 필요합니다.
wm_opacity	50	1 - 100	이미지 투명도를 설정합니다. 이 설정을 통해서 원본이미지위체 반투명으로 워터마크를 생성할수 있습니다. 일반적으로 50% 로 설정합니다.
wm_x_transp	4	A number	워터마크 이미지로 PNG 혹은GIF를 사용한다면, 어떤 색깔을 투명으로할지 설정해야할 것입니다. 이 속성을 통해 설정할 수 있습니다.이 속성과 아래 속성을 함께 사용하여 좌표를 지정하면 왼쪽 위를 0으로 하여 지정한 픽셀만큼의 위치에 있는색깔과 같은 색깔을 투명으로 설정합니다.
wm_y_transp	4	A number	위 설정과 함께 , 투명하게 할색상의 위치를 표현하는데 쓰입니다.

CodeIgniter User Guide Version 1.7.2