私たちは GroupDocs.Viewer for Python 26.9 のリリースをお知らせできることを嬉しく思います。リリース日は 2026年9月 です。このリリースでは、基盤となる GroupDocs.Viewer エンジンを 26.4 から 26.8 にアップグレードし、Linux および macOS での Microsoft Project ファイルのレンダリングをサポートし、Word 文書のページ番号付与と解像度制御を導入し、非 Windows プラットフォームでの libgdiplus 依存性を削除し、Python 3.5–3.7 との互換性を復元しました。組み込みの .NET ランタイムは 10.0.12 に更新され、Python API にはコード例付きの完全な docstring が追加されました。

このリリースの新機能

  • [Feature] WordProcessingOptions.page_number_location と WordsPageNumberLocation 列挙型を追加し、レンダリングされた Word 文書にページ番号をスタンプします (VIEWERPYTHON-153)
  • [Feature] WordProcessingOptions.horizontal_resolution / vertical_resolution を追加し、Word 文書の PNG および JPEG 出力の DPI を設定できるようにしました (VIEWERPYTHON-154)
  • [Feature] Linux と macOS で Microsoft Project ファイル (MPP、MPT、MPX) のレンダリングをサポートしました (VIEWERPYTHON-155)
  • [Enhancement] GroupDocs.Viewer エンジンを 26.4 から 26.8 に更新しました (VIEWERPYTHON-156)
  • [Enhancement] 組み込みの .NET ランタイムを 10.0.0 から 10.0.12 に更新しました (VIEWERPYTHON-157)
  • [Enhancement] Linux と macOS での libgdiplus / mono-libgdiplus の要件を削除しました (VIEWERPYTHON-158)
  • [Enhancement] すべてのプラットフォームで同一の Python API を提供します — Linux と macOS のパッケージにも ProjectManagementOptions と Project、Photoshop、Illustrator、OneNote 用の FileType メンバーが追加されました (VIEWERPYTHON-159)
  • [Enhancement] Python API に要約、パラメータ、コード例を含む docstring を追加しました (VIEWERPYTHON-160)
  • [Enhancement] API リファレンスに開発者ガイドセクションを追加しました (VIEWERPYTHON-161)
  • [Fix] Python 3.5 – 3.7 でパッケージが使用できない問題を修正しました (VIEWERPYTHON-162)
  • [Fix] Linux と macOS のバージョンで pip がパッケージをインストールできない問題を修正しました (VIEWERPYTHON-163)

公開 API の変更

削除または名前変更された項目はありません。

新しい型

型 モジュール 説明
WordsPageNumberLocation groupdocs.viewer.options レンダリングされた Word 文書にページ番号をスタンプする位置: NOT_APPLY（デフォルト）、TOP_LEFT、TOP_CENTER、TOP_RIGHT、BOTTOM_LEFT、BOTTOM_CENTER、BOTTOM_RIGHT

既存クラスへの新メンバー

クラス メンバー 説明
WordProcessingOptions page_number_location レンダリング時に適用するページ番号付与（WordsPageNumberLocation）
WordProcessingOptions horizontal_resolution PNG / JPEG 出力の水平 DPI、範囲 72 – 600（デフォルト 96）
WordProcessingOptions vertical_resolution PNG / JPEG 出力の垂直 DPI、範囲 72 – 600（デフォルト 96）

Linux と macOS の新機能

ProjectManagementOptions、BaseViewOptions.project_management_options、および FileType.MPP、MPT、MPX、PSD、PSB、AI、ONE は Windows ですでに利用可能でしたが、Linux と macOS のパッケージにも追加されました — すべてのプラットフォームで同一の Python API をご参照ください。

新機能

Linux と macOS での Microsoft Project ファイル

従来、MPP、MPT、MPX ファイルは Windows のみでレンダリングでき、Linux と macOS では Failed to detect file type エラーが発生していました。26.8 エンジンはすべてのプラットフォームでこれらをレンダリングし、Windows と同じ ProjectManagementOptions を使用します。

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)

Linux ではまず Microsoft core fonts（ttf-mscorefonts-installer）をインストールしてください。フォントが無いと Cannot find fallback font 'Generic Sans Serif' エラーで Project のレンダリングが失敗し、Liberation などのメトリック互換フォントでは代替できません。

レンダリングされた Word 文書へのページ番号付与

WordProcessingOptions.page_number_location は、文書にページ番号が無くてもレンダリング時にページ番号をスタンプします。新しい WordsPageNumberLocation 列挙型から 6 つの位置のいずれかを選択でき、デフォルトの NOT_APPLY は文書をそのままにします。

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)

Word 文書の PNG / JPEG 出力解像度

WordProcessingOptions.horizontal_resolution と vertical_resolution で、Word 文書からレンダリングされる画像の DPI を設定できます。デフォルトは 96 DPI で、72 – 600 DPI の範囲外の値は自動的にクランプされます。

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)

libgdiplus は不要

Linux と macOS のパッケージは SkiaSharp と Aspose.Drawing を使用してレンダリングし、これらは wheel に同梱されています。libgdiplus は一切呼び出さず、ドキュメント化されたすべての例は libgdiplus もそのグラフィック依存関係も持たない Linux コンテナで動作します。イメージやプロビジョニングスクリプトから libgdiplus / mono-libgdiplus を削除してください。

すべてのプラットフォームで同一の Python API

以前は Linux と macOS のパッケージが Windows よりも小さな API を提供していました。26.9 ではすべてのプラットフォームで同一の API が提供されるため、ドキュメントに基づくコードはどの環境でもインポート可能です。Linux と macOS のパッケージにも ProjectManagementOptions と FileType.MPP、MPT、MPX が追加され、同様に機能します。

さらに FileType.PSD、PSB、AI、ONE も追加されましたが、これらのフォーマットは Windows のみでサポートされており、Linux と macOS でこれらのメンバーにアクセスすると GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. がスローされます。実行時にフォーマットがレンダリング可能か判定するには、FileType.get_supported_file_types() を使用してください。このメソッドは現在のエンジンがサポートするファイルタイプのみを返します。

from groupdocs.viewer import FileType

supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported)   # Windows では True、Linux と macOS では False
print(".mpp" in supported)   # すべてのプラットフォームで True

コード例

Linux または macOS で Microsoft Project ファイルを日単位の時間単位でレンダリングする例:

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)

Word 文書にページ番号を付与して 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)

アップデートの取得方法

PyPI

PyPI から最新パッケージにアップグレードします:

pip install groupdocs-viewer-net==26.9.0

直接ダウンロード

すべてのプラットフォーム用の wheel ファイルは GroupDocs.Viewer for Python via .NET 26.9 ページからダウンロードできます。

リソース