PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 11편 사진 섞어 합치기와 용량 맞추기

PANCO_IT
#PDF 합치기#PDF 용량 줄이기#pypdf#Pillow#파이썬

회사에 서류를 낼 때는 재직증명서 PDF와 신분증 사진, 스캔한 서류가 한꺼번에 필요한 경우가 많습니다. 지금까지 만든 pdf_core.py로 이걸 한 파일로 만들려면 사진을 먼저 PDF로 묶고, 그 PDF를 다른 PDF와 다시 합쳐야 했습니다. 용량을 줄이는 기능도 사진 묶음에만 있어서, 합친 파일이 올리는 곳의 용량 제한을 넘으면 손쓸 방법이 없었습니다.

10편에서 정한 화면은 파일 목록에 PDF와 사진을 같이 넣고, 결과 용량을 5·10·20MB 이하나 제한 없음 가운데 하나로 정하는 모양입니다. 이번 편에서는 그 화면이 쓸 섞어 합치기와 전체 용량 맞추기를 pdf_core.py에 넣었습니다.

사진과 PDF를 한 번에 합치기

목록에 있는 파일을 차례대로 보면서, 사진이면 한 쪽짜리 PDF로 바꿔 붙이고 PDF면 그대로 붙였습니다. 용량을 줄일 때는 쪽 안에 들어 있는 그림만 다시 저장하게 했습니다.

사진_확장자 = {".jpg", ".jpeg", ".png"}

def 섞어_합치기(files, out, quality=None, scale=1.0):
    writer = PdfWriter()
    for f in files:
        if Path(f).suffix.lower() in 사진_확장자:
            # 사진은 한 쪽짜리 PDF로 만들어 메모리에 두었다가 이어 붙인다
            buf = BytesIO()
            _사진_열기([f])[0].save(buf, format="PDF", quality=85)
            writer.append(PdfReader(buf))
            continue
        try:
            reader = PdfReader(f)
        except (PdfReadError, OSError):
            raise PdfToolError(f"열 수 없는 PDF입니다: {Path(f).name}")
        if reader.is_encrypted:
            raise PdfToolError(f"암호가 걸린 파일은 넣을 수 없습니다: {Path(f).name}")
        writer.append(reader)
    if quality is not None:
        # 쪽 안에 들어 있는 그림(사진·스캔)만 다시 저장한다. 글자는 그대로 둔다
        for page in writer.pages:
            for img in page.images:
                im = img.image.convert("RGB")
                if scale < 1:
                    im = im.resize((round(im.width * scale), round(im.height * scale)))
                img.replace(im, quality=quality)
    writer.write(out)
    return len(writer.pages)
  • 사진을 한 쪽 PDF로 바꾸기 (BytesIO): 사진을 PDF 파일로 따로 저장하지 않고 메모리 안에서 PDF로 만든 다음 바로 이어 붙입니다. 5편에서 만든 _사진_열기를 거치기 때문에 휴대폰 사진이 옆으로 눕지 않습니다.
  • 암호 걸린 PDF 막기 (is_encrypted): 암호가 걸린 파일을 만나면 파일 이름을 알려 주고 멈춥니다. 어느 파일이 문제인지 이름으로 바로 알 수 있습니다.
  • 쪽 안 그림만 다시 저장하기 (page.images, replace): pypdf는 쪽마다 들어 있는 그림을 꺼내서 다른 그림으로 바꿔 넣을 수 있습니다. 글자로 만든 쪽에는 그림이 없어서 화질을 낮춰도 바뀌지 않습니다.

시험 파일은 8편에서 쓴 PDF와 5편에서 받은 휴대폰 사진입니다.

파일내용크기
01_계약서.pdf크롬에서 인쇄한 한글 글 3쪽, 목차와 링크 있음0.03MB
02_사진.jpg책 한 쪽을 찍은 휴대폰 사진(CC0)2.8MB
03_스캔_12쪽.pdf8편에서 만든 점무늬 그림 12쪽59.2MB
04_사진.jpg책 차례 쪽을 찍은 휴대폰 사진(CC0)1.2MB

