QRcode Perl CGI & PHP script ver.0.50i Copyright (c)2000-2009, Y.Swetake All Rights Reserved. 1. 이 소프트웨어는? 이 프로그램은 사용자의 입력을 받아 Perl이나 PHP로 QR코드 이미지를 내보내는 무료 소프트웨어이다. 이 프로그램은 QR코드의 모델 2, 버전 1 ~ 40을 지원한다. 그러나 몇 가지 기능들은 지원되지 않는다. (예를 들어, 모드 변경, KANJI 모드 등) 2. 파일들 qr_img0.50 -+- perl -+- qr_img.cgi | +- qr_image.pl | +- qr_html.pl | +- data -+- qrvV_N.dat | +- rscX.dat | +- qrvfrV.dat | +- image -+- qrvV.png | +- b.png | +- d.png | +- php --- qr_img.php qr_img.cgi Perl 프로그램 (CGI 프로그램이지만, 쉘에서도 실행된다.) qr_image.pl PNG나 JPEG 이미지를 만들기 위한 보조 프로그램 qr_html.pl HTML 문서를 만들기 위한 보조 프로그램 qrvV_N.dat 위치, 마스크를 표시한 데이터 파일 (버전 V, 오류 정정 단계 N) rscX.dat RS 인코딩을 위한 데이터 파일 qrvfrV.dat [HTML 모드] 버전 V의 고정 패턴을 표시한 데이터 파일 qrvV.png 버전 V의 고정 패턴을 표시한 이미지 b.png [HTML 모드] 밝은색 사각형 이미지 d.png [HTML 모드] 어두운색 사각형 이미지 qr_img.php PHP 프로그램 (GD가 필요하다.) README_k.txt 현재 문서 3. 요구 사항 PNG나 JPEG 이미지를 만들기 위해서는 GD가 필요하다. Perl이나 PHP에서 GD를 올바르게 사용하기 위해 파라미터를 설정하거나 재컴파일해야 할 수도 있다. 제작자는 이 프로그램이 아래 환경에서 제대로 실행되는 것을 확인했다: Linux 2.4.18 (x86) @ apache-1.3.27 + PHP-4.3.0(as apache module) @ perl 5.6.1 @ GD 2.0.11 @ GD.pm 2.06 * 주의 * 이 프로그램은 GD 2.0.0 ~ 2.0.9 또는 PHP 4.3.0 ~ 4.3.1의 번들 GD에서 그것의 버그에 의해 제대로 작동하지 않는다. GD 1.8.x나 2.0.10 이상을 사용하여라. 4. 사용법 4-1. 설정 Set a path to perl or php (when using as cgi). Change values in setting area in the script if you need to. (If you use in unpacked placement, you don't have to change anything. But you may need to move some files to indicated position. eg. b.png ) 4-2. 사용법 브라우저에서 요청할 것: qr_img.cgi?d=data[&e=(L,M,Q,H)][&s=int size][&v=(1-40)][&t=(J,H)] [&m=(1-16)&n=(2-16)[&o=original data][&p=(0-255)]] qr_img.php?d=data[&e=(L,M,Q,H)][&s=int size][&v=(1-40)][&t=J] [&m=(1-16)&n=(2-16)[&o=original data][&p=(0-255)]] d : QR코드로 인코딩하고 싶은 데이터를 입력해라. % 같은 특수 문자나 공백, 8비트 문자들은 URL 인코딩이 되어 있어야만 한다. 이 파라미터는 절대로 생략할 수 없다. e : 오류 정정 단계 L, M, Q, H로 설정할 수 있다. 설정하지 않는다면, 이 프로그램이 자동으로 M을 선택한다. s : 모듈의 크기 이 파라미터는 HTML 모드에서 효과를 미치지 않는다. 1보다 큰 정수로 설정할 수 있다. 출력되는 QR코드의 크기는 이 값에 비례한다. 설정하지 않는다면, 이 프로그램이 PNG 모드에서는 4를, JPEG 모드에서는 8을 선택한다. v : QR코드의 버전 1부터 40까지의 정수로 설정할 수 있다. 설정하지 않는다면, 이 프로그램이 자동으로 최적의 크기를 선택한다. t : 이미지의 종류 J, H로 설정할 수 있다. J : JPEG 모드 H : HTML 모드 (Perl만 가능) 다른 문자 : PNG 모드 설정하지 않는다면, 이 프로그램이 자동으로 PNG 모드를 선택한다. * 주의 * 아래의 파라미터들은 실험적 기능이다. 제작자는 이 파라미터의 사용으로 인한 오류를 책임지지 않는다. n : 분할된 QR코드의 총 개수 (2 ~ 16) m : 분할된 QR코드 중 m번째 코드를 출력 (1 ~ 16) p : 분할 구조 패리티 o : 원본 데이터 (URL 인코딩된 상태) - 패리티 검사 용도 쉘에서 요청할 것(Perl만 해당): 예제) $ ./qr_img.cgi d=This+is+a+pen e=L s=3 > qrcode.png $ ./qr_img.cgi e=H < data.txt > qrcode.png STDIN으로 데이터를 입력한다면, 그것은 굳이 URL 인코딩 되어 있을 필요가 없다. 5. 정보 This software is free software. You can freely use, change or redistribute it provided that you do not change the copyright and disclaimer in this program and this document. THIS SOFTWARE IS PROVIDED BY Y.Swetake ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Y.Swetake OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 6. 기타 버그를 찾는다면, 제작자에게 연락해라. (그러나 제작자는 영어를 잘 하지 못하기 때문에 답장이 불가능할 수도 있다.) E-mail: swe@venus.dti.ne.jp URL: http://www.swetake.com (일본어 홈페이지)