Python으로 PDF 파일을 압축하는 방법

IronPDF 란 무엇이며 PDF 압축에 사용해야 하는 이유는 무엇일까요?

IronPDF는 PDF 문서의 생성, 읽기, 편집 및 최적화를 처리하는 Python PDF 라이브러리입니다. 이는 처음부터 생성되거나 HTML로 변환되거나 디스크에서 로드된 파일과 함께 작동합니다. 압축 API는 큰 PDF 크기의 주요 요인인 이미지를 대상으로 합니다.

CompressImages 메서드는 1에서 100 사이의 정수 값과, 이미지를 가시적 해상도로 축소하는 선택적 부울 값을 매개변수로 받습니다. 이 이중 매개변수 디자인은 압축을 정확히 조절할 수 있게 합니다: 고트래픽 보고서 대시보드는 70의 품질로 시각 효과를 선명하게 유지할 수 있으며, 내부 아카이브 시스템은 40의 품질로 저장 공간 절감 효과를 최대화할 수 있습니다. 라이브러리는 모든 인코딩을 내부적으로 처리하여 추가 의존성이 필요 없습니다.

IronPDF는 Iron Suite의 일부로, 문서 생성, 바코드 처리, OCR 및 ZIP 아카이빙을 포함합니다. Python 설치에서 모두 공유됩니다. 처음부터 PDF를 생성하는 데 IronPDF를 이미 사용하는 개발자를 위해 압축은 저장 또는 배포 전에 자연스럽게 따르는 단계입니다.

Python에서 IronPDF를 어떻게 설치합니까?

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/install.sh
:ProductInstall

// 이 코드 조각은 사용할 수 없습니다!
:ProductInstall

설치 후, 라이선스 키를 프로덕션 환경에 대해 구성하십시오. IronPDF는 모든 기능을 포함하는 무료 30일 체험을 제공합니다. 신용 카드는 필요 없습니다. PyPI 패키지 페이지는 최신 릴리스 노트 및 의존성 세부정보를 나열합니다.

IronPDF를 사용한 PDF 파일을 어떻게 압축합니까?

CompressImages에 정수 값을 전달하면 문서 전체에 포함된 이미지의 크기를 줄일 수 있습니다. 낮은 정수는 이미지 충실도의 비용으로 작은 파일을 만들며; 높은 정수는 더 많은 세부 사항을 보존합니다. 아래의 예는 표준 압축 호출과 이미지의 보이는 크기로 축소하는 고급 호출을 모두 보여줍니다.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/compress-basic.py
from ironpdf import PdfDocument

# Load the PDF document from a file
pdf = PdfDocument("Image based PDF.pdf")

# Compress images to quality 60 (lower numbers increase compression)
pdf.CompressImages(60)
pdf.SaveAs("document_compressed.pdf")

# Advanced: also scale images down to their visible size in the PDF
# Note: scaling can affect image clarity if pages are resized later
pdf.CompressImages(90, True)
pdf.SaveAs("Compressed.pdf")

// 이 코드 조각은 사용할 수 없습니다!
from ironpdf import PdfDocument

# Load the PDF document from a file
pdf = PdfDocument("Image based PDF.pdf")

# Compress images to quality 60 (lower numbers increase compression)
pdf.CompressImages(60)
pdf.SaveAs("document_compressed.pdf")

# Advanced: also scale images down to their visible size in the PDF
# Note: scaling can affect image clarity if pages are resized later
pdf.CompressImages(90, True)
pdf.SaveAs("Compressed.pdf")

여러 PDF 파일에 배치 압축을 어떻게 적용합니까?

PDF 파일로 구성된 폴더를 처리하는 과정은 동일한 API를 따릅니다: 각 .pdf 파일을 순차적으로 처리하고, PdfDocument를 사용하여 파일을 불러온 다음, CompressImages를 호출하고, 결과를 저장합니다. 아래의 함수는 이 패턴을 재사용 가능한 유틸리티로 감쌉니다.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/batch-compress.py
import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

// 이 코드 조각은 사용할 수 없습니다!
import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

except 블록은 손상되었거나 암호로 보호된 단일 파일로 인해 전체 배치 처리가 중단되는 것을 방지합니다. 예외 메시지와 함께 파일 이름을 기록하면 수동 검토가 필요한 파일을 식별하기 쉽습니다. 더 높은 양의 파이프라인에 대해, 폴더를 청크로 나누어 병렬 스레드에서 처리하는 것을 고려하십시오.

PDF 압축에 어떤 품질 설정을 사용해야 합니까?

적절한 품질 설정은 압축 후 PDF가 어떻게 사용될지에 따라 달라집니다. 세 가지 범위가 가장 일반적인 시나리오를 다룹니다.