그대로 합친 파일은 17쪽, 62.2MB입니다. 계약서 3쪽 다음에 사진이 바로 선 채로 4쪽에 들어갔고, 스캔 12쪽과 마지막 사진이 이어졌습니다. 세 번째 자리에 암호 걸린 PDF를 넣었을 때는 "암호가 걸린 파일은 넣을 수 없습니다: 암호.pdf"가 나오고 멈췄습니다.

합친 파일을 크롬에서 연 화면. 1~3쪽 계약서, 4쪽 휴대폰 사진이 바로 서 있음

전체 용량 맞추기

처음에는 5편 사진 묶음에서 쓴 방법을 그대로 가져왔습니다. 화질 85부터 10씩 낮추고, 50까지 내려도 크면 그림 크기를 80%씩 줄이는 방법입니다. 단계마다 목록의 파일을 처음부터 다시 합쳤습니다.

    quality, scale = 85, 1.0
    while True:
        섞어_합치기(files, out, quality, scale)
        size = Path(out).stat().st_size
        알림(f"화질 {quality}, 크기 {scale:.0%}: {size / 1024 / 1024:.1f}MB")
        if size <= limit:
            return size
        if quality > 50:
            quality = max(quality - 10, 50)
        elif scale * 0.8 >= 최소_크기:
            scale *= 0.8
        else:
            raise PdfToolError(f"그림을 원래의 {scale:.0%}까지 줄여도 {limit_mb}MB 아래로 내려가지 않습니다")

10MB를 정해 실행했습니다.

처음 코드로 10MB에 맞춘 명령어 창. 화질 85에서 62.2MB 그대로, 50까지 내린 뒤 크기를 80%씩 줄여 41%에서 6.6MB, 500.6초

10MB 아래로 내려오기까지 9번을 다시 합쳤고 8분이 넘게 걸렸습니다. 화질 85에서는 크기가 62.2MB 그대로입니다. 8편에서 점무늬 스캔을 만들 때 이미 화질 85로 저장해 두어서, 같은 화질로는 다시 저장해도 줄지 않았습니다. 화질 55에서 50으로 내렸을 때 줄어든 것은 1.1MB뿐이었고, 크게 줄어든 것은 그림 크기를 줄인 뒤부터였습니다.

마지막 결과는 10MB보다 3.4MB 작은 6.6MB입니다. 10.7MB에서 한 번 더 80%로 줄이면서 목표를 크게 지나쳤습니다.

줄이는 순서 고치기

느린 원인은 단계마다 59MB 스캔 파일을 다시 읽고 그 안의 그림 14장을 다시 푸는 데 있었습니다. 합친 파일을 한 번만 읽고 그림도 처음 한 번만 풀어 두게 바꿨습니다.

화질 85는 줄지 않았고 55와 50은 차이가 거의 없어서, 화질은 75 하나로 정했습니다. 75로도 크면, 그림 파일 크기가 가로×세로 넓이에 거의 비례한다고 보고 목표의 90%가 되는 비율을 한 번에 계산해 줄였습니다.

