SCVeamer

慣れたBeamerから、動かして見せられる発表へFrom familiar Beamer authoring to interactive presentations

僕たちは、主に多変数函数論や複素解析幾何を研究しています。数学的な対象をグラフィックや3D・VRで眺めることが、どんな直観や理解につながるのか。そのためには何をどう見せ、見る側は何を観察すればよいのか。そんなことを考えながら、可視化やブラウザゲームを作ってきました。

Our main fields are several complex variables and complex analytic geometry. We explore how graphics, including 3D and VR views, can help us develop mathematical intuition and understanding. What should we show, how should we show it, and what should the viewer observe? These questions have guided our work on visualizations and browser games.

その成果を講演で紹介しようとしたとき、普段使っているBeamerのスライドと、動かして見せたい図やゲームとを、どう自然につなぐかが課題になりました。

When we wanted to present that work in talks, we faced a practical question: how could we connect our usual Beamer slides naturally with the interactive figures and games we wanted to demonstrate?

そこで考えたのが、「原稿は慣れたBeamerの環境で作りながら、発表する画面にはHTMLを使ってもよいのでは？」ということです。

This led us to ask: could we keep writing our slides in the familiar Beamer environment, while using HTML for the presentation itself?

Beamerで作ったPDFのスライドをHTML上で表示し、その間にブラウザで動く図やゲームを組み込む。普段の原稿作成の流れを生かしながら、変換操作によって、それらをひとつの発表画面につなぐ。この考えをちゃぴおくんに相談し、試作と改良を重ねてできたのがSCVeamerです。

The idea was to display the PDF slides produced with Beamer in HTML and interleave them with figures and games that run in the browser. A conversion step would bring these elements together into one presentation, while retaining our usual authoring workflow. We discussed this idea with Chapio-kun and developed SCVeamer through repeated prototyping and refinement.

version 1.4でのPDF処理方式の変更The change to PDF processing in version 1.4

SCVeamerの初期版では、PyMuPDFを使ってPDFの処理を実装し、Beamerのスライドとブラウザ上の図やゲームをつなぐ仕組みを作りました。初期の実装を支えたPyMuPDFと、その開発に携わる方々に感謝しています。

The early versions of SCVeamer used PyMuPDF for PDF processing to bring Beamer slides together with browser-based figures and games. We are grateful to PyMuPDF and its contributors for supporting that initial implementation.

その後、ソフトウェアとしての公開と今後の再利用を考える中で、依存するソフトウェアのライセンス条件と配布方法を検討しました。自作コードと外部ライブラリの利用条件を整理し、僕たちの公開・配布方針を説明しやすくするため、その一環として、version 1.4試作版ではPDF処理をpypdf・pypdfium2／PDFium・Pillowによる構成へ変更しています。

As we considered publishing the software and making it easier to reuse, we reviewed the licenses of its dependencies and our distribution arrangements. To clarify the terms for our own code and the external libraries, and to make our publication and distribution policy easier to explain, the version 1.4 prototype changes the PDF-processing backend to pypdf, pypdfium2/PDFium, and Pillow.

通常のスライド画像はSVGからPNGへ変更しましたが、スライド送り、段階表示、ゲームの組み込みなどの使い方を保つ方針で実装し、比較確認を行いました。配布用PDFには、元PDFのページをベクターのまま残しています。画質・容量などの違いと確認の範囲は、同梱の検証記録をご覧ください。

The images used for ordinary slides have changed from SVG to PNG. The implementation aims to preserve slide navigation, incremental display, game integration, and the other existing presentation controls, and we have carried out comparisons. The handout PDF retains pages from the original PDF as vector content. Please consult the included validation records for differences in image quality and file size, and for the scope of the checks performed.

採用した第三者ソフトウェアとそのライセンス表示は、配布物の THIRD_PARTY_NOTICES.txt と licenses/ にまとめています。SCVeamer独自のコードについての正式なライセンス表記・適用範囲は、下記の方針に従い、関係者への確認を経て整える予定です。

