SCVeamer ver 1.4 試作版 - 2026-10-24
====================================

まず完成物を見る
----------------
bundled/day1/index.html をブラウザで開いてください。
このHTMLは単一ファイルで、インターネット接続なしでも閲覧できます。
スターターは starter/index.html、テンプレートは bundled/template-v2/index.html。
今回同梱したサンプルは横2560pxの可逆圧縮PNG方式です。
配布用PDFは各資料の handout.pdf（テンプレートは従来どおり生成無効）。

試作の目的
----------
公開SCVeamer 1.3のPDF処理をpypdf + pypdfium2/PDFiumに置換し、
数式の組版、段階表示、3ゲーム、固定例、時刻を維持できるか調べたものです。
1.4としての最終確認は VALIDATION_1_4.txt、方式比較の記録は VALIDATION_PDFIUM.txt と validation/ にあります。
今回の変更一覧は CHANGES_1_4.txt です。表示方式はユーザー確認済みの2560px版を継承しています。
古い VALIDATION.txt と VALIDATION_1_2.txt は以前の版の履歴です。

PDFから再生成する（Windowsを想定した手順。確認の範囲は下記参照）
----------------------------------------------------------------
1. ZIPを新しい短い名前のフォルダへ「すべて展開」します。
2. Python 3.11以上を用意します。GUIを使う場合はTkinterも必要です。
3. SETUP_WINDOWS.cmd を実行するか、端末で py scveamer.py --setup を実行。
   このキット専用の .venv へ requirements.txt の固定版を導入します。
   初回のライブラリ取得にはネット接続が必要です。
4. 自分の資料フォルダのtalk.pdfをTeXエディター等で更新しておきます。
   ゲーム・時刻のリンク注釈を保つため、印刷によるPDFの作り直しは不要です。
5. START_WINDOWS.cmd から資料フォルダを選び「既存PDFからHTMLを作成」、
   または次のコマンドを実行します。

   py scveamer.py --project "C:/work/my-talk" --pdf-only --image-width 2560

画像幅は presentation.json の image_width でも指定できます。
CLI指定 > presentation.json > 未指定時1920px の順に適用します。
同梱サンプルの設定は2560pxです。1920pxとの比較も検証記録にあります。
PDFだけからの変換にはTeXは不要です。TeXから一括生成する機能も残していますが、
初回セットアップ・GUIの各機能・TeX一括処理を個別に網羅したWindows試験、Macでの確認、exe作成・実行確認は記録していません。

確認できたことと残ること
----------------------
日英のスターター6枚/9段階、テンプレート9/13、Day1 46/76の構造が一致。
Day1は14:55開始、135分、17:10終了。ゲームの設定・操作状態保持も確認済み。
PyMuPDFなしのLinux/Python3.12.14環境で17件の自動テストが成功。
生成handoutは元PDFのページをコピーし、数式・フォントをベクターで保持します。

PNGは固定解像度のため、4K表示や大きな拡大ではSVGより輪郭が柔らかくなります。
Day1全巡回後のブラウザPSSはPNG版で約1.0GiB（旧SVG約670MiB）でした。
単純な画像保持範囲の調整は明確な効果がなく、プレイヤー変更は採用していません。
本文画像とは別のaltテキストでは、プライム・否定線等の文字抽出に差が残ります。
目次タイトルは全サンプルで元版と一致。通常表示の数学本文は画像として保持します。
回転・CropBoxを含む任意PDF、Mac、実機投影の確認は別途必要です。Windows 11の本人確認とその範囲は VALIDATION_PUBLICATION_1_4.txt を参照してください。

依存関係と権利表示
------------------
pypdf==6.10.0 / pypdfium2==5.14.0 / Pillow==12.3.0
検証したPDFiumは156.0.8076.0です。
THIRD_PARTY_NOTICES.txt と licenses/ に依存部品の表示を収録しています。
このZIPはソース配布で、Python、PDFium等のライブラリ本体を同梱しません。
既存の人名・協働の説明を保持し、自作コードの新たなMIT宣言は追加していません。
大学等への確認、権利者・適用範囲の決定は従来の方針どおり別途進める事項です。

版の識別
--------
アプリは1.4-prototype-20261024、完成HTMLの製品情報は1.4です。
公開版1.3や先行PDFium試作の設定と混ざらないよう、version-1.4-prototypeを使います。
講義原稿に含まれる過去の版名や、CHANGES_1_2.txt / CHANGES_1_3.txtは履歴として保持します。

ご利用前の注意、制作・確認の範囲、公開方針と更新経緯は CREDITS.html / CREDITS.txt、公開用文書の整備とWindows 11の本人確認は VALIDATION_PUBLICATION_1_4.txt を参照してください。

2026年10月24日、小池 貴之が1.4試作版を自身のWindows 11のPCで操作し、試した範囲では特に問題なく動いたと確認しています。操作の個別内訳や使用した言語版・環境詳細は網羅的に記録していないため、全機能の通し試験や日英両版のWindows検証済みを意味しません。
初回セットアップ・GUIの各機能・TeX一括処理を個別に網羅したWindows試験、Macでの確認、exe作成・実行確認は記録していません。