def 전체_용량_맞추기(files, out, limit_mb, 최소_크기=0.2, 알림=print):
    limit = limit_mb * 1024 * 1024
    섞어_합치기(files, out)
    size = Path(out).stat().st_size
    알림(f"그대로 합침: {size / 1024 / 1024:.1f}MB")
    if size <= limit:
        return size
    # 합친 파일을 한 번만 읽고, 쪽 안 그림도 처음 한 번만 풀어 둔다
    writer = PdfWriter(clone_from=out)
    그림들 = [(img, img.image.convert("RGB")) for page in writer.pages for img in page.images]
    quality, scale = 75, 1.0
    for _ in range(6):
        for img, 원본 in 그림들:
            im = 원본 if scale >= 1 else 원본.resize((round(원본.width * scale), round(원본.height * scale)))
            img.replace(im, quality=quality)
        writer.write(out)
        size = Path(out).stat().st_size
        알림(f"화질 {quality}, 크기 {scale:.0%}: {size / 1024 / 1024:.1f}MB")
        if size <= limit:
            return size
        # 파일 크기는 그림의 가로×세로에 거의 비례하므로, 목표의 90%가 되도록 한 번에 줄인다
        scale = scale * (limit * 0.9 / size) ** 0.5
        if scale < 최소_크기:
            raise PdfToolError(f"그림을 원래의 {최소_크기:.0%}까지 줄여도 {limit_mb}MB 아래로 내려가지 않습니다")
    raise PdfToolError(f"{limit_mb}MB에 맞추지 못했습니다")
  • 합친 파일 한 번만 읽기 (PdfWriter(clone_from=out)): 그대로 합친 결과를 한 번 읽어 두고, 그 안의 그림만 바꿔 가며 다시 저장합니다.
  • 그림 먼저 풀어 두기 (그림들): 쪽마다 들어 있는 그림을 처음에 한 번 풀어 원본으로 들고 있다가, 단계마다 그 원본에서 줄입니다. 줄인 그림을 또 줄이지 않아서 화질이 겹겹이 떨어지지 않습니다.
  • 목표에 맞춰 한 번에 줄이기 ((limit * 0.9 / size) ** 0.5): 지금 크기가 목표의 두 배면 넓이를 45%로, 가로세로는 그 제곱근인 약 67%로 줄입니다. 계산이 빗나가도 여섯 번 안에서 다시 계산합니다.

같은 파일로 20·10·5MB를 차례로 실행했습니다.

고친 코드로 20·10·5MB에 맞춘 명령어 창. 20MB는 58%에서 19.9MB 57.0초, 10MB는 41%에서 9.8MB 62.0초, 5MB는 29%에서 4.4MB 50.0초

목표그림 크기결과다시 저장한 횟수걸린 시간
20MB58%19.9MB2번57.0초
10MB41%9.8MB2번62.0초
5MB29%4.4MB2번50.0초

세 목표 모두 화질 75로 한 번, 크기를 줄여 한 번 해서 맞았습니다. 10MB는 처음 코드로 500.6초가 걸렸는데 62.0초로 줄었고, 결과도 6.6MB가 아니라 목표 바로 아래인 9.8MB였습니다.

실제 스캔 책으로 다시 실행

결과 파일의 스캔 쪽은 전부 회색 점입니다. 점무늬는 JPEG가 가장 줄이기 어려운 그림이라, 글자와 흰 종이가 대부분인 실제 스캔과는 줄어드는 정도가 다를 수 있습니다.

10MB로 맞춘 파일의 5쪽. 쪽 전체가 회색 점무늬

실제로 종이를 스캔한 파일이 필요했습니다. 제 서류 스캔은 개인 정보가 들어 있어 쓸 수 없어서, 저작권이 없는 옛날 책 스캔을 받았습니다. 인터넷 아카이브에 있는 1888년 미국 동화책 "Goody Two-Shoes"로, 캘리포니아 대학 도서관 소장본을 스캔한 20쪽짜리입니다. 글자 쪽과 색 삽화 쪽이 섞여 있습니다.

쪽 그림 20장을 화질 90으로 PDF 한 파일에 담았습니다. 휴대폰 스캔 앱이 만드는 PDF처럼 쪽마다 그림 한 장이 들어간 28.2MB 파일입니다. 점무늬 스캔 대신 이 파일을 넣고 고친 코드를 그대로 실행했습니다.

실제 스캔 책을 넣고 20·10·5MB에 맞춘 명령어 창. 20MB는 화질 75만으로 18.8MB 23.8초, 10MB는 69%에서 10.2MB였다가 65%에서 9.2MB 46.9초, 5MB는 49%에서 5.8MB였다가 43%에서 4.7MB 37.7초

점무늬 스캔 12쪽실제 스캔 20쪽
그대로 합친 크기62.2MB31.2MB
화질 75로만 다시 저장53.5MB(14% 줄어듦)18.8MB(40% 줄어듦)
20MB 목표2번, 19.9MB1번, 18.8MB
10MB 목표2번, 9.8MB3번, 9.2MB
5MB 목표2번, 4.4MB3번, 4.7MB

