Class
- Tip&Tech
| [함수] 섬네일 클래스 | |||||
| 글쓴이 |   카이 |
날 짜 | 11-06-22 00:53 | 조 회 | 3190 |
|---|---|---|---|---|---|
| 간편URL |
http://www.phpschool.com/link/tipntech/73861
|
||||
| 다운로드1 | Thumbnail-class.zip (195.8K), Down : 121, 2011-06-22 00:53:16 | ||||
| Link1 | http://phpschool.com/gnuboard4/bbs/board.php?bo_table=tipntech&wr_id=4… (246) | ||||
괴부기님의 코드를 원본으로 상당부분 수정 및 추가하였습니다.
가급적 PHP 5.3 이상 버전에서 가능할걸로 예상하고, 이하 버전에서는 테스트는 못해봤습니다. 주요기능 - 섬네일 width, height 지정 가능 (둘 중 하나만 지정할 경우 해당 이미지 비율에 맞춰 섬네일 크기 설정) - 축소 방법 설정 (섬네일 안에 이미지 모두 보이게, 섬네일 크기에 꽉차게 설정 가능) - 출력 섬네일 파일형식 설정 가능 (GIF, JPG, PNG) - 섬네일 처리 전/후 콜백 함수 등록 가능 (콜백함수로 테두리 및 워터마크 등 사용자가 쉽게 추가 가능) - 섬네일 저장 경로를 쉽게 설정 가능 (키워드 사용으로 섬네일 경로에 이미지 크기나 경로를 쉽게 사용) 사용예 sample.php
<?php
require_once 'Thumbnail.class.php';
$watermark = new ThumbnailWatermark;
$sourcefiles = Array(
'sample_1.jpg',
'sample_2.jpg'
);
Thumbnail::setOption('debug', true);
for ($L1 = 0; $L1 < count($sourcefiles); $L1++)
{
// case 1
// 크기를 120x120 으로 설정하고 크기 안에 이미지가 모두 보이도록 설정
// 워터마크는 사용안함
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_SHOW_ALL,
Array(
'savepath' => '%PATH%%FILENAME%_thumb-case-1.%EXT%'
));
// case 2
// 크기를 120x120 으로 설정하고 크기 안에 이미지가 모두 보이도록 설정
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_SHOW_ALL,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-2.%EXT%'
));
// case 3
// 크기를 120x120 으로 설정하고 이미지가 크기에 꽉 차도록 설정
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_EXACT_FIT,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-3.%EXT%'
));
// case 4
// 넓이만 120 픽셀로 고정하고, 기본 옵션을 PNG 파일로 출력하도록 설정
Thumbnail::setOption('export', EXPORT_PNG);
Thumbnail::create($sourcefiles[$L1],
120, null,
null,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-4.%EXT%'
));
Thumbnail::setOption('export', EXPORT_JPG);
}
Thumbnail.class.php
<?php
/**
* 섬네일 생성 클래스
* PHPSchool 괴부기님의 코드를 원본으로 상당부분 수정하였습니다.
*
* @class Thumbnail
* @author 괴부기, KAi
* @version 0.2 (2011-06-21)
* @see http://phpschool.com/gnuboard4/bbs/board.php?bo_table=tipntech&wr_id=46878
* @modified KAi (2011-06-21)
*
*
* - 주요기능
* - 섬네일 width, height 지정 가능 (둘 중 하나만 지정할 경우 해당 이미지 비율에 맞춰 섬네일 크기 설정)
* - 축소 방법 설정 (섬네일 안에 이미지 모두 보이게, 섬네일 크기에 꽉차게 설정 가능)
* - 출력 섬네일 파일형식 설정 가능 (GIF, JPG, PNG)
* - 섬네일 처리 전/후 콜백 함수 등록 가능 (콜백함수로 테두리 및 워터마크 등 사용자가 쉽게 추가 가능)
* - 섬네일 저장 경로를 쉽게 설정 가능 (키워드 사용으로 섬네일 경로에 이미지 크기나 경로를 쉽게 사용)
*/
define('SCALE_EXACT_FIT', 'exactfit');
define('SCALE_SHOW_ALL', 'showall');
define('EXPORT_JPG', 'jpg');
define('EXPORT_GIF', 'gif');
define('EXPORT_PNG', 'png');
class Thumbnail
{
// {{{ Variables
// 기본 옵션 정보
private static $_TdefaultOptions = Array(
'debug' => false,
'export' => 'jpg',
'preprocess' => null,
'postprocess' => null,
'savepath' => '%PATH%%FILENAME%_thumb.%EXT%'
);
// }}}
// {{{ Functions
/**
* 섬네일 이미지 생성
*
* @param String $filepath 원본 파일이 있는 경로를 지정한다.
* @param Number $width (optional) 섬네일 넓이. width와 height 둘 중 하나는 반드시 지정되어야
* 하며,하나가 null 인 경우 다른 값(width 또는 height)을 기준으로 이미지의 비율에 맞게 크기가 설정된다.
* @param Number $height (optional) 섬네일 높이.
* @param String $scale (optional) 축소 방식. 만약, width 또는 height 값 중 하나라도 지정이 안된
* 경우 scale 은 자동적으로 SCALE_SHOW_ALL이 되며 이미지 전체가 표시 된다.
* SCALE_EXACT_FIT, SCALE_SHOW_ALL 둘 중 하나를 지정가능 하고, width 및 height 값이 지정된 경우 해당 방식에
* 맞게 축소가 되는데, SCALE_EXACT_FIT 의 경우 지정된 섬네일 크기에 이미지가 꽉차게 축소된다.
* SCALE_SHOW_ALL 의 경우 섬네일 크기 안에 원본 이미지가 모두 보이도록 축소된다. 이 경우 섬네일에 여백이
* 생길 수 있다. 기본적으로 여백의 색은 검은색이지만, preprocess 함수를 지정하여 다른색으로 변경 가능하다.
* @param Array $options (optional) 기타 옵션. 기타 옵션에서는 출력될 섬네일 파일 형식과, 섬네일
* 전/후 처리 콜백 함수, 섬네일 저장 경로를 설정 가능하다.
*
* - 옵션 항목
* $options = Array(
* 'export' => 'jpg',
* 'preprocess' => Array(&$class, 'preprocess'),
* 'postprocess' => 'postprocess',
* 'savepath' => '%PATH%%FILENAME%_thumb.%EXT%'
* );
*
* export 에서는 gif, jpg, png 를 선택할 수 있다. (기본값은 jpg)
* preprocess, postprocess 에서는 섬네일 생성시 이미지 축소 전/후에 콜백함수를 호출하여 배경 및 워터마크를
* 넣도록 할 수 있다. 설정방법은 여타 PHP 함수 호출과 마찬가지로, 클래스 메소드를 호출할 경우 preprocess
* 내용 처럼 배열로 클래스 객체와 메소드를 넘겨주면되고, 일반 함수를 호출할 경우 postprocess 처럼 함수명을
* 적으면 된다.
* savepath 는 섬네일이 저장된 경로를 설정하는 것으로 미리 설정된 키워드를 통해 원본이미지 경로 정보를 이용
* 할 수 있다. 기본값은 원본이미지 경로 뒤에 _thumb 이 붙는것으로 원본이미지와 같은 폴더에 저장이 된다.
* 다른 폴더에 저장을 하려면 %PATH% 키워드 앞이나 뒤에 다른 경로를 적거나 %PATH% 대신 다른 경로를 적으면 되며
* 만약 해당 경로에 폴더가 없다면 자동으로 생성 된다.
* ※ 중요: savepath 설정할때 %EXT% 와 같은 확장자가 빠지면 확장자 없이 이미지 경로가 생성되기 때문에 문제가
* 될 수 있습니다.
*
* - 설정된 키워드
* %PATH% 원본 이미지 경로
* %FILENAME% 원본 이미지 파일명 (확장자 제외)
* %EXT% 섬네일 출력 형식 확장자 (옵션에서 export 로 설정된 형식의 확장자 사용)
* %THUMB_WIDTH 섬네일 넓이
* %THUMB_HEIGHT 섬네일 높이
* %IMAGE_WIDTH 원본 이미지 넓이
* %IMAGE_HEIGHT 원본 이미지 높이
*
* @return String 섬네일 경로
*/
public static function create($filepath, $width = null, $height = null, $scale = 'exactfit', $options = null)
{
// 원본 이미지가 없는 경우
if ( ! file_exists($filepath))
Thumbnail::raiseError('#Error: Thumbnail::create() : File not found or permission error.'.' at '. __LINE__);
// 섬네일 크기가 잘못 지정된 경우
if ($width <= 1 && $height <= 1)
Thumbnail::raiseError('#Error: Thumbnail::create() : Invalid thumbnail size.'.' at '. __LINE__);
// 스케일 지정이 안되어 있거나 틀릴 경우 기본 SCALE_SHOW_ALL 으로 지정
if ( ! $scale || ($scale != SCALE_EXACT_FIT && $scale != SCALE_SHOW_ALL))
$scale = SCALE_SHOW_ALL;
// 기타 옵션
if ($options)
$options = array_merge(Thumbnail::$_TdefaultOptions, $options);
// 옵션 중 출력 이미지 형식이 잘못 지정된 경우
if ( ! in_array($options['export'], Array('jpg', 'gif', 'png')))
Thumbnail::raiseError('#Error: Thumbnail::create() : Invalid export format.'.' at '. __LINE__);
// 이미지 타입이 지원되지 않는 경우
// 1 = GIF, 2 = JPEG
$type = getimagesize($filepath);
if (($type[2] < 1 || $type[2] > 2) ||
($type[2] == 1 && ! function_exists('imagegif')) ||
($type[2] == 2 && ! function_exists('imagejpeg')))
{
Thumbnail::raiseError('#Error: Thumbnail::create() : Filetype not supported. Thumbnail not created.'.' at '. __LINE__);
}
// 원본 이미지로부터 Image 객체 생성
switch ($type[2])
{
case 1: $image = imagecreatefromgif($filepath); break;
case 2: $image = imagecreatefromjpeg($filepath); break;
}
// AntiAlias
if (function_exists('imageantialias'))
imageantialias($image, TRUE);
// 이미지 크기 설정
$image_attr = getimagesize($filepath);
$image_width = $image_attr[0];
$image_height = $image_attr[1];
if ($width > 0 && $height > 0)
{
// 섬네일 크기 안에 모두 표시
// 이미지의 가장 큰 면을 기준으로 지정
switch ($scale)
{
case SCALE_SHOW_ALL: $side = ($image_width >= $image_height) ? 'width' : 'height'; break;
case SCALE_EXACT_FIT:
default: $side = ($image_width / $width <= $image_height / $height) ? 'width' : 'height'; break;
}
$thumb_x = $thumb_y = 0;
if ($side == 'width')
{
$ratio = $image_width / $width;
$thumb_width = $width;
$thumb_height = floor($image_height / $ratio);
$thumb_y = round(($height - $thumb_height) / 2);
}
else
{
$ratio = $image_height / $height;
$thumb_width = floor($image_width / $ratio);
$thumb_height = $height;
$thumb_x = round(($width - $thumb_width) / 2);
}
}
else
{
// width 또는 height 크기가 지정되지 않았을 경우,
// 지정된 섬네일 크기 비율에 맞게 다른 면의 크기를 맞춤
$thumb_x = $thumb_y = 0;
if ( ! $width)
{
$thumb_width = $width = intval($image_width / ($image_height / $height));
$thumb_height = $height;
}
elseif ( ! $height)
{
$thumb_width = $width;
$thumb_height = $height = intval($image_height / ($image_width / $width));
}
}
// 섬네일 객체 생성
$thumbnail = imagecreatetruecolor($width, $height);
if ($options['preprocess'])
call_user_func($options['preprocess'], &$thumbnail, $width, $height, $thumb_width, $thumb_height);
@imagecopyresampled($thumbnail, $image, $thumb_x, $thumb_y, 0, 0, $thumb_width, $thumb_height, $image_width, $image_height);
if ($options['postprocess'])
call_user_func($options['postprocess'], &$thumbnail, $width, $height, $thumb_width, $thumb_height);
// 저장할 경로 생성 및 디렉토리 검사
preg_match('@^(.+/)?([^/]+)\.([^.]+)?$@', $filepath, $m);
$savepath = str_replace(Array('%PATH%', '%FILENAME%', '%EXT%', '%THUMB_WIDTH%', '%THUMB_HEIGHT%', '%IMAGE_WIDTH%', '%IMAGE_HEIGHT%'), Array($m[1], $m[2], $options['export'], $width, $height, $image_width, $image_height), $options['savepath']);
Thumbnail::validatePath($savepath);
// 지정된 포멧으로 섬네일이미지 저장
$iserror = false;
switch ($options['export'])
{
case EXPORT_GIF: if ( ! imagegif($thumbnail, $savepath)) $iserror = true; break;
case EXPORT_PNG: if ( ! imagepng($thumbnail, $savepath)) $iserror = true; break;
case EXPORT_JPG:
default: if ( ! imagejpeg($thumbnail, $savepath)) $iserror = true; break;
}
if ($iserror)
Thumbnail::raiseError('#Error: Thumbnail::create() : invalid path or permission error.'.' at '. __LINE__);
elseif (Thumbnail::getOption('debug'))
{
echo '@Debug: Thumbnail::create() - source='. $filepath .', image[width='. $image_width .',height='. $image_height .'], '
.'thumb[width='. $width .',height='. $height .'], scale='. $scale .', scaled[x='. $thumb_x .',y='. $thumb_y
.',width='. $thumb_width .',height='. $thumb_height .']부족하거나 추가할 부분 있으면 직접 수정하셔도 무방합니다.. =_= |
|||||
|
|||||
-
게시물 12,481건
12345678910
