0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@iceblue(リー ニック)

Python で PDF 閲覧設定を最適化

0
Posted at

実際のオフィス業務やドキュメント配布の場面では、PDFファイルの読書体験が情報伝達の効率に直接影響します。多くのユーザーはPDFファイルを開く際、ウィンドウサイズの不適切さ、ツールバーによる内容の遮蔽、ページレイアウトの混乱などの問題に頻繁に遭遇し、正常に読むために手動でウィンドウやビュー設定を調整する必要があります。大量配布が必要なドキュメント（製品マニュアル、研修資料、契約書類など）の場合、各読者が自ら読書設定を調整する必要があると、ユーザー体験に影響を与えるだけでなく、情報表示の一貫性の欠如を招く可能性があります。

本記事では、Pythonを使用してPDFドキュメントの閲覧設定をプログラム的に設定する方法を紹介します。ウィンドウ表示方式、ページレイアウトモード、ツールバーの表示状態、ズーム倍率などの主要な設定を含みます。このプロセス全体を自動化でき、一括ドキュメント処理、企業ドキュメントの標準化、オンラインドキュメント公開など、さまざまなビジネスシーンに適用できます。

本記事で紹介する方法には Free Spire.PDF for Python が必要です。pipでインストールできます：

pip install spire.pdf.free

1. ウィンドウ表示属性とUI要素の設定

PDFドキュメントのウィンドウ表示属性は、ドキュメントを開いたときのウィンドウ状態を決定します。これには、ウィンドウ位置、タイトル表示、ウィンドウサイズ適応、およびUI要素の表示制御が含まれます。

from spire.pdf.common import *
from spire.pdf import *

# PDFドキュメントを読み込む
input_file = "sample.pdf"
output_file = "output/window_preferences.pdf"

doc = PdfDocument(input_file)

# === ウィンドウ表示属性の設定 ===
doc.ViewerPreferences.CenterWindow = True      # ウィンドウを中央に表示
doc.ViewerPreferences.DisplayTitle = True      # ドキュメントタイトルを表示
doc.ViewerPreferences.FitWindow = True         # ウィンドウサイズをページに合わせる
# doc.ViewerPreferences.FitWindow = False      # ウィンドウを自動調整しない（上記とどちらか一方を選択）

# === UI要素の表示制御 ===
doc.ViewerPreferences.HideMenubar = False      # メニューバーを表示
doc.ViewerPreferences.HideToolbar = False      # ツールバーを表示
doc.ViewerPreferences.HideWindowUI = False     # ウィンドウUI要素（スクロールバーなど）を表示
# doc.ViewerPreferences.HideMenubar = True     # メニューバーを非表示（上記とどちらか一方を選択）
# doc.ViewerPreferences.HideToolbar = True     # ツールバーを非表示（上記とどちらか一方を選択）
# doc.ViewerPreferences.HideWindowUI = True    # ウィンドウUI要素を非表示（上記とどちらか一方を選択）

# ドキュメントを保存
doc.SaveToFile(output_file)
doc.Close()

効果のスクリーンショット：

PythonでPDF閲覧ウィンドウを設定

説明：

  • CenterWindow：True に設定すると、ドキュメントウィンドウが画面の中央で開きます。
  • DisplayTitle：True に設定すると、ウィンドウのタイトルバーにファイル名ではなくドキュメントタイトルが表示されます。
  • FitWindow：True に設定すると、ウィンドウサイズが自動的に最初のページのサイズに合わせて調整されます。
  • HideMenubar、HideToolbar、HideWindowUI：それぞれメニューバー、ツールバー、ウィンドウUI要素を非表示にするかどうかを制御します。

適用シーン：UI要素の保持は通常のドキュメントに適しています。UI要素の非表示は、プレゼンテーションや読書領域の最大化が必要な場面に適しています。

2. ページレイアウトと表示モードの設定

ページレイアウトモードは、ドキュメントを開いたときのページ表示方法を決定します。ページ表示モードは、表示されるコンテンツパネル（ブックマーク、サムネイルなど）を決定します。

from spire.pdf.common import *
from spire.pdf import *

# PDFドキュメントを読み込む
input_file = "sample.pdf"
output_file = "output/page_layout_mode.pdf"

doc = PdfDocument(input_file)

# === ページレイアウトモードの設定 ===
doc.ViewerPreferences.PageLayout = PdfPageLayout.OneColumn  # 単一列連続スクロール（最も一般的）
# doc.ViewerPreferences.PageLayout = PdfPageLayout.SinglePage      # 単一ページ表示
# doc.ViewerPreferences.PageLayout = PdfPageLayout.TwoColumnLeft   # 二列並列表示（奇数ページを左側）
# doc.ViewerPreferences.PageLayout = PdfPageLayout.TwoColumnRight  # 二列並列表示（奇数ページを右側）

# === ページ表示モードの設定 ===
doc.ViewerPreferences.PageMode = PdfPageMode.UseThumbs      # サムネイルパネルを表示
# doc.ViewerPreferences.PageMode = PdfPageMode.UseOC  # オプションコンテンツパネルを表示
# doc.ViewerPreferences.PageMode = PdfPageMode.FullScreen        # 全画面表示モード
# doc.ViewerPreferences.PageMode = PdfPageMode.UseAttachments     # 添付ファイルパネルを表示

# ドキュメントを保存
doc.SaveToFile(output_file)
doc.Close()

説明：

ページレイアウトモード：

  • SinglePage：一度に1ページのみ表示。逐頁読書や印刷プレビューに適しています。
  • OneColumn：ページが単一列で連続して配置され、垂直スクロールでの閲覧をサポート。最も一般的な読書モードです。
  • TwoColumnLeft / TwoColumnRight：二列並列表示。書籍や雑誌類のドキュメントに適しています。

ページ表示モード：

  • UseBookmarks：ブックマークパネルを表示。複数レベルの目次構造を含む技術文書に適しています。
  • UseThumbnails：ページサムネイルを表示。ページ数の多いドキュメントに適しています。
  • FullScreen：全画面モード。プレゼンテーション資料や研修教材に適しています。
  • UseAttachments：添付ファイルパネルを表示。補足資料を含むドキュメントに適しています。

3. ドキュメント開封時のズーム倍率の設定

ウィンドウやレイアウト設定に加え、ドキュメントを開いたときのズーム倍率を制御し、内容が適切な比率で表示されるようにすることもできます。

from spire.pdf.common import *
from spire.pdf import *

# PDFドキュメントを読み込む
input_file = "sample.pdf"
output_file = "output/set_zoom_factor.pdf"

doc = PdfDocument(input_file)

# 最初のページを取得
page = doc.Pages[0]

# PDFデスティネーションオブジェクトを作成
dest = PdfDestination(page)

# === ズームモードの設定（いずれか一つを選択） ===
# 方法1：固定ズーム倍率を設定
dest.Mode = PdfDestinationMode.Location
dest.Location = PointF(-40.0, -40.0)
dest.Zoom = 1.0  # 100% ズーム
# dest.Zoom = 0.8  # 80% ズーム
# dest.Zoom = 1.5  # 150% ズーム

# 方法2：ページ幅に合わせる（上記のコードをコメントアウトし、以下のコメントを外す）
# dest.Mode = PdfDestinationMode.FitH  # 水平幅に合わせる
# dest.Location = PointF(0.0, 0.0)

# 方法3：ページ高さに合わせる
# dest.Mode = PdfDestinationMode.FitV  # 垂直高さに合わせる
# dest.Location = PointF(0.0, 0.0)

# ジャンプアクションを作成し、ドキュメント開封時アクションとして設定
goto_action = PdfGoToAction(dest)
doc.AfterOpenAction = goto_action

# ドキュメントを保存
doc.SaveToFile(output_file)
doc.Close()

説明：

  • PdfDestinationMode.Location：位置モードで表示。ズーム倍率と組み合わせて使用します。
  • dest.Zoom：ズーム倍率を設定。1.0 は 100%、0.8 は 80%、1.5 は 150% を表します。
  • PdfDestinationMode.FitH：ページ幅をウィンドウ幅に合わせます。
  • PdfDestinationMode.FitV：ページ高さをウィンドウ高さに合わせます。

4. 既存ドキュメントの閲覧設定の取得

既存のドキュメントを処理する際、現在の閲覧設定をまず把握し、针对性的な調整を行う必要がある場合があります。

from spire.pdf.common import *
from spire.pdf import *

# PDFドキュメントを読み込む
input_file = "sample.pdf"
output_file = "output/viewer_preferences_info.txt"

doc = PdfDocument()
doc.LoadFromFile(input_file)

# 閲覧設定オブジェクトを取得
viewer = doc.ViewerPreferences

# 閲覧設定情報を収集
info = []
info.append("=== PDF ドキュメント閲覧設定情報 ===")
info.append("")
info.append("ウィンドウ表示設定：")
info.append(f"  ウィンドウ中央表示: {viewer.CenterWindow}")
info.append(f"  ドキュメントタイトル表示: {viewer.DisplayTitle}")
info.append(f"  ウィンドウページ適応: {viewer.FitWindow}")
info.append("")
info.append("UI要素表示：")
info.append(f"  メニューバー非表示: {viewer.HideMenubar}")
info.append(f"  ツールバー非表示: {viewer.HideToolbar}")
info.append(f"  ウィンドウUI非表示: {viewer.HideWindowUI}")
info.append("")
info.append("ページレイアウト設定：")
info.append(f"  ページレイアウトモード: {viewer.PageLayout}")
info.append(f"  ページ表示モード: {viewer.PageMode}")

# ズーム設定情報を取得
action = doc.AfterOpenAction
if action is not None and action.Destination is not None:
    zoom_value = action.Destination.Zoom
    zoom_percent = zoom_value * 100
    info.append("")
    info.append("ズーム設定：")
    info.append(f"  ドキュメント開封時のズーム倍率: {zoom_percent:.1f}%")
else:
    info.append("")
    info.append("ズーム設定：")
    info.append("  ドキュメントに特定の開封時ズーム倍率が設定されていません")

# 情報をテキストファイルに保存
with open(output_file, "w", encoding="utf-8") as f:
    f.write("\n".join(info))

print("閲覧設定情報を保存しました")

説明：

  • ViewerPreferences プロパティを通じて、ドキュメントのすべての閲覧設定を読み取ることができます。
  • AfterOpenAction：ドキュメント開封時に実行されるアクションを取得。ズーム設定の確認に使用します。
  • この方法は、既存ドキュメントの設定分析、ドキュメントが基準に適合しているかの一括チェックに使用できます。

5. 総合応用：標準化された企業ドキュメントの作成

実際のアプリケーションでは、通常複数の閲覧設定を総合的に設定し、企業基準に適合したドキュメントを作成する必要があります。

from spire.pdf.common import *
from spire.pdf import *

# PDFドキュメントを読み込む
input_file = "company_manual.pdf"
output_file = "output/standardized_manual.pdf"

doc = PdfDocument(input_file)

# === ウィンドウ表示設定 ===
doc.ViewerPreferences.CenterWindow = True      # ウィンドウ中央
doc.ViewerPreferences.DisplayTitle = True      # タイトル表示
doc.ViewerPreferences.FitWindow = False        # ウィンドウ自動調整なし

# === UI要素設定 ===
doc.ViewerPreferences.HideMenubar = False      # メニューバー表示
doc.ViewerPreferences.HideToolbar = False      # ツールバー表示
doc.ViewerPreferences.HideWindowUI = False     # UI要素表示

# === ページレイアウト設定 ===
doc.ViewerPreferences.PageLayout = PdfPageLayout.OneColumn  # 単一列連続スクロール

# === ページ表示モード ===
doc.ViewerPreferences.PageMode = PdfPageMode.UseOC  # オプションコンテンツパネル表示

# === ズーム設定 ===
page = doc.Pages[0]
dest = PdfDestination(page)
dest.Mode = PdfDestinationMode.Location
dest.Location = PointF(-40.0, -40.0)
dest.Zoom = 1.0  # 100% ズーム

goto_action = PdfGoToAction(dest)
doc.AfterOpenAction = goto_action

# 標準化後のドキュメントを保存
doc.SaveToFile(output_file)
doc.Close()

print("企業ドキュメントの標準化設定が完了しました")

説明：

この例は、企業ドキュメント標準化の典型的な設定を示しています：

  • ウィンドウ中央 + タイトル表示：プロフェッショナルな視覚体験を提供
  • UI要素の保持：ユーザーがリーダー機能を使用しやすい
  • 単一列連続スクロール + ブックマークパネル：迅速なナビゲーションと読書が可能
  • 100% ズーム：内容の明確な表示を保証

この設定は、企業マニュアル、技術文書、研修教材など、標準化配布が必要なドキュメントに適しています。

主要クラス・メソッド一覧表

参照の便宜上、本記事で使用した主なクラス、プロパティ、メソッドを以下に整理します。

クラス / プロパティ / メソッド 説明
PdfDocument PDFドキュメントオブジェクトを表し、ドキュメントの読み込みと保存に使用
ViewerPreferences ドキュメント閲覧設定オブジェクト
CenterWindow ブール値。ウィンドウを中央に表示するかどうかを設定
DisplayTitle ブール値。タイトルバーにドキュメントタイトルを表示するかどうかを設定
FitWindow ブール値。ウィンドウをページサイズに合わせるかどうかを設定
HideMenubar ブール値。メニューバーを非表示にするかどうかを設定
HideToolbar ブール値。ツールバーを非表示にするかどうかを設定
HideWindowUI ブール値。ウィンドウUI要素を非表示にするかどうかを設定
PageLayout ページレイアウトモード。値は PdfPageLayout 列挙型
PageMode ページ表示モード。値は PdfPageMode 列挙型
PdfPageLayout.SinglePage 単一ページ表示モード
PdfPageLayout.OneColumn 単一列連続スクロールモード
PdfPageLayout.TwoColumnLeft 二列並列表示モード（奇数ページを左側）
PdfPageMode.UseBookmarks ブックマークパネルを表示
PdfPageMode.UseThumbnails サムネイルパネルを表示
PdfPageMode.FullScreen 全画面表示モード
PdfPageMode.UseAttachments 添付ファイルパネルを表示
PdfDestination ドキュメントの目標位置と表示方法を定義
PdfDestinationMode.Location 指定位置とズーム倍率で表示
PdfDestinationMode.FitH ページ幅に合わせる
Zoom ズーム倍率。1.0 は 100% を表す
PdfGoToAction 指定目標へジャンプするアクション
AfterOpenAction ドキュメント開封後に実行されるアクション

まとめ

本記事の例を通じて、Pythonを使用してPDFドキュメントの閲覧設定をプログラム的に設定する方法を理解できました。ウィンドウ表示属性、UI要素制御から、ページレイアウトモード、表示モード設定、さらにズーム倍率調整まで、プロセス全体が高度に自動化されており、一括ドキュメント処理、企業ドキュメントの標準化、オンライン公開などのシーンに特に適しています。

各ドキュメントの読書オプションを手動で設定するのに比べ、コード方式には以下の利点があります：すべてのドキュメントに一貫した読書体験を保証、ドキュメント配布効率の向上、ユーザーの設定調整の手間を軽減、一括処理と標準化管理の容易化。これを基盤に、フォルダ内のすべてのPDFを一括処理、ドキュメントタイプに応じて異なる閲覧設定テンプレートを適用、ドキュメント管理システムに統合して自動化処理を実現するなど、さらなる機能を拡張できます。

大量のPDFドキュメントを処理している場合、または企業レベルのドキュメント標準化フローを確立する必要がある場合、このPythonベースのソリューションが作業の大幅な向上をもたらします。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?