The selected third-party software and its license notices are recorded in THIRD_PARTY_NOTICES.txt and licenses/. The formal license notice and scope for SCVeamer's own code will be established after consultation with the relevant parties, in accordance with the policy below.

いろいろな人の工夫につながってほしいWe hope it leads to other people's ideas and improvements

SCVeamerは、まず僕たち自身の研究や講演で役立つように作った道具です。同じ分野の方に活用していただけたらうれしいですし、ほかの分野でも、それぞれの対象や伝えたいことに合わせた工夫につながればと思っています。

We first made SCVeamer to help with our own research and talks. We would be happy if colleagues in our field found it useful, and if people in other fields adapted the approach to the objects they study and the ideas they want to communicate.

純粋数学の研究集会でも、直観を助け、理解を育てるグラフィックを、思いついた人が手軽に作り、気軽に講演へ組み込める。そんな発表の仕方が広がっていけばうれしいです。

We would like it to become easier for anyone with an idea for a useful graphic to create it and include it in a talk, including at pure mathematics meetings. We hope such presentations will help people develop intuition and understanding.

そのために、SCVeamerを利用する人が、自分の研究や授業に合わせて改良し、さらに発展させやすい形で、公開の仕方を整えていきたいと考えています。この取り組みの考え方が、別の道具や新しい発表方法を作るきっかけになることも願っています。

With this in mind, we want to arrange publication in a way that makes it easier for users to improve and develop SCVeamer for their own research and teaching. We also hope that the ideas behind this work will inspire other tools and new ways of presenting mathematics.

ライセンスについての、現在の考え方Our current thinking about licensing

こうした考え方に沿って、SCVeamer独自のコードについては、MITライセンスを採用したいと考えています。

In keeping with these aims, we would like to adopt the MIT License for the code developed specifically for SCVeamer.

ソフトウェアという形で研究成果を公開することは、僕たちにとって新しい試みでもあります。正式なライセンス表記とその適用範囲は、大学の担当部署や共同開発者などの関係者に、権利関係を含めて確認したうえで整える予定です。

Publishing research results as software is also a new undertaking for us. Before establishing the formal license notice and its scope, we plan to confirm the relevant rights and other details with the appropriate university offices, our co-developers, and other people involved.

この文章は、開発の背景と、現時点での公開にあたっての考え方をお伝えするものです。MITライセンスの正式な適用を告知するものではありません。正式な利用条件とその対象範囲は、確認後に、このウェブサイトと配布物に明記します。

This statement explains the background to the software and our current intentions for its publication. It does not announce the formal application of the MIT License. Once the relevant matters have been confirmed, we will state the formal terms of use and their scope on the website and in the distribution.

なお、外部ライブラリなど、第三者が提供するものには、それぞれのライセンス・利用条件が適用されます。

External libraries and other materials supplied by third parties remain subject to their respective licenses and terms of use.

参考になったときにはIf you find this work useful

SCVeamerを使った講演や、SCVeamerの考え方を参考に作った道具などを公開する際、どこかでProject HolomorphonauticaとSCVeamerをごく簡単に紹介していただけたらうれしいです。

If you give a talk using SCVeamer, or publish a tool inspired by its approach, we would be happy if you briefly acknowledged Project Holomorphonautica and SCVeamer somewhere appropriate.

たとえば、参考にした道具や取り組みとして、次のページへのリンクを添えていただく形でも十分です。

For example, a link to the following page among the tools or projects that you used or found helpful would be welcome:

Project Holomorphonautica — SCVeamer

Project Holomorphonautica — SCVeamer

この紹介は、僕たちからの任意のお願いです。適用されるライセンスが求める著作権表示・許諾文などの保持とは別のものです。

This acknowledgement is a voluntary request from us. It is separate from any requirement under an applicable license to retain copyright notices, permission notices, or other required notices.

この取り組みが、誰かの新しい工夫や、数学を見て考える楽しさにつながればうれしく思います。

We hope this work helps someone develop a new idea, or enjoy looking at and thinking about mathematics.