고품질 (70–90): 인쇄 또는 공식적 배포를 위한 문서가 이 범위 내에 머무르는 것이 좋습니다. 표준 인쇄 해상도에서 텍스트는 선명하게, 다이어그램은 읽기 쉽게 유지됩니다. 파일 크기 감소는 보통 10–25%로 적당하지만, 대부분의 독자에게는 소스와 출력이 구분되지 않습니다.

중간 품질 (50–70): 이 범위는 웹 전송 및 이메일 첨부 파일에 적합합니다. 사진적 내용은 정밀 검사 시 약간의 부드러움이 보이지만 파일 크기 감소(종종 25–50%)는 로드 시간과 이메일 전송 가능성을 의미 있게 향상시킵니다. 대부분의 문서 관리 시스템 및 포털 업로드는 품질 60에서 잘 작동합니다.

공격적 압축 (30–50): 내부 아카이브, 장기 저장 백업, 인쇄되지 않을 문서는 이 범위를 사용할 수 있습니다. 품질 40에서 이미지는 눈에 띄게 부드러워지지만, PDF 엔진에 의해 렌더링된 텍스트(이미지로 포함되지 않은)는 여전히 선명하게 유지됩니다. 이 접근 방식은 또한 문서가 이미지로 변환되어 표시 전에 크기 조정될 경우에 적합합니다.

압축 결과를 Python에서 어떻게 확인합니까?

파일 크기를 프로그래밍 방식으로 확인하면 파일이 파이프라인의 다음 단계로 이동하기 전에 압축이 목표에 부합하는지 확인할 수 있습니다. Python의 내장 함수 os.path.getsize는 모든 파일 경로의 바이트 수를 반환하므로, 검증을 위해 추가 라이브러리가 필요하지 않습니다.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/verify-compression.py
import os
from ironpdf import PdfDocument

# Load and compress the document
pdf = PdfDocument("report.pdf")
original_size = os.path.getsize("report.pdf")

pdf.CompressImages(60)
pdf.SaveAs("report_compressed.pdf")

compressed_size = os.path.getsize("report_compressed.pdf")
reduction_pct = (1 - compressed_size / original_size) * 100

# Report results to confirm compression was effective
print(f"Original:   {original_size / 1024:.1f} KB")
print(f"Compressed: {compressed_size / 1024:.1f} KB")
print(f"Reduction:  {reduction_pct:.1f}%")

// 이 코드 조각은 사용할 수 없습니다!
import os
from ironpdf import PdfDocument

# Load and compress the document
pdf = PdfDocument("report.pdf")
original_size = os.path.getsize("report.pdf")

pdf.CompressImages(60)
pdf.SaveAs("report_compressed.pdf")

compressed_size = os.path.getsize("report_compressed.pdf")
reduction_pct = (1 - compressed_size / original_size) * 100

# Report results to confirm compression was effective
print(f"Original:   {original_size / 1024:.1f} KB")
print(f"Compressed: {compressed_size / 1024:.1f} KB")
print(f"Reduction:  {reduction_pct:.1f}%")

출력은 기록되거나 임계값과 비교할 수 있는 명확한 감소 백분율을 제공합니다. 감소가 예상을 밑돌 경우, 문서에 삽입된 이미지가 거의 없거나 전혀 없을 수 있습니다. 이 경우 CompressImages는 래스터 이미지만 대상으로 하므로, 품질 설정에 관계없이 파일 크기는 거의 변하지 않습니다. 텍스트와 벡터 그래픽은 이 방법에 영향을 받지 않습니다.

Python에서 PDF 압축의 다음 단계는 무엇입니까?

IronPDF의 CompressImages 메서드는 Python 개발자에게 PDF 파일 크기를 줄이기 위한 단일하고 명확한 범위의 API를 제공합니다. 저장 공간 절약과 시각적 충실성 간의 균형을 맞추기 위해 품질 매개변수를 조정하고 출력 차원이 고정되면 해상도 스케일링 불리언을 추가하여 두 번째 축소 과정을 제공합니다. IronPDF가 처리하는 더 넓은 범위를 보려면 Python PDF 라이브러리 개요 페이지를 참조하세요.

무료 체험을 시작하세요 IronPDF의 풀 기능 세트와 함께 압축을 테스트해보세요, HTML에서 PDF 변환, 디지털 서명, 양식 처리, 문서 병합 포함. 체험 기간이 끝나면, 라이선싱 옵션 보기 를 통해 배포에 맞는 계획을 찾으세요.

IronPDF로 무엇을 할 수 있는지 준비되셨습니까? IronPDF의 핵심 기능 설명을 위해 전체 Python PDF 튜토리얼을 탐색해보세요.