■ DQ'Thumb Engine ver 2.0 R5.0306

	최종 수정: 2005-03-06
	제작     : 드림퀘스트(본명:안현우)
	Homepage : http://www.dqstyle.com
	E-Mail   : dwander@netian.com

 ■ 라이센스
	 1. 이 주석의 전체 또는 일부를 삭제하거나 수정하실 수 없습니다.
	 2. 제로보드용 스킨 제작에 사용할 수 있는 섬네일 관련 라이브러리 입니다.
	 3. 스킨제작 이외의 목적에 사용하실 수 있습니다.
	 4. 상업적 용도(영리목적의 홈페이지 포함)에 이용할 수 없습니다.
	 5. 제작된 프로그램의 특정위치에 "DQ'Engine Used" 문구를 삽입할수 있으며,
	    클릭시 엔진 제작자 홈페이지(http://www.dqstyle.com)로 연결되어야 합니다.
	 6. "DQ'Engine Used" 문구는 반드시 삽입해야 하는것은 아닙니다. 자유의사에 맏깁니다.
	 7. 소스 중간의 버전출력 부분을 삭제하실 수 없습니다.
	 8. 제작자는 유지보수와 업그레이드의 의무가 없으며 사용도중 발생한 문제와 손실에
	    대하여 어떠한 경우라도 책임을 지지 않습니다.
	 9. 이 소스의 단독 배포 권한은 www.dqstyle.com과 제작자가 지정한 사이트에만 있습니다.
	10. 제작한 스킨이나 프로그램의 일부요소로만 재배포 할 수 있습니다.
	11. 이 소스를 사용하여 제작한 프로그램의 저작권은 해당 프로그램의 제작자에게 있지만,
	    이 소스의 저작권은 제작한 프로그램과는 별개 이므로 어떠한 경우에도 원 저작자 이외의 
            인물이나 단체에 양도 또는 이전되지 않습니다.

■ 용도
        섬네일 생성을 위한 라이브러리 입니다.
        일반적인 갤러리 스킨에 이 엔진을 사용시 빠른분은 2~3분 정도면 완벽한 섬네일형 갤러리 스킨을 만들 수 있습니다.

■ 기능
        갤러리스킨 '레볼루션'에서 검증된 안정성과 호환성
        업로드파일, HTML태그로 링크한 이미지, 그림창고 이미지에서 완벽히 섬네일을 추출해 냅니다.
        URL접근 기능을 막아 놓은 서버에서도 외부링크 이미지의 섬네일 생성가능.
        섬네일을 만들기 위해 php코드 한줄이면 해결
        GD 1.x, 2.x 버전 모두지원, GD가 없는 계정에서도 동작
        자체적으로 서버 환경을 찾아내기 때문에 복잡한 설정이 필요없음
        GIF읽기 능력이 없거나 오작동 하는 서버에서도 문제없이 GIF파일에서 섬네일 생성


---------------------------------------------------------------------------------------------------------------------------------

■ 간단한 사용법

        1. 수정할 스킨디렉토리에 엔진에 포함된파일 세개를 복사합니다.
        2. setup.php 파일에 [ include $dir."/dq_thumb_engine2.php"; ] 추가(꺽쇠 제외)

        3. list_main.php 파일에 다음 코드를 삽입합니다.
           <?
           $thumbtag = get_thumbTag($data,섬네일 X크기,섬네일 Y크기,$dir);
           ?>
           실제적인 예: $thumbtag = get_thumbTag(&$data,100,100,$dir);

        4. 섬네일이 출력되어야할 곳에 <?=$thumbtag[2]?> 삽입
           예:
           <table border=0 cellpadding=0 cellspacing=0>
           <tr><td style='border:1px #afafaf solid; padding:2px'><?=$thumbtag[2]?></td></tr>
           </table>


■ $thumbtag 배열 키 설명

	$thumbtag[0] : 섬네일의 X크기
	$thumbtag[1] : 섬네일의 Y크기
	$thumbtag[2] : 섬네일 출력을 위한 완성된 HTML태그
	 -> .thumb_border 라는 이름의 스타일이 지정되어 리턴된다.
	    같은 이름의 css를 미리 지정해서 여백이나 테두리를 설정하는것이 좋다.
	    예: <style>.thumb_border{border:1px silver solid;margin:5 0 5 0;cursor:pointer}</style>
	$thumbtag[3] : 섬네일 파일의 url (태그없는 순수한 경로)


■ 주요 함수 설명

	[]로 둘러싼 인자(옵션)는 생략가능

	array get_thumbTag()
	--------------------------------
	설명: 
	  * DQ'Engine의 거의 모든 함수를 한꺼번에 호출하는 통합 함수
	  제로보드 게시물을 분석하여 섬네일 이미지를 생성한다.
	  업로드된 파일 -> <img>태그로 링크된 이미지(그림창고 포함) 순서로 시도한다.
	  섬네일 이미지가 이미 있을경우 생성될 파일의 크기 비교후 재생성 된다.
	  섬네일 이미지가 없고, 생성된 파일이 없으면 원본이미지를 반환한다.

	형식: get_thumbTag(array zb_data, int x, int y, string dir [, string targetFile])
	  zb_data    : 제로보드의 게시물 배열, 일반적으로 $data로 하면된다.
	  x          : 섬네일 이미지의 최대 x크기
	  y          : 섬네일 이미지의 최대 y크기
	  dir        : no_screenshot.jpg 파일이 있는경로, 제로보드 스킨에 사용할때는 $dir이라고 해주면 된다.
	  targetFile : 생략하면 data/게시판id 디렉토리에 small_$no.thumb 형식의 파일을 생성
	               스킨제작에 사용하지 않고 추출기를 만든다거나 할 경우 사용하는 옵션

	반환:
	  array[0] : 섬네일의 X크기
	  array[1] : 섬네일의 Y크기
	  array[2] : 섬네일 출력을 위한 완성된 HTML태그
        	   -> .thumb_border 라는 이름의 스타일이 지정되어 리턴된다.
	              같은 이름의 css를 미리 지정해서 여백이나 테두리를 설정하는것이 좋다.
	              예: <style>.thumb_border{border:1px silver solid;margin:5 0 5 0;cursor:pointer}</style>
	  array[3] : 섬네일 파일의 url (태그없는 순수한 경로)

	사용예: 
	  $a = get_thumbTag(&$data,100,100);
	  echo $a;


	array cal_thumb_size()
	--------------------------------
	설명: 지정한 x,y 크기와 원본 이미지의 실제 크기를 비교해서 대칭비율로 리사이즈될 크기를 반환한다.
	형식: cal_thumb_size(string src_file, int x, int y)
	  src_file : 원본이미지의 경로
	             url도 가능하지만 php의 버전이 4.3.4 보다 낮다면 문제를 일으킬수 있다.
	  x        : 결과 이미지의 최대 x 크기
	  y        : 결과 이미지의 최대 y 크기

	반환:
	  array[0] : 계산된 x 크기
	  array[1] : 계산된 y 크기
	  array[3] : src_file을 그대로 되돌려줌

	사용예:
	  $src = 'data/image/img_00.jpg';
	  $a = cal_thumb_size($src, 100, 100);
	  echo "<img src=$src width=$a[0] height=$a[1] border=0>";


	array get_uploadImages()
	--------------------------------
	설명: $data 배열을 분석하여 업로드된 파일의 정보를 반환한다.
	형식: get_uploadImages(array zb_data [, [int max_no], [int all]])
	  zb_data  : 제로보드의 게시물 배열, 일반적으로 $data로 하면된다.
	  max_no   : 가져올 이미지 갯수
	             레볼루션을 위해 99개 까지 되도록 했었지만 일반 스킨에서는 2개 까지만 된다.
	  all      : 일반 스킨에서는 사용안함

	반환:
	  array[0][] : 이미지파일 경로 (예: data/photo/img_01.jpg)
	  array[1][] : 이미지파일 이름 (예: img_01.jpg)
	  array[2][] : 이미지파일 용량
	  array[3]   : 이미지파일 총갯수 (일반 스킨에서는 그다지 의미가 없다)


■ 세부 옵션 사용법
	
	※ dq_thumb_engine2.php 파일이 인클루드 되기 전에 아래 옵션을 임의로 지정할 수 있습니다.
	   임의로 지정하지 않을시에는 최적 상태로 자동 설정됩니다.
	※ 1은 true, 0은 false와 같은 용도 입니다.

	$dqEngine['using_urlImg']	= 1;
		// 1또는 0 사용, <IMG> 태그로 링크한 외부 이미지에서 썸네일 추출
		// 기본값 : 1

	$dqEngine['using_socket']	= 1;	
		// 1 또는 0 사용, 외부이미지 다운로드시 소켓을 사용한다.
		// allow_url_fopen = Off 설정이 된 서버에서도 외부이미지에 접근 가능하다.
		// 기본값 : 1

	$dqEngine['using_usm']		= 1;
		// 1또는 0 사용, 썸네일 이미지에 언샵마스크 필터를 적용한다. (샤픈필터의 한 종류)
		// GD2.0 이상, PHP 4.3.2 이외의 버전일때 기본값 1, 그외 상황에서는 기본값 0 자동선택
		// 1로 지정 하더라도 GD2.0이 아니거나 PHP 4.3.2 환경이면 자동으로 0으로 재설정 된다.
	
	$dqEngine['usm_option1']	= 60;	// USM 필터의 amount(강도) 수치, 기본값 : 60
	$dqEngine['usm_option2']	= 0.5;	// USM 필터의 radius(반경) 수치, 기본값 : 0.5
	$dqEngine['usm_option3']	= 1;	// USM 필터의 threshold(제외픽셀) 수치, 기본값 : 1
	※ USM 필터의 세부 설정은 포토샵의 그것과 사용법이 동일합니다.

	$dqEngine['thumb_resize']	= 0;
		// 0, 1, 2 사용
		// 0: 원본 비율 대칭 리사이즈, 1: 비율유지 안함(찌그러짐), 2: 원본비율 리사이즈 + Center Crop

	$dqEngine['thumb_cutpixel']	= 5;
		// '$dqEngine['thumb_resize'] = 2' 옵션 사용시, 원본 이미지에서 주위에 잘라낼 픽셀값
		// 원본 사진에 테두리가 일정하게 있을때 사용하면 유용하다.
		// 원본 이미지의 X*Y 픽셀을 곱한 값이 16000 이상일때만 유효하다. (작은 크기의 이미지는 잘라내지 않는다)
		// 기본값 : 5

	$dqEngine['using_secretImg'] = 1;
		// 1 또는 0 사용
		// 비밀글일 경우 썸네일 대신 'is_secret.jpg' 출력
		// 기본값 : 1