Jak kompresować pliki PDF w języku Python

Czym jest IronPDF i dłączego warto go używać do kompresji plików PDF?

IronPDF jest biblioteką PDF dla Pythona, która obsługuje tworzenie, czytanie, edytowanie i optymalizację dokumentów PDF. Działa z plikami tworzonymi od zera, konwertowanymi z HTML lub ładowanymi z dysku. Jej API kompresji jest skierowane do obrazów, które są głównym czynnikiem przyczyniającym się do dużych rozmiarów PDF.

Metoda CompressImages przyjmuje liczbę całkowitą w zakresie od 1 do 100 oraz opcjonalną wartość logiczną, która zmniejsza obrazy do ich widocznej rozdzielczości. Ten projekt z dwoma parametrami pozwala precyzyjnie dostroić kompresję: tablica kontrolna o dużym obciążeniu ruchem mogłaby używać jakości 70, aby zachować ostre wizualizacje, podczas gdy system archiwizacji wewnętrznej mógłby używać jakości 40, aby maksymalizować oszczędności w przechowywaniu. Biblioteka obsługuje wszystkie wewnętrzne kody, więc nie są wymagane dodatkowe zależności.

IronPDF jest częścią Iron Suite, który obejmuje tworzenie dokumentów, przetwarzanie kodów kreskowych, OCR i archiwizację ZIP, wszystko z jednoczesnego instalowania Pythona. Dla deweloperów już używających IronPDF do tworzenia PDF-ów od zera, kompresja jest naturalnym kolejnym krokiem przed zapisaniem lub udostępnieniem plików.

Jak zainstalować IronPDF w Pythonie?

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

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
:ProductInstall

(

Po instalacji skonfiguruj swój klucz licencyjny dla środowisk produkcyjnych. IronPDF obejmuje bezpłatny 30-dniowy okres próbny, który obejmuje wszystkie funkcje, w tym kompresję, bez wymagania podania karty kredytowej. Strona pakietu PyPI zawiera najnowsze informacje o wersjach oraz szczegóły dotyczące zależności.

Jak skompresować pliki PDF używając IronPDF?

Przekaż liczbę całkowitą jako parametr jakościowy do CompressImages, aby zmniejszyć rozmiar osadzonych obrazów w całym dokumencie. Niższe liczby całkowite skutkują mniejszymi plikami kosztem wierności obrazu; wyższe liczby całkowite zachowują więcej szczegółów. Poniższy przykład pokazuje zarówno standardowe wywołanie kompresji, jak i zaawansowane wywołanie, które dodatkowo zmniejsza rozmiar obrazów do ich widocznego rozmiaru.

: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")

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
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")

Jak zastosować kompresję wsadową do wielu plików PDF?

Przetwarzanie folderu plików PDF odbywa się zgodnie z tym samym interfejsem API: iteracja nad każdym plikiem .pdf, załadowanie go za pomocą PdfDocument, wywołanie CompressImages i zapisanie wyniku. Funkcja poniżej opakowuje ten wzorzec w narzędzie wielokrotnego użytku.

: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}")

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
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}")

Blok except zapobiega zatrzymaniu całej partii przez pojedynczy uszkodzony lub chroniony hasłem plik. Logowanie nazwy pliku wraz z komunikatem o wyjątku ułatwia identyfikację, które pliki wymagają ręcznej weryfikacji. Dla wyższych przepustowości, rozważ podział folderu na części i przetwarzanie ich w równoległych wątkach.

Jakie ustawienia jakości powinieneś użyć do kompresji PDF?

Odpowiednie ustawienie jakości zależy od tego, jak PDF będzie używany po kompresji. Trzy zakresy pokrywają najczęstsze scenariusze.

Wysoka jakość (70–90): Dokumenty przeznaczone do drukowania lub formalnej dystrybucji korzystają z pozostania w tym zakresie. Tekst pozostaje ostry, a diagramy pozostają czytelne przy standardowych rozdzielczościach wydruku. Redukcja rozmiaru pliku jest skromna, zazwyczaj 10–25%, ale wynik jest nie do odróżnienia od źródła dla większości czytelników.

Średnia jakość (50–70): Ten zakres pasuje do dostarczania przez sieć i załączników e-mail. Treść fotograficzna pokazuje niewielkie zmiękczenie przy bliższym przyjrzeniu, ale zmniejszenie rozmiaru pliku (często 25–50%) znacząco poprawia czasy ładowania i dostarczalność e-maili. Większość systemów zarządzania dokumentami i przesyłanie do portalu działa dobrze przy jakości 60.

Aggresywna kompresja (30–50): Wewnętrzne archiwa, długoterminowe kopie zapasowe i dokumenty, które nie będą drukowane, mogą korzystać z tego zakresu. Przy jakości 40 obrazy są wyraźnie bardziej miękkie, ale tekst renderowany przez silnik PDF (a nie osadzony jako obrazy) pozostaje w pełni ostry. To podejście jest również odpowiednie dla dokumentów, które będą konwertowane na obrazy i zmieniane przed wyświetleniem.

Jak zweryfikować wyniki kompresji w Pythonie?

Programowe sprawdzenie rozmiaru pliku wyjściowego pozwala potwierdzić, że kompresja osiągnęła zamierzony cel, zanim plik przejdzie do kolejnego etapu procesu. Wbudowana funkcja języka Python os.path.getsize zwraca liczbę bajtów dla dowolnej ścieżki pliku, więc weryfikacja nie wymaga żadnych dodatkowych bibliotek.

: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}%")

// TEN FRAGMENT KODU JEST NIEDOSTĘPNY!
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}%")

Wynik daje jasny procent redukcji, który można zalogować lub sprawdzić względem progu. Jeśli redukcja jest poniżej oczekiwań, dokument może zawierać mało lub brak osadzonych obrazów. W takim przypadku rozmiar pliku pozostanie w dużej mierze niezmieniony niezależnie od ustawienia jakości, ponieważ CompressImages dotyczy wyłącznie obrazów rastrowych. Tekst i grafika wektorowa nie są dotknięte tą metodą.

Jakie są kolejne kroki kompresji PDF w Pythonie?

Metoda CompressImages firmy IronPDF zapewnia programistom Pythona pojedynczy, dobrze zdefiniowany interfejs API do zmniejszania rozmiarów plików PDF. Dostosuj parametr jakości, aby zrównoważyć oszczędności przechowywania z wiernością wizualną, i dodaj bool do skalowania rozdzielczości dla drugiego etapu redukcji, gdy wymiary wyjściowe są ustalone. Dla szerszego spojrzenia na to, co obsługuje IronPDF, zobacz przegląd biblioteki PDF w Pythonie.

Rozpocznij swoją darmową wersję próbną, aby przetestować kompresję razem z pełnym zestawem funkcji IronPDF, w tym konwersją z HTML na PDF, podpisami cyfrowymi, obsługą formularzy i scalaniem dokumentów. Gdy okres próbny się skończy, zobacz opcje licencjonowania, aby znaleźć plan odpowiadający Twojemu wdrożeniu.

Gotowy, aby zobaczyć, co jeszcze potrafi IronPDF? Odkryj pełny samouczek PDF w Pythonie, aby krok po kroku poznać podstawowe możliwości IronPDF.