실제 스캔은 화질만 75로 낮춰도 40%가 줄어서, 20MB는 그림 크기를 건드리지 않고 맞았습니다. 그림 크기를 줄일 때는 계산만큼 줄지 않았습니다. 10MB를 맞추려고 가로세로를 69%로, 넓이로는 48%로 줄였는데 크기는 18.8MB에서 10.2MB, 54% 수준입니다. 목표를 넘어서 한 번 더 줄였고, 5MB도 같은 이유로 세 번째에 맞았습니다.

줄인 결과 열어 보기

5MB로 맞춘 파일을 크롬에서 열었습니다. 25쪽이 계약서 3쪽, 사진, 동화책 20쪽, 사진 순서로 들어 있고 삽화 색도 그대로입니다.

실제 스캔을 5MB로 맞춘 파일을 크롬에서 연 화면. 7 / 25쪽 글자 쪽과 삽화 쪽

같은 쪽을 300%로 키워 원래 파일과 비교했습니다. 이 쪽의 그림은 원래 2346×3140이었고, 5MB 파일에서는 1012×1355로 줄었습니다.

원래 파일 7쪽을 300%로 키운 화면

5MB로 맞춘 파일 7쪽을 300%로 키운 화면

5MB 쪽은 글자 가장자리가 조금 무르지만 읽는 데는 문제가 없었습니다. 200%에서는 두 화면이 거의 구분되지 않습니다. 계약서 3쪽은 그림이 없는 쪽이라 5MB 파일에서도 글자가 원래대로였고, 목차 3개와 링크 1개도 남아 있었습니다.

다음 편에서는 10편에서 정한 화면을 만들고 이번에 고친 pdf_core.py를 붙여 보겠습니다.

제가 쓴 환경은 Windows 11 노트북, Python 3.14.9, pypdf 6.21.4, Pillow 13.0.0입니다. 실제 스캔 책은 인터넷 아카이브의 "Goody Two-Shoes"(New-York: McLoughlin Bro's, c1888, University of California Libraries 소장본)입니다.

PANCO_IT

필요한 프로그램을 직접 만들고 그 과정을 적습니다

관련 글

PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 5편 사진 묶기와 용량 줄이기

휴대폰 사진 5장을 PDF로 묶어 1MB 아래로 줄이고, 화질 단계 오류와 옆으로 누운 쪽을 고쳤습니다.

· 파이썬, PDF 합치기, Pillow
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 4편 폴더 속 PDF 번호순 합치기

폴더 안 스캔 PDF 11개를 한 번에 합치는 코드를 짜고, 1 다음에 10이 붙던 순서를 숫자 순서로 고쳤습니다.

· 파이썬, PDF 합치기, pypdf
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 3편 pypdf 설치와 첫 합치기

pypdf와 Pillow를 설치하다 나온 pip 캐시 경고의 원인을 확인하고, 연습용 PDF 두 개를 만들어 처음으로 합쳐 봤습니다.

· 파이썬, PDF 합치기, pypdf
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 12편 웹 화면 만들고 코드 붙이기

10편 스케치대로 웹 화면을 만들고 11편 pdf_core.py를 붙여 브라우저에서 돌렸습니다. pdf.js로 쪽 그림을 그리고, 만드는 동안 화면이 멈추던 문제를 작업 스레드로 옮겨 고친 뒤 걸린 시간과 결과 파일을 확인했습니다.

· PDF 합치기, 웹 버전, Pyodide
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 8편 브라우저에서 같은 코드 돌려 보기

PDF 도구를 회사 동료들과 써 볼 사내 시제품으로 웹에 옮기려고 세 방법을 비교하고, Pyodide로 7편 코드를 브라우저에서 그대로 실행해 데스크톱과 같은 결과(16쪽 중 16쪽 일치)를 얻었습니다.

· 파이썬, Pyodide, 웹어셈블리
PDF 도구

파이썬으로 PDF 합치기 프로그램 만들기 6편 tkinter로 창 만들기

명령어로 돌리던 PDF 합치기와 사진 묶기를 tkinter 창 하나로 모으고, 상태줄 문구와 만드는 동안의 표시를 고쳤습니다.

· 파이썬, tkinter, PDF 합치기