We zijn blij aan te kondigen dat GroupDocs.Viewer for Python 26.9 beschikbaar is vanaf september 2026. Deze release werkt de onderliggende GroupDocs.Viewer‑engine bij van 26.4 naar 26.8, voegt ondersteuning toe voor het renderen van Microsoft Project‑bestanden op Linux en macOS, introduceert paginanummer‑ en resolutie‑instellingen voor Word‑documenten, verwijdert de libgdiplus‑afhankelijkheid op niet‑Windows‑platformen en herstelt compatibiliteit met Python 3.5–3.7. De ingebedde .NET‑runtime is bijgewerkt naar 10.0.12 en de Python‑API bevat nu volledige docstrings met code‑voorbeelden.

What’s new in this release

  • [Feature] Voeg WordProcessingOptions.page_number_location en de WordsPageNumberLocation‑enum toe om paginanummers op gerenderde Word‑documenten te plaatsen (VIEWERPYTHON-153)
  • [Feature] Voeg WordProcessingOptions.horizontal_resolution / vertical_resolution toe om de DPI van PNG‑ en JPEG‑output voor Word‑documenten in te stellen (VIEWERPYTHON-154)
  • [Feature] Voeg ondersteuning toe voor het renderen van Microsoft Project‑bestanden (MPP, MPT, MPX) op Linux en macOS (VIEWERPYTHON-155)
  • [Enhancement] Werk de GroupDocs.Viewer‑engine bij van 26.4 naar 26.8 (VIEWERPYTHON-156)
  • [Enhancement] Werk de ingebedde .NET‑runtime bij van 10.0.0 naar 10.0.12 (VIEWERPYTHON-157)
  • [Enhancement] Verwijder de libgdiplus / mono-libgdiplus‑vereiste op Linux en macOS (VIEWERPYTHON-158)
  • [Enhancement] Lever dezelfde Python‑API op elk platform — de Linux‑ en macOS‑pakketten krijgen ProjectManagementOptions en de FileType‑leden voor Project, Photoshop, Illustrator en OneNote (VIEWERPYTHON-159)
  • [Enhancement] Voeg docstrings met samenvattingen, parameters en code‑voorbeelden toe aan de Python‑API (VIEWERPYTHON-160)
  • [Enhancement] Voeg een Developer Guide‑sectie toe aan de API‑referentie (VIEWERPYTHON-161)
  • [Fix] Het pakket kan niet worden gebruikt met Python 3.5 – 3.7 (VIEWERPYTHON-162)
  • [Fix] pip installeert het pakket op Linux‑ en macOS‑versies die het niet kunnen uitvoeren (VIEWERPYTHON-163)

Public API changes

Er is niets verwijderd of hernoemd.

Nieuwe types

Type Module Beschrijving
WordsPageNumberLocation groupdocs.viewer.options Waar paginanummers op een gerenderd Word‑document worden geplaatst: NOT_APPLY (standaard), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

Nieuwe leden op bestaande klassen

Klasse Lid Beschrijving
WordProcessingOptions page_number_location Paginanummering die wordt toegepast tijdens het renderen (WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution Horizontale DPI van PNG / JPEG‑output, 72 – 600 (standaard 96)
WordProcessingOptions vertical_resolution Verticale DPI van PNG / JPEG‑output, 72 – 600 (standaard 96)

Nieuw op Linux en macOS

ProjectManagementOptions, BaseViewOptions.project_management_options en FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE waren al beschikbaar op Windows en zijn nu ook in de Linux‑ en macOS‑pakketten — zie Eén Python‑API op elk platform.

Nieuwe functies

Microsoft Project‑bestanden op Linux en macOS

MPP-, MPT- en MPX‑bestanden konden alleen op Windows worden gerenderd; op Linux en macOS resulteerden ze in Failed to detect file type. De 26.8‑engine rendert ze op elk platform, met dezelfde ProjectManagementOptions als op Windows:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

Installeer op Linux eerst de Microsoft‑core‑fonts (ttf-mscorefonts-installer): zonder deze fonts faalt Project‑rendering met Cannot find fallback font 'Generic Sans Serif', en metric‑compatibele substituten zoals Liberation voldoen niet aan die lookup.

Paginanummers op gerenderde Word‑documenten

WordProcessingOptions.page_number_location plaatst paginanummers op een Word‑document tijdens het renderen, zelfs als het document er zelf geen heeft. Kies een van de zes posities uit de nieuwe WordsPageNumberLocation‑enum; de standaard NOT_APPLY laat het document ongewijzigd.

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

Resolutie van PNG‑ en JPEG‑output voor Word‑documenten

WordProcessingOptions.horizontal_resolution en vertical_resolution stellen de DPI van afbeeldingen in die uit Word‑documenten worden gerenderd. Standaard is 96 DPI; waarden buiten 72 – 600 DPI worden begrensd tot dat bereik.

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

with Viewer("document.docx") as viewer:
    options = PngViewOptions("page_{0}.png")
    options.word_processing_options.horizontal_resolution = 300
    options.word_processing_options.vertical_resolution = 300
    viewer.view(options)

Geen libgdiplus meer

De Linux‑ en macOS‑pakketten renderen via SkiaSharp en Aspose.Drawing, die in het wheel zijn opgenomen. Ze roepen nooit libgdiplus aan: elk gedocumenteerd voorbeeld draait in een Linux‑container die noch libgdiplus noch de bijbehorende grafische afhankelijkheden bevat. Verwijder libgdiplus / mono-libgdiplus uit je images en provisioning‑scripts.

Eén Python‑API op elk platform

Eerdere Linux‑ en macOS‑pakketten boden een kleinere API dan de Windows‑versie. 26.9 levert dezelfde API overal, zodat code die volgens de documentatie is geschreven op elk platform kan worden geïmporteerd. De Linux‑ en macOS‑pakketten krijgen ProjectManagementOptions en de FileType.MPP, MPT en MPX‑leden, die nu ook daar werken.

Daarnaast krijgen ze FileType.PSD, PSB, AI en ONE. Deze formaten blijven Windows‑only; op Linux en macOS leidt toegang tot een van deze leden tot GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. Om tijdens runtime te bepalen of een formaat kan worden gerenderd, controleer je FileType.get_supported_file_types(), dat alleen de formaten opsomt die de actieve engine ondersteunt:

from groupdocs.viewer import FileType

supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported)   # True op Windows, False op Linux en macOS
print(".mpp" in supported)   # True overal

Codevoorbeeld

Om een Microsoft Project‑bestand op Linux of macOS te renderen met dagelijkse tijdseenheden:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

Om paginanummers toe te passen op een Word‑document en te renderen naar PDF:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

Hoe de update te verkrijgen

PyPI

Upgrade naar het nieuwste pakket via PyPI:

pip install groupdocs-viewer-net==26.9.0

Directe download

Download wheel‑bestanden voor alle platformen vanaf de pagina GroupDocs.Viewer for Python via .NET 26.9.

Bronnen