Jak renderować PDF w oryginalnym rozmiarze przy użyciu GroupDocs.Viewer dla Javy

Renderowaniene do prawidłowego wyświetlania na dowolnym urządzeniu. W tym przewodowanie oryginalnego rozmiaru strony ma znaczenie, jak skonfigurować GroupDocs.Viewer dla Javy oraz jakie. Po zakończeniu będziesz w stanie niezawodnie renderować PDF‑yzywaniem problemów renderowania pdf.

Renderuj

Szybkie odpowiedzi

-ować PDF na PNG w Javie?** GroupDocs.Viewer for Java udostępnia prosty interfejs API do konwersji pdf na png w Javie.

  • Jak zachować oryginalny rozmiar strony? Włącz setRenderOriginalPageSize(true) w obiekcie PdfOptions.
  • Czy potrzebna jest licencja do produkcji? Tak – wymagana jest stała lub tymczasowa licencja GroupDocs do użytku nie‑testowego.
  • Czy mogę renderować PDF‑y chronione hasłem? Tak, wystarczy podać hasło podczas tworzenia instancji Viewer.
  • Jaka wersja Javy jest wymagana? Obsługiwany jest JDK 8 lub nowszy.

Co oznacza „render PDF w oryginalnym rozmiarze”?

Podczas renderowania PDF‑a przeglądarka może albo skalować strony, aby dopasować je do docelowego formatu, albo zachować dokładne wymiary określone w pliku źródłowym. Renderowanie w oryginalnym rozmiarze oznacza, że każda strona jest eksportowana piksel‑idealnie, co jest kluczowe dla dokumentów prawnych, materiałów archiwalnych oraz wszelkich sytuacji, w których integralność układu nie może być naruszona.

Dlaczego zachować rozmiar strony PDF?

  • Zgodność prawna: Sądy często wymagają, aby dokumenty wyglądały dokładnie tak, jak zostały pierwotnie złożone.
  • Spójność marki: Materiały marketingowe zachowują zamierzenia projektowe.
  • Precyzja techniczna: Wymiary, diagramy i formularze pozostają użyteczne po konwersji.

Wymagania wstępne

  • Java Development Kit (JDK): Wersja 8 lub nowsza.
  • GroupDocs.Viewer for Java: Dodaj bibliotekę za pomocą Maven (patrz poniżej).
  • IDE: IntelliJ IDEA, Eclipse lub dowolny edytor kompatybilny z Javą.

Konfiguracja GroupDocs.Viewer dla Javy

Konfiguracja Maven

Dodaj oficjalne repozytorium GroupDocs oraz zależność Viewer do pliku pom.xml. (Nie modyfikuj bloku kodu – musi pozostać dokładnie taki, jak przedstawiono.)

<repositories>
   <repository>
      <id>groupdocs-repo</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Uzyskanie licencji

GroupDocs oferuje kilka opcji licencjonowania:

  • Free Trial: Przeglądaj wszystkie funkcje bez limitu czasu i liczby stron.
  • Temporary License: Pełanie dla wdrożeń produkcyjnych.

Przewod.Viewer

Utwórz instancję Viewer i skonfiguruj PngViewOptions, aby generować pliki PNG. Kluczowe wywołanie viewOptions.getPdfOptions().setRenderOriginalPageSize(true); instruuje silnik, aby ustawił oryginalny rozmiar strony.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

import java.nio.file.Path;

public class RenderOriginalPageSize {
    public static void main(String[] args) {
        // Define output directory path for rendered pages
        Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
        
        // Format for the output page file paths
        String pageFilePathFormat = "page_{0}.png";
        Path pageFilePath = outputDirectory.resolve(pageFilePathFormat);
        
        // Initialize PngViewOptions with the path format
        PngViewOptions viewOptions = new PngViewOptions(pageFilePath.toString());
        
        // Set option to render original page size for PDF documents
        viewOptions.getPdfOptions().setRenderOriginalPageSize(true);
        
        // Create a Viewer instance for the source PDF document
        try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF")) {
            // Render the PDF using the specified options
            viewer.view(viewOptions);
        }
    }
}

Wyjaśnienie kluczowych linii

  • Path Configuration: Określa, gdzie zostaną zapisane poszczególne renderowane pliki PNG.
  • PngViewOptions: Wybiera PNG jako format wyjściowy (klasyczny scenariusz pdf to png java).
  • Render Original Page Size: Gwarantuje brak skalowania, zachowując dokładne wymiary każdej strony PDF.

Krok 2: Uruchom i zweryfikuj

Uruchom metodę main. Po zakończeniu otwórz wygenerowane pliki PNG; powinny one odpowiadać oryginalnym wymiarom stron PDF piksel‑po‑pikselu. Jeśli obrazy wydają się rozciągnięte, sprawdź ponownie, czy setRenderOriginalPageSize(true) jest obecne oraz czy używasz najnowszej wersji GroupDocs.Viewer.

Rozwiązywanie problemów i typowe pułapki

  • Nieprawidłowe ścieżki plików: Upewnij się, że zarówno outputDirectory, jak i ścieżka do źródłowego PDF są absolutne lub prawidłowo względne względem projektu.
  • Brak licencji: Bez ważnej licencji renderowanie może przejść w tryb testowyci przy dużych PDF‑ach:** Zwiększ przydział pamięci JVM (-Xmx2g lub więcej) lub włącz leniwe ładowanie stron.
  • Zaszyfrowane PDF‑y: Podaj hasło przy tworzeniu instancji Viewer, aby uniknąć błędów pdf rendering troubleshooting.

Praktyczne przypadki użycia

  1. Cyfrowe archiwa: Zachowaj historyczne skanyów prawnych:** Udostępniaj PDF‑y gotowe do są zosta. Platformy e‑learningowe: Konwertuj podręczniki do formatu obrazu, zachowując niezmieniony układ.
  2. Automatyzacja faktur: Zapewnij, że pozycje i sumy pozostają czytelne po konwersji.

Wskazówki dotyczące wydajnościarczającą przestrzeń sterty dla dużanie:** Renderuj tylko potrzebne strony, zamiast całego pliku, gdy to możliwe.

  • Cache: Przechowuj renderowane PNG‑y dla często używanych PDF‑ów, aby uniknąć powtarzającego się przetwarzania.

Najczęściej zadaw Boot?**

A: Zarejestruj Viewer jako bean i wstrzykuj go tam.

Q: Czy mogę renderować PDF‑y do
A: Tak, GroupDocs.Viewer obsługuje także konwersje do JPEG, SVG oraz PDF‑to‑HTML.

Q: Co zrobić, gdy proces renderowania kończy się wyjątkiem?
A: Sprawdów lub problemów z licencją oraz zweryfikuj, że PDF nie jest uszkodzony.

Q: Czy istnieje limit rozmiaru PDF‑ów, które można renderować?
A: Technicznie nie, ale bardzo duże pliki mogą wymagać zwiększonej pamięci Czy GroupDocs.Viewer obsługuje PDF‑y chronione hasć hasło do konstruktora Viewer lub za pośrednictwem obiektu LoadOptions.

Zasoby

Ostatnia aktualizacja: 2026-01-31
Testowane z: GroupDocs.Viewer 25.2 for Java
Autor: GroupDocs