(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
前回(第0回)では、CAD図面PDFの部屋名をExcelへ自動転記するWindows向けツールの要件整理と、Python環境・tkinterの最初のウィンドウ、PDF・Excelファイルを選ぶダイアログの土台を作りました。ただしこの時点では、選んだPDFの中身はまだ画面に何も表示されません。
第1回の今回は、選んだPDFの図面ページを、実際に画面上へプレビュー表示するところまで進めます。部屋名を自動で読み取る処理はまだ入りませんが、「どのページに何が書かれているか」を人が目で確認できるようになる、この連載で最初の目に見える一歩です。
今回作る機能と完成イメージ
今回できるようになることは次の2つです。
- PDFを選ぶと、1ページ目の図面が画像としてウィンドウ内に表示される
- 「前のページ/次のページ」ボタンでページ送り、「拡大/縮小」ボタンで表示倍率を変更できる
部屋名らしき文字を検出してハイライトする処理は次回(第2回)以降です。今回はあくまで「人の目で図面を確認できる土台」を作ります。
仕組みの説明:PDFをどうやって画面に映すか
CAD図面のPDFは、多くの場合「線や文字の座標データ(ベクターデータ)」として保存されています。これは拡大しても輪郭がぼやけない一方で、tkinterの画面にそのまま貼り付けることはできません。画面に表示するには、一度「縦横に並んだ色の点(ピクセル)の集まり」であるラスタ画像に変換する必要があります。
| 用語 | かんたんな意味 |
|---|---|
| ベクターデータ | 線・文字を座標や数式として持つデータ形式。拡大してもぼやけない |
| ラスタ画像 | 縦横に並んだ色の点(ピクセル)の集まり。写真やスクリーンショットと同じ形式 |
| dpi(dots per inch) | 1インチ(約2.54cm)あたり何個の点で描くか。数値が大きいほど精細だがデータ量も増える |
| Pixmap | PyMuPDFがページをラスタ画像化した結果を表すオブジェクト |
| PPM形式 | ラスタ画像の保存形式の一つ。tkinterが追加ライブラリなしで直接読み込める |
今回実装した処理の流れは次のとおりです。
- PyMuPDF(
import fitz)でPDFファイルを開く。開けない(壊れている)場合はエラーとして扱う - 指定したページを、指定した解像度(dpi)と拡大率でラスタ画像(
Pixmap)に変換する。PyMuPDFのget_pixmap()はMatrixという行列で変換の詳細を指定でき、dpi ÷ 72 × 拡大率をスケール値として渡すと「基準解像度に拡大率をかけた」画像が得られます(PDFの座標系は1インチ=72ptが基準のため72で割ります) Pixmapをtobytes("ppm")でPPM形式のバイト列に変換する。PPMはtkinter標準のPhotoImageがそのまま読み込める形式なので、Pillow等の追加ライブラリを増やさずに済みます(exe化して配布する前提のため、依存ライブラリはできるだけ絞っています)- tkinterの
Canvasに画像を貼り付け、スクロール領域を画像サイズに合わせる
この処理のうち、1〜3はGUIに一切関係しない「コア処理」として実装し、4だけがGUI(tkinter)に依存する部分です。第0回で決めた「app/core/はGUIに依存させず、pytestで自動検証する」という設計方針を、今回も踏襲しています。
実装
ファイル構成(第1回時点の差分)
madori-ocr/
├ app/
│ ├ main.py
│ ├ core/
│ │ ├ file_selection.py … (第0回)選択ファイルの検証
│ │ └ pdf_loader.py … 【今回追加】PDFを開き、ページを画像化する
│ └ ui/
│ ├ main_window.py … 【今回変更】プレビュー部品を組み込む
│ └ preview_canvas.py … 【今回追加】プレビュー表示部品(tkinter Canvas)
├ tests/
│ ├ test_file_selection.py
│ └ test_pdf_loader.py … 【今回追加】
├ tools/
│ └ make_sample_pdf.py … 【今回追加】動作確認用の架空サンプル図面PDFを作る
├ requirements.txt … 【今回変更】PyMuPDF==1.26.7 を追加
├ pytest.ini
└ .gitignore
コア処理:PDFを開いてページを画像化する(app/core/pdf_loader.py)
fitz(PyMuPDF)だけに依存し、tkinterはimportしません。ファイルを開くところと、1ページを画像化するところの2つが主な役割です。
app/core/pdf_loader.py を新しく作ります(全文)。
app/core/pdf_loader.py の全文(139行)
# app/core/pdf_loader.py
"""CAD図面PDFを開き、ページをプレビュー用の画像に変換するコア処理。
PyMuPDF(`import fitz`)だけに依存し、tkinterなどのGUIライブラリはimportしない
(GUI非依存のロジックはpytestで自動検証する、という連載の方針による)。
プレビュー表示(`app/ui/preview_canvas.py`)は、ここで作った `RenderedPage.ppm_bytes`
を `tkinter.PhotoImage(data=...)` にそのまま渡すだけで画像を表示できる。PPM形式は
tkinterのPhotoImageが標準で読めるため、Pillow等の追加ライブラリを増やさずに済む。
"""
from __future__ import annotations
from dataclasses import dataclass
from pathlib import Path
from types import TracebackType
import fitz
#: プレビュー表示の基準解像度(150dpi程度あれば画面表示用途では十分な精細さになる)。
DEFAULT_DPI = 150
#: 拡大縮小として受け付ける倍率の範囲。上限を設けないと極端な拡大でメモリを消費しすぎる。
MIN_ZOOM = 0.25
MAX_ZOOM = 4.0
class PdfLoadError(ValueError):
"""PDFを開けない、またはページ番号・拡大率が範囲外の場合に送出する例外。"""
@dataclass(frozen=True)
class RenderedPage:
"""PDFの1ページを画像化した結果。"""
#: 0始まりのページ番号
page_number: int
#: 画像の横幅(ピクセル)
width: int
#: 画像の縦幅(ピクセル)
height: int
#: 画像化に使った基準解像度(dpi)
dpi: int
#: 画像化に使った拡大率(1.0が等倍)
zoom: float
#: PPM(P6)形式の画像データ。`tkinter.PhotoImage(data=...)` にそのまま渡せる。
ppm_bytes: bytes
class PdfDocument:
"""PyMuPDFで開いたPDFドキュメントの薄いラッパー。
`with PdfDocument(path) as doc:` の形で使うと、ブロックを抜けたときに
確実にファイルハンドルを閉じられる。
"""
def __init__(self, path: str | Path) -> None:
resolved = Path(path)
if not resolved.exists():
raise PdfLoadError(f"ファイルが見つかりません: {resolved}")
if not resolved.is_file():
raise PdfLoadError(f"フォルダではなくファイルを指定してください: {resolved}")
try:
document = fitz.open(resolved)
except Exception as exc: # PyMuPDFは壊れたPDFに対し様々な例外を送出しうるため広く受ける
raise PdfLoadError(f"PDFとして開けませんでした(破損している可能性があります): {resolved}") from exc
if document.page_count == 0:
document.close()
raise PdfLoadError(f"ページが1枚もないPDFです: {resolved}")
self._document = document
self._path = resolved
@property
def path(self) -> Path:
"""開いているPDFファイルのパス。"""
return self._path
@property
def page_count(self) -> int:
"""PDFの総ページ数。"""
return self._document.page_count
def render_page(self, page_number: int, *, zoom: float = 1.0, dpi: int = DEFAULT_DPI) -> RenderedPage:
"""指定ページを画像化して `RenderedPage` を返す。
`zoom` はページ送り後にユーザーが行う拡大縮小操作の倍率(1.0が等倍)。
`dpi` はプレビューの基準解像度で、通常は既定値のまま使う想定。
"""
if not 0 <= page_number < self.page_count:
raise PdfLoadError(
f"ページ番号が範囲外です: {page_number}"
f"(0〜{self.page_count - 1}の範囲で指定してください)"
)
if not MIN_ZOOM <= zoom <= MAX_ZOOM:
raise PdfLoadError(f"拡大率は{MIN_ZOOM}〜{MAX_ZOOM}の範囲で指定してください: {zoom}")
if dpi <= 0:
raise PdfLoadError(f"dpiは正の値で指定してください: {dpi}")
page = self._document.load_page(page_number)
scale = (dpi / 72.0) * zoom
matrix = fitz.Matrix(scale, scale)
pixmap = page.get_pixmap(matrix=matrix, colorspace=fitz.csRGB, alpha=False)
return RenderedPage(
page_number=page_number,
width=pixmap.width,
height=pixmap.height,
dpi=dpi,
zoom=zoom,
ppm_bytes=pixmap.tobytes("ppm"),
)
def close(self) -> None:
"""PDFファイルハンドルを閉じる。"""
self._document.close()
def __enter__(self) -> PdfDocument:
return self
def __exit__(
self,
exc_type: type[BaseException] | None,
exc: BaseException | None,
traceback: TracebackType | None,
) -> None:
self.close()
def load_pdf(path: str | Path) -> PdfDocument:
"""PDFファイルを開いて `PdfDocument` を返す。
ファイル自体の存在・拡張子確認は `app/core/file_selection.py` の
`validate_pdf_path` で先に行われている前提だが、このモジュール単体で
使われた場合にも安全なように、存在確認とPDFとして開けるかの確認を
ここでも行う。
"""
return PdfDocument(path)
拡大率(zoom)に0.25〜4.0という上限・下限を設けているのは、極端な拡大を許すとメモリ消費が急激に増え、古い図面PDF(大判用紙をスキャンしたものなど)でアプリが固まりかねないためです。壊れたPDFを開こうとした場合も、PyMuPDFが送出する内部例外をそのまま画面に見せず、PdfLoadErrorという連載共通の例外に変換してから呼び出し側(画面)に伝えています。
GUI部品:プレビュー表示(app/ui/preview_canvas.py)
ページ送り・拡大縮小のボタンと、画像を表示するCanvasをまとめた部品です。PdfDocument.render_page()が返したRenderedPage.ppm_bytesを、そのままtkinter.PhotoImageに渡しています。
app/ui/preview_canvas.py を新しく作ります(全文)。
app/ui/preview_canvas.py の全文(152行)
# app/ui/preview_canvas.py
"""図面PDFのプレビュー表示部品(tkinter Canvas)。
`app/core/pdf_loader.py` の `PdfDocument.render_page()` が返す `RenderedPage`
(PPM形式の画像データ)を `tkinter.PhotoImage` に変換してCanvasへ描画する。
ページ送り・拡大縮小の操作もこの部品の中に閉じ込め、呼び出し側
(`app/ui/main_window.py`)は `PreviewCanvas.load_pdf(path)` を呼ぶだけで
使えるようにする。
このモジュール自体はtkinterに依存するため、pytestでの自動検証はしない
(連載の方針:GUIはWindows実機で確認する)。表示対象の画像を作るロジックは
`app/core/pdf_loader.py` に切り出してあり、そちらはpytestで検証済み。
"""
from __future__ import annotations
import tkinter as tk
from pathlib import Path
from tkinter import ttk
from app.core.pdf_loader import MAX_ZOOM, MIN_ZOOM, PdfDocument, PdfLoadError, load_pdf
#: 拡大縮小ボタン1回あたりの倍率の増減幅
ZOOM_STEP = 0.25
class PreviewCanvas(ttk.Frame):
"""PDFのページ画像を表示し、ページ送り・拡大縮小を行う部品。"""
def __init__(self, master: tk.Widget) -> None:
super().__init__(master)
self._document: PdfDocument | None = None
self._page_number = 0
self._zoom = 1.0
# PhotoImageはGC対象になるとCanvas上から消えてしまうため、参照を保持し続ける
self._photo_image: tk.PhotoImage | None = None
self._build_widgets()
self._refresh_controls()
def _build_widgets(self) -> None:
toolbar = ttk.Frame(self)
toolbar.pack(fill="x")
self.prev_button = ttk.Button(toolbar, text="◀ 前のページ", command=self._on_prev_page)
self.prev_button.pack(side="left")
self.page_label_var = tk.StringVar(value="ページ: -/-")
ttk.Label(toolbar, textvariable=self.page_label_var).pack(side="left", padx=8)
self.next_button = ttk.Button(toolbar, text="次のページ ▶", command=self._on_next_page)
self.next_button.pack(side="left")
self.zoom_out_button = ttk.Button(toolbar, text="縮小 -", command=self._on_zoom_out)
self.zoom_out_button.pack(side="left", padx=(16, 0))
self.zoom_label_var = tk.StringVar(value="100%")
ttk.Label(toolbar, textvariable=self.zoom_label_var).pack(side="left", padx=8)
self.zoom_in_button = ttk.Button(toolbar, text="拡大 +", command=self._on_zoom_in)
self.zoom_in_button.pack(side="left")
canvas_frame = ttk.Frame(self)
canvas_frame.pack(fill="both", expand=True)
canvas_frame.rowconfigure(0, weight=1)
canvas_frame.columnconfigure(0, weight=1)
self.canvas = tk.Canvas(canvas_frame, background="#dddddd")
h_scroll = ttk.Scrollbar(canvas_frame, orient="horizontal", command=self.canvas.xview)
v_scroll = ttk.Scrollbar(canvas_frame, orient="vertical", command=self.canvas.yview)
self.canvas.configure(xscrollcommand=h_scroll.set, yscrollcommand=v_scroll.set)
self.canvas.grid(row=0, column=0, sticky="nsew")
v_scroll.grid(row=0, column=1, sticky="ns")
h_scroll.grid(row=1, column=0, sticky="ew")
def load_pdf(self, path: str | Path) -> None:
"""PDFファイルを開いて1ページ目を表示する。
既に別のPDFを表示中だった場合は、先にそのファイルハンドルを閉じる。
`PdfLoadError` は呼び出し側(メイン画面)でメッセージダイアログとして
表示する想定のため、ここでは捕まえずに送出する。
"""
self._close_current_document()
self._document = load_pdf(path)
self._page_number = 0
self._zoom = 1.0
self._render_current_page()
def _close_current_document(self) -> None:
if self._document is not None:
self._document.close()
self._document = None
def _on_prev_page(self) -> None:
if self._document is None or self._page_number <= 0:
return
self._page_number -= 1
self._render_current_page()
def _on_next_page(self) -> None:
if self._document is None or self._page_number >= self._document.page_count - 1:
return
self._page_number += 1
self._render_current_page()
def _on_zoom_in(self) -> None:
self._set_zoom(self._zoom + ZOOM_STEP)
def _on_zoom_out(self) -> None:
self._set_zoom(self._zoom - ZOOM_STEP)
def _set_zoom(self, zoom: float) -> None:
if self._document is None:
return
clamped = max(MIN_ZOOM, min(MAX_ZOOM, round(zoom, 2)))
if clamped == self._zoom:
return
self._zoom = clamped
self._render_current_page()
def _render_current_page(self) -> None:
if self._document is None:
self._refresh_controls()
return
try:
rendered = self._document.render_page(self._page_number, zoom=self._zoom)
except PdfLoadError:
self._refresh_controls()
raise
self._photo_image = tk.PhotoImage(data=rendered.ppm_bytes, format="ppm")
self.canvas.delete("all")
self.canvas.create_image(0, 0, anchor="nw", image=self._photo_image)
self.canvas.configure(scrollregion=(0, 0, rendered.width, rendered.height))
self._refresh_controls()
def _refresh_controls(self) -> None:
if self._document is None:
self.page_label_var.set("ページ: -/-")
self.zoom_label_var.set("-")
for button in (self.prev_button, self.next_button, self.zoom_in_button, self.zoom_out_button):
button.configure(state="disabled")
return
page_count = self._document.page_count
self.page_label_var.set(f"ページ: {self._page_number + 1}/{page_count}")
self.zoom_label_var.set(f"{round(self._zoom * 100)}%")
self.prev_button.configure(state="normal" if self._page_number > 0 else "disabled")
self.next_button.configure(state="normal" if self._page_number < page_count - 1 else "disabled")
self.zoom_out_button.configure(state="normal" if self._zoom - ZOOM_STEP >= MIN_ZOOM else "disabled")
self.zoom_in_button.configure(state="normal" if self._zoom + ZOOM_STEP <= MAX_ZOOM else "disabled")
self._photo_imageをインスタンス変数として保持しているのが地味に重要なポイントです。tkinterのPhotoImageはPythonのガベージコレクション(不要になったオブジェクトの自動破棄)の対象になるため、ローカル変数に入れただけだとメソッドを抜けた瞬間に画像がCanvas上から消えてしまうことがあります。実際、最初の実装ではこの参照保持を忘れて「一瞬だけ表示されてすぐ消える」現象にはまりました(後述のつまずきポイントでも触れます)。
ページ送り・拡大縮小ボタンは、page_numberとzoomの範囲チェックを画面側でも行い、範囲外のときはボタン自体を無効化(state="disabled")しています。
メイン画面への配線(app/ui/main_window.py)
第0回で作った「PDFを選ぶ」ボタンの処理に、プレビューへの読み込みを追加しました。
app/ui/main_window.py に次の変更を加えます(+ が追加、- が削除)。
--- a/app/ui/main_window.py
+++ b/app/ui/main_window.py
@@ -1,9 +1,9 @@
# app/ui/main_window.py
-"""メイン画面(PDF選択・Excelテンプレート選択・実行ボタン)。
+"""メイン画面(PDF選択・Excelテンプレート選択・実行ボタン・図面プレビュー)。
-第0回では「ファイルを選ぶ」「選んだパスを保持する」ところまでを実装する。
-選んだファイルの検証は `app/core/file_selection.py`(tkinterに依存しないコア処理)に任せ、
-この画面はボタン・ラベルの配置と、検証結果の表示だけを受け持つ。
+第0回で「ファイルを選ぶ」「選んだパスを保持する」ところまでを実装した。
+第1回では、選んだPDFの図面ページを画面上にプレビュー表示する
+`app/ui/preview_canvas.py` をここから呼び出すように配線した。
"""
from __future__ import annotations
@@ -12,9 +12,11 @@ import tkinter as tk
from tkinter import filedialog, messagebox, ttk
from app.core.file_selection import FileSelectionError, SelectedFiles, validate_excel_path, validate_pdf_path
+from app.core.pdf_loader import PdfLoadError
+from app.ui.preview_canvas import PreviewCanvas
WINDOW_TITLE = "間取りOCR転記ツール"
-WINDOW_SIZE = "640x260"
+WINDOW_SIZE = "760x640"
PDF_FILETYPES = [("PDFファイル", "*.pdf")]
EXCEL_FILETYPES = [("Excelファイル", "*.xlsx *.xlsm")]
@@ -36,6 +38,7 @@ class MainWindow(ttk.Frame):
def _build_widgets(self) -> None:
self.columnconfigure(0, weight=1)
+ self.rowconfigure(6, weight=1)
ttk.Label(self, text="1. CAD図面PDFを選択").grid(row=0, column=0, sticky="w")
ttk.Button(self, text="PDFを選ぶ...", command=self._on_choose_pdf).grid(row=0, column=1, padx=8)
@@ -58,6 +61,10 @@ class MainWindow(ttk.Frame):
row=5, column=0, columnspan=2, sticky="w"
)
+ ttk.Label(self, text="図面プレビュー").grid(row=6, column=0, sticky="nw", pady=(12, 0))
+ self.preview = PreviewCanvas(self)
+ self.preview.grid(row=6, column=0, columnspan=2, sticky="nsew", pady=(28, 0))
+
def _on_choose_pdf(self) -> None:
path = filedialog.askopenfilename(title="CAD図面PDFを選択", filetypes=PDF_FILETYPES)
if not path:
@@ -67,6 +74,11 @@ class MainWindow(ttk.Frame):
except FileSelectionError as exc:
messagebox.showerror("ファイル選択エラー", str(exc))
return
+ try:
+ self.preview.load_pdf(validated)
+ except PdfLoadError as exc:
+ messagebox.showerror("PDF読み込みエラー", str(exc))
+ return
self.selected = self.selected.with_pdf(validated)
self.pdf_path_var.set(str(validated))
self._refresh_run_button()
「拡張子は.pdfだが中身が壊れている」ファイルの場合、validate_pdf_path(第0回の拡張子・存在チェック)は通過しますが、preview.load_pdf()内でPyMuPDFが実際に開こうとしてPdfLoadErrorが送出されるので、それをここで捕まえてエラーダイアログを出す二段構えにしています。
requirements.txtへの追加
requirements.txt に次の変更を加えます(+ が追加、- が削除)。
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,3 +5,6 @@
pytest==9.0.2
ruff==0.14.11
+
+# 第1回〜:PDFのページ画像化・ベクター文字抽出(import fitz)
+PyMuPDF==1.26.7
パッケージを入れます(pip install -r requirements.txt でも同じものが入ります)。
pip install PyMuPDF==1.26.7
pip index versions pymupdfで、このバージョンが記事の公開日(2026年1月)時点で存在することを確認しています(PyPIのパッケージ情報によると、1.26.7の公開日は2025年12月11日です)。
テストと架空のサンプル図面(tests/test_pdf_loader.py・tools/make_sample_pdf.py)
app/core/pdf_loader.py のテストです。テスト用のPDFは、PyMuPDFで文字を描いてその場で作ります。
tests/test_pdf_loader.py を新しく作ります(全文)。
tests/test_pdf_loader.py の全文(154行)
# tests/test_pdf_loader.py
"""`app.core.pdf_loader` のユニットテスト(tkinter非依存)。
テスト用のサンプルPDFは、実在の図面ではなく、PyMuPDF自体でテキストを
描画してその場で生成する(架空のサンプル)。
"""
from __future__ import annotations
from pathlib import Path
import fitz
import pytest
from app.core.pdf_loader import DEFAULT_DPI, PdfDocument, PdfLoadError, load_pdf
#: テスト用サンプルPDFのページサイズ(A4縦・ポイント単位)。
A4_WIDTH_PT = 595.0
A4_HEIGHT_PT = 842.0
def _make_sample_pdf(path: Path, page_count: int = 1) -> Path:
"""「寝室1」等の部屋名らしき文字を描画したA4サイズのサンプルPDFを生成する。"""
document = fitz.open()
for i in range(page_count):
page = document.new_page(width=A4_WIDTH_PT, height=A4_HEIGHT_PT)
page.insert_text((72, 72), f"寝室{i + 1}", fontsize=14)
document.save(path)
document.close()
return path
def test_load_pdf_reports_page_count(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf", page_count=1)
with load_pdf(pdf_path) as document:
assert document.page_count == 1
assert document.path == pdf_path
def test_load_pdf_reports_multi_page_count(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "multi.pdf", page_count=3)
with load_pdf(pdf_path) as document:
assert document.page_count == 3
def test_load_pdf_missing_file_raises(tmp_path: Path) -> None:
with pytest.raises(PdfLoadError):
load_pdf(tmp_path / "missing.pdf")
def test_load_pdf_rejects_directory(tmp_path: Path) -> None:
directory = tmp_path / "folder.pdf"
directory.mkdir()
with pytest.raises(PdfLoadError):
load_pdf(directory)
def test_load_pdf_rejects_broken_content(tmp_path: Path) -> None:
broken = tmp_path / "broken.pdf"
broken.write_bytes(b"this is not a real pdf file")
with pytest.raises(PdfLoadError):
load_pdf(broken)
def test_render_page_size_matches_default_dpi(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
rendered = document.render_page(0)
expected_width = round(A4_WIDTH_PT * DEFAULT_DPI / 72.0)
expected_height = round(A4_HEIGHT_PT * DEFAULT_DPI / 72.0)
# PyMuPDFの内部丸めにより±1px程度の差が出ることがあるため許容範囲で比較する
assert abs(rendered.width - expected_width) <= 1
assert abs(rendered.height - expected_height) <= 1
assert rendered.page_number == 0
assert rendered.dpi == DEFAULT_DPI
assert rendered.zoom == 1.0
def test_render_page_zoom_scales_dimensions(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
base = document.render_page(0, zoom=1.0)
doubled = document.render_page(0, zoom=2.0)
# 拡大率2.0では、幅・高さともにおよそ2倍になる
assert abs(doubled.width - base.width * 2) <= 2
assert abs(doubled.height - base.height * 2) <= 2
def test_render_page_returns_valid_ppm_header(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
rendered = document.render_page(0)
# PPM(P6)形式のヘッダーに、画像化結果の幅・高さが含まれることを確認する
# (tkinter.PhotoImage(data=...) にそのまま渡せる形式であることの確認)
header = rendered.ppm_bytes.split(b"\n", 3)
assert header[0] == b"P6"
assert header[1] == f"{rendered.width} {rendered.height}".encode()
def test_render_page_out_of_range_raises(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf", page_count=1)
with load_pdf(pdf_path) as document:
with pytest.raises(PdfLoadError):
document.render_page(1)
with pytest.raises(PdfLoadError):
document.render_page(-1)
def test_render_page_rejects_zoom_out_of_range(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
with pytest.raises(PdfLoadError):
document.render_page(0, zoom=0.01)
with pytest.raises(PdfLoadError):
document.render_page(0, zoom=100.0)
def test_render_page_rejects_non_positive_dpi(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
with pytest.raises(PdfLoadError):
document.render_page(0, dpi=0)
def test_context_manager_closes_document(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
with load_pdf(pdf_path) as document:
inner = document._document # noqa: SLF001 - クローズ確認のためテストのみ内部属性を参照
with pytest.raises(ValueError):
inner.page_count # closeされているとPyMuPDFがValueErrorを送出する
def test_pdf_document_direct_construction(tmp_path: Path) -> None:
pdf_path = _make_sample_pdf(tmp_path / "single.pdf")
document = PdfDocument(pdf_path)
try:
assert document.page_count == 1
finally:
document.close()
画面で試すための架空のサンプル図面PDF(2ページ。「居間」「寝室1」などの文字を描いたもの)を作るスクリプトです。第2回以降の動作確認でも使います。
tools/make_sample_pdf.py を新しく作ります(全文)。
# tools/make_sample_pdf.py
"""スクリーンショット撮影用の架空サンプル間取りPDFを生成するスクリプト。
実在の物件・図面ではない、部屋名らしき文字列(「居間」「寝室1」など)を
PyMuPDF自身で描画しただけのテスト用PDF。日本語は組み込みCJKフォント
(`fontname="japan"`)で描いている。
使い方:
python3 make_sample_pdf.py <出力先.pdf>
"""
from __future__ import annotations
import fitz
JAPANESE_FONT = "japan"
def build_sample_pdf(path: str) -> None:
doc = fitz.open()
page0 = doc.new_page(width=595, height=842) # A4相当(架空の間取り図・1階)
page0.draw_rect(fitz.Rect(72, 72, 500, 500), color=(0, 0, 0), width=1.5)
page0.draw_line((286, 72), (286, 500), color=(0, 0, 0), width=1)
page0.draw_line((72, 300), (500, 300), color=(0, 0, 0), width=1)
page0.insert_text((100, 130), "居間", fontsize=16, fontname=JAPANESE_FONT)
page0.insert_text((100, 160), "W=3640", fontsize=8)
page0.insert_text((320, 130), "寝室1", fontsize=16, fontname=JAPANESE_FONT)
page0.insert_text((100, 340), "キッチン", fontsize=16, fontname=JAPANESE_FONT)
page0.insert_text((320, 340), "洗面所", fontsize=16, fontname=JAPANESE_FONT)
page0.insert_text((72, 40), "架空サンプル図面 1階(スクリーンショット確認用)", fontsize=10, fontname=JAPANESE_FONT)
page1 = doc.new_page(width=595, height=842)
page1.draw_rect(fitz.Rect(72, 72, 500, 500), color=(0, 0, 0), width=1.5)
page1.draw_line((72, 300), (500, 300), color=(0, 0, 0), width=1)
page1.insert_text((100, 130), "寝室2", fontsize=16, fontname=JAPANESE_FONT)
page1.insert_text((320, 130), "洋室3", fontsize=16, fontname=JAPANESE_FONT)
page1.insert_text((100, 340), "バルコニー", fontsize=16, fontname=JAPANESE_FONT)
page1.insert_text((72, 40), "架空サンプル図面 2階(スクリーンショット確認用)", fontsize=10, fontname=JAPANESE_FONT)
doc.save(path)
doc.close()
if __name__ == "__main__":
import argparse
parser = argparse.ArgumentParser(description="架空サンプル間取りPDFを生成する")
parser.add_argument("output", help="出力先のPDFパス")
args = parser.parse_args()
build_sample_pdf(args.output)
print(f"サンプルPDFを作成しました: {args.output}")
動かしてみる
python tools/make_sample_pdf.py sample.pdf
pytest
ruff check .
python -m app.main
pytest で「23 passed」と表示されれば完了です。アプリを起動して「PDFを選ぶ…」で sample.pdf を選ぶと、1ページ目がプレビューに表示され、ページ送り・拡大縮小のボタンが使えるようになります。
動作確認の方法
Linux開発環境で確認できたことと、Windows実機での確認が必要なことを分けて書きます。
Linux開発環境で確認できたこと
pytest:合計23件(うちapp/core/pdf_loader.py向けが13件)がすべて成功。ページ数取得、画像化した際の幅・高さがdpi・拡大率の計算どおりか(PyMuPDFの内部丸めによる±1〜2px程度の誤差は許容)、ページ番号・拡大率が範囲外のときにエラーになるか、壊れたPDFやフォルダを渡したときにエラーになるか、with文を抜けたときにファイルハンドルが閉じられているかを検証しています。テスト用PDFは実在の図面ではなく、PyMuPDF自身で「寝室1」のような文字を描画してその場で生成した架空のサンプルですruff check .:エラーなし- ヘッドレス起動確認:tkinterとPyMuPDFの両方が使えるPython環境(このLinux環境には既定でtkinterが無いため、
python3.12 -m venv --system-site-packagesで作った環境にPyMuPDFを追加インストールしたもの)で、Xvfb上にウィンドウを生成し、2ページのサンプルPDFをpreview.load_pdf()で読み込ませて、ページラベルが「1/2」→「2/2」に変わること、表示倍率のラベルが100%→125%→75%と変わること、前後ページ・拡大縮小の上限/下限でボタンが無効化されることを確認しました。例外は一切発生していません
実際に架空のサンプルPDF(「居間」「寝室1」などの文字を描いた2ページのテスト用PDF)を「PDFを選ぶ…」ボタンから読み込ませた画面は次のとおりです。1ページ目がプレビューに表示され、ページ送り・拡大縮小のボタンが有効になっています。

※これは開発環境(Linux/Xvfb上・Ubuntu標準のTkテーマ)で確認した画面です。Windows実機ではウィンドウの装飾や既定フォントなど見た目が異なります。また、この画像は第3回の時点で撮り直したもので、「3.」「4.」のボタンは第2回・第3回で追加します(第1回のコードでは表示されません)。
Windows実機での確認が必要なこと(このリポジトリでは未確認)
- 実際の画面上で図面画像が正しく(欠けたり色化けしたりせず)表示されるか
- マウスでのボタンクリック操作、スクロールバーの操作感
- 大判図面(A1・A2サイズなど)や複数ページのPDFを開いたときの表示速度・メモリ使用量
- 高DPIディスプレイでの見え方
上記のヘッドレス確認は「例外を出さずに、期待どおりの状態遷移(ページ番号・拡大率の表示、ボタンの有効/無効)が起きる」ことの確認であり、「実際に目で見て図面が正しく見える」ことの確認ではありません。この区別は第0回から一貫して意識している点です。
つまずきやすい点・セキュリティ上の注意
- PyMuPDFのライセンス(AGPL-3.0):第0回でも触れましたが、PyMuPDFはAGPL-3.0(GNU Affero General Public License)と、Artifex社の商用ライセンスのデュアルライセンスで提供されています。自社の内製ツールとして社内だけで使う分には基本的に問題になりませんが、このツールを他社へ配布・販売する場合は必ずライセンス条件を確認してください。 「配布先にソースコードの入手手段を提供する義務」が生じる可能性があるため、配布形態が固まった段階で法務・知財に確認を挟むことをおすすめします。条件が合わない場合の代替案として、Apache-2.0ライセンスの
pypdfium2(Google PDFiumのPythonラッパー)も選択肢にあります。 PhotoImageの参照保持忘れ:前述のとおり、tkinter.PhotoImageをローカル変数だけに入れておくと、ガベージコレクションで画像が消えてCanvasが真っ白になることがあります。インスタンス変数として保持し続けるのを忘れないようにしてください。- 拡大率・解像度の上限:
MAX_ZOOM(4.0倍)や基準dpi(150)を大きくしすぎると、1ページあたりの画像データが数十MB単位になることがあります。特にA1・A2サイズの大判図面では、上限を設けずに拡大を許可すると動作が重くなったりメモリ不足になったりする可能性があるため、上限値は実際の対象図面のサイズを見てから調整するのが安全です。 - 図面ファイルの取り扱い:図面PDFには顧客の建物情報が含まれることがあります。この連載のサンプルコード・記事では、実在の図面ではなくPyMuPDFで生成した架空のテスト用PDFのみを使っています。実際の開発では、テストデータにも社内の情報管理ルールを適用してください。
発注者向けメモ
この回で確認しておきたいこと・工数の勘所
図面PDFは1ファイルに複数ページ(各階の平面図、詳細図、凡例ページなど)が混ざっていることが少なくありません。「どのページの、どの部屋名を、Excelのどの欄に転記するのか」という対応関係は、開発が進んでから発覚する例外事項になりがちです。プレビュー機能ができた今の段階で、対象図面を何パターンか用意し、ページ構成を開発会社とすり合わせておくと、後の工程(文字抽出・部屋名判定)での手戻りを減らせます。
また、PDFをその場で高解像度画像に変換する処理は、ページ数やサイズによって処理時間・メモリ使用量が変わります。「複数ページ・大判サイズの図面が多い」という前提があるなら、早い段階で開発会社に伝えておくとよいでしょう。
- ☐ 対象図面が何ページ構成か(1ファイル1ページか、複数ページが混在するか)を確認したか
- ☐ 各ページのおおよそのサイズ(A3・A2・A1など)を確認したか
- ☐ 図面を外部に出す予定がある場合、含まれる建物情報の機密度を確認したか
- ☐ プレビュー画面に求める操作感(マウスホイールでの拡大縮小、ドラッグでの移動など)の希望があれば伝えたか
開発会社への質問例
- 「今回のプレビュー機能で使っているPDFの画像化ライブラリのライセンス(AGPL-3.0)は、将来ツールを他社へ配布する場合に問題になりませんか?」
- 「大判サイズの図面や、ページ数の多いPDFを開いたときの表示速度は、どの程度まで許容できる設計にしていますか?」
- 「拡大率や表示解像度の上限は、どういう基準で決めていますか?」
これらの質問は、今回作った「プレビュー」という一見地味な機能が、実は後続の文字抽出・OCR処理の土台になり、かつライセンス・パフォーマンスの両面で判断が必要な機能であることを確認するためのものです。
まとめと次回予告
第1回では、PyMuPDFでPDFのページを高解像度画像に変換するapp/core/pdf_loader.pyと、それをtkinterのCanvasに表示してページ送り・拡大縮小を行うapp/ui/preview_canvas.pyを実装し、第0回で作ったメイン画面から呼び出せるように配線しました。コア処理(PDFの画像化)は引き続きGUIに依存しない形で実装し、pytestで自動検証できる状態を保っています。
次回(第2回)は、いよいよ図面に埋め込まれた文字を読み取ります。PyMuPDFのget_text("dict")で座標・フォントサイズ付きの単語を取得し、検出した文字の枠を今回作ったプレビュー画面の上に重ねて表示します。CAD由来のPDFは文字が最初から埋め込まれていることが多く、その場合はOCRより速く正確に部屋名候補を拾えます。
この連載の記事一覧
この記事は連載「CAD図面PDFをExcelへ自動転記するツール開発」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【CAD図面PDFをExcelへ自動転記するツール開発 第0回】要件整理とPython開発環境、tkinterの最初の画面を作る
- 【CAD図面PDFをExcelへ自動転記するツール開発 第1回】PyMuPDFで図面PDFを画面にプレビュー表示する(この記事)
- 【CAD図面PDFをExcelへ自動転記するツール開発 第2回】PyMuPDFで図面の文字を座標付きで抽出し、プレビューにハイライト表示する
- 【CAD図面PDFをExcelへ自動転記するツール開発 第3回】部屋名辞書とヒューリスティックで「部屋名らしき文字列」だけを絞り込む
- 【CAD図面PDFをExcelへ自動転記するツール開発 第4回】スキャン図面・画像PDFの部屋名をローカルOCR(Tesseract)で読み取る
- 【CAD図面PDFをExcelへ自動転記するツール開発 第5回】外部AI(Claude)の画像解析で図面の部屋名を読み取り、精度を底上げする
- 【CAD図面PDFをExcelへ自動転記するツール開発 第6回】AI・OCRの読み取り結果を人が確認・修正する画面を作る
- 【CAD図面PDFをExcelへ自動転記するツール開発 第7回】確認済みの部屋名を指定のExcelフォーマットの決まった欄へ転記する
- 【CAD図面PDFをExcelへ自動転記するツール開発 第8回】部屋名とExcelの欄の対応付けを設定ファイル(YAML)で変えられるようにする
- 【CAD図面PDFをExcelへ自動転記するツール開発 第9回】複数の図面PDFをフォルダごとまとめて処理する(進捗表示・中止・失敗しても止まらない一括処理)
- 【CAD図面PDFをExcelへ自動転記するツール開発 第10回】ローカル完結モードと外部AIモードを切り替え、APIキーをWindowsの資格情報マネージャーに保存する
- 【CAD図面PDFをExcelへ自動転記するツール開発 第11回(最終回)】PyInstallerでWindows向けexeにまとめて配布し、精度の限界と確認のルールを整理する


コメント
コメント一覧 (3件)
[…] 前回(第1回)では、CAD図面PDFの部屋名をExcelへ自動転記するWindows向けツールの第一歩として、選んだPDFのページをPyMuPDFで画像化し、画面のCanvas上にプレビュー表示するところまで作りました。ページ送り・拡大縮小はできますが、この時点では「人が図面を目で見て確認できる」だけで、部屋名を自動で読み取る処理はまだありません。 […]
[…] 次回(第1回)は、選んだPDFの図面ページをPyMuPDFで画像化し、tkinterのCanvasに表示してページ送り・拡大縮小ができるようにします。あわせて、PyMuPDFのライセンス(AGPL-3.0)についても具体的に扱います。 […]
[…] PDFの図面ページを画面にプレビュー表示する […]