LibreCAD in the Browser
LibreCAD in the Browser (magik.net)
要約
この投稿では、WebAssembly(Wasm)を使用して、デスクトップアプリケーションである2D CADソフトウェアLibreCADをブラウザ上で直接実行可能にした方法について説明しています。QtフレームワークとEmscriptenを活用し、ネイティブアプリケーションの全機能(DXF/DWGファイル対応、レイヤー、ブロックなど)をブラウザで動作させることができました。特に、ネストされたダイアログやイベントループの処理といったWebAssemblyの課題を、JSPI(WebAssembly JavaScript Promise Integration)を用いて解決した点が特筆されます。これにより、ローカルにソフトウェアをインストールすることなく、手軽に2D図面を作成できるようになりました。
全文翻訳
LibreCADをブラウザで実行
投稿日: 2026年6月29日 · 更新日: 2026年7月1日
時折、フロアプランのような簡単な2D図面をスケッチする必要に迫られます。私はCADユーザーではなく、数本の線と円を描くためだけにCADをインストールしたくありません。無料の選択肢はすべてデスクトップアプリです。何かをダウンロードし、インストールし、起動し、ローカルで作業します。自分のデスクにいるときはそれで良いのですが、2026年にもなって、ログインなしでタブを開いて描画できないというのは少し馬鹿げていると感じました。
私は実際にLibreCADを使ったことも聞いたこともなく、ターゲットユーザーでもありません。ただ簡単なスケッチができるものが欲しかったのです。そこで、別のデスクトップアプリを試す代わりに、オープンソースのアプリを見つけて、OpenCodeでGLM-5.2に指示してWebAssemblyにポートしようと考えました。
プロセス全体が非常にハンズオフで「簡単」だったことは特筆に値しますが、これはQtチームがWasmサポートに非常に真剣に投資していること、そしてWasmエコシステム全体が成熟していることの恩恵によるものです。
モデルができることの限界に近いことが判明しましたが、いくつかのガイダンスがあればうまくいきました。ネイティブのビジョンサポートとコンピューター操作能力があれば、モデルが自律的に問題をデバッグするのに大いに役立つでしょうが、GLM-5.2にはその能力が欠けています。結果は以下の通りです。アプリケーション全体(ビューアやサブセットではなく)がWebAssemblyにコンパイルされ、このサイトで動作します。クリックするとロードされます(ソース: github.com/magik6k/LibreCAD-Web)。
初回ロードは約18MB(Brotli圧縮)です。その後、ブラウザがキャッシュします。最近のChromiumベースのブラウザ(ChromeまたはEdge 137+)が必要です。このポートはWebAssembly JSPIに依存しており、FirefoxとSafariはまだ対応していません。詳細は後述します。
以下のコンテンツはすべてLLMによって書かれていますが、アプリがブラウザで概ね動作するように見えるのと同様に、技術的にも概ね正確であるように見えます。ただし、詳しく見るとひどいバグが含まれている可能性があります。これは完全にFAFO(Find Out For Yourself)スタイルのノーエフォートプロジェクトであり、何を期待しますか?
何か
LibreCADは、無料のGPLライセンスの2D CADアプリケーションです。DXFおよびDWGファイルを読み書きでき、レイヤー、ブロック、寸法、ハッチング、および2D CADツールに期待されるほとんどの機能をサポートしています。Qt上でC++で構築されており、QCad時代から存在しています。
このポートは、EmscriptenとQtの公式WebAssemblyプラットフォームサポートを通じて、全く同じC++ソースコードをWebAssemblyにコンパイルします。JavaScriptによる再実装や、Webネイティブなフォーク、サーバーサイドレンダリングはありません。実際のデスクトップアプリケーションがブラウザタブで動作しています。
どうやってやったか
最初の90%は機械的な作業でした。ツールチェーンをセットアップし、コンパイルし、GUIを起動し、ファイルを接続しました。最後の10%――モーダルダイアログを実際に機能させること――が興味深い問題であり、ツールチェーン全体を再構築する必要が生じました。正直なバージョンは以下の通りです。
ツールチェーンとコンパイル
Ubuntu 24.04、Emscripten、Qtを含むDockerイメージを使用しました。完全なLibreCADソースは、Qt独自のqt.toolchain.cmake(生のEmscriptenツールチェーンファイルではfind_package(Qt6)が失敗します)を使用して.wasmバイナリにコンパイルおよびリンクされます。デスクトップ専用の起動パス(CLI引数解析、スプラッシュスクリーン、初回実行ダイアログ、バージョンチェックネットワーク)は#ifndef Q_OS_WASMで保護されているため、デスクトップビルドは変更されていません。
GUIの起動
WebAssembly用のQtはWebGLを通じてレンダリングし、プラットフォームプラグインを通じてブラウザイベントを配信します。メインウィンドウが起動し、ツールバーとドックが表示され、キャンバスがマウスとキーボード入力を受け取ります。ここまでは順調でした。
難しい部分: ネストされたダイアログとexec()
LibreCADは本格的なデスクトップアプリであり、デスクトップアプリはイベントループに絶えず再突入します。QDialog::exec()はダイアログを閉じるまでブロックし、コンボボックスのドロップダウンは独自のループをスピンし、設定ダイアログから開かれたカラーピッカーはさらに別のループをネストします。Web上ではメインスレッドをブロックすることはできません。ページをフリーズさせることなく「ここで待つ」方法はありません。そのため、exec()は返りません。
Emscriptenの回答はAsyncifyです。これはバイナリを書き換えて、ブロッキングコールがブラウザにアンワインドして後で再開できるようにします。Qtはこれをサポートしており、ほとんどのQt-WASMアプリがこれを使用しています。これは1つのレベルでは機能します。Asyncifyは一度に1つのコールスタックの深さしか中断できません。したがって、ダイアログは正常に開きますが、そのダイアログ内のコンボボックスをクリックしたり、アプリケーション設定からカラーピッカーを開いたりすると、2番目のサスペンドは行き場がなくなり、アプリ全体がスタックします。設定がドロップダウンとカラーボタンで埋め尽くされているCADプログラムにとって、これは粗いエッジではなく、使用不能です。
その修正がJSPI(WebAssembly JavaScript Promise Integration)です。これはネイティブブラウザのサスペンドメカニズムであり、Asyncifyとは異なり、任意にネストできます。Qt 6.9はこれをターゲットにできます(-device-option QT_EMSCRIPTEN_ASYNCIFY=2)が、ネイティブWebAssembly例外(-fwasm-exceptions)が必要であり、プリビルドされたQtパッケージはどちらも出荷していません。そのため、このポートは現在、JSPI + Wasm例外を有効にして、WebAssembly用にQt 6.9をソースからビルドしています。
それが本当のパズルを露呈させました。JSPIは、WebAssemblyスタックが「プロミッシング」関数を通じて入力された場合にのみサスペンドを許可しますが、Emscriptenはmain()のみをプロミッシングとしてマークします。しかし、main()が(Web上でそうしなければならないように)返ると、すべてのブラウザイベント――ダイアログを開くすべてのクリック――は、プロミッシングではない独自の新しいスタックで到着するため、サスペンドはtrying to suspend without WebAssembly.promisingで中止されます。これを機能させるには、3つの協調的な変更が必要でした。
- QtのDOMイベントハンドラを
emscripten::async()embind関数として登録します。これにより、すべてのマウス/キーイベントがプロミッシングフレーム内で実行されます(これにはEmscripten 4.0+が必要です。古いシリーズには起動時に中止するembind+JSPIバグがありました)。 - Qtのタイマーとポストされたイベントコールバックも同様にラップします。これにより、イベントループからトリガーされたサスペンドも機能します。
main()をasync形式に再構築します。アプリを作成して返します。ブラウザがループを駆動します。これは、-fwasm-exceptionsが古い「無限ループをシミュレートする」トリックと互換性がないためです。
これにより、QDialog::exec()、コンボボックスのドロップダウン、ネストされたカラーピッカー、コンテキストメニューのサブメニューがすべて、任意のネスト深度で機能します。アプリケーションレベルでのダイアログの書き直しは不要です。プラットフォームが正しいことを行います。
キャンバスを高速化する
最初に動作したビルドは、実用的なウィンドウサイズで4〜5 fpsで描画されました。プロファイルの結果、フレーム時間のほとんどすべてが1つのQt関数、blend_untransformed_generic_rgb64に費やされていました。原因は、QtのWebAssemblyバックエンドストアのピクセルフォーマットでした。これはストレートアルファのRGBA8888サーフェス(HTMLキャンバスが要求するもの)です。これはQtの高速パスラスタフォーマットの1つではないため、描画されたものをウィンドウにブレンドするたびに、ピクセルあたり64ビットの汎用ブレンドにフォールバックしていました。バックエンドストアをプリマルチプライドアARGB32(Qtの最も最適化されたフォーマットで、描画されているレイヤーと一致します)に切り替えると、コンポジットがSIMDパスに送られ、フラッシュ時に単一のフォーマット変換が行われ、キャンバスが必要とするRGBAバイトが生成されます。フレームレートは約3倍になりました。これはエンジン全体での改善であり、キャンバスのハックではありません。
ファイルシステムなしでのファイル操作
ブラウザには実際のファイルシステムがなく、QtのヘルパーAPI(getOpenFileContent / saveFileContent)は、このJSPIビルドではバイトを確実に配信しないことが判明しました。オープンハンドは未記入のバッファを返し、セーブはチャンク化されたwritable-streamピッカーを試しましたが、ダウンロードは生成されませんでした。どちらも現在、薄いJavaScriptシムを通じて行われます。オープンはファイルを選択し、JSで読み込み、バイトをEmscriptenのインメモリファイルシステム(MEMFS)に直接書き込み、パスでロードします。セーブはMEMFSにシリアライズし、バイトをBlobと合成ダウンロードリンクに渡します。CADフォント(47個の.lffファイル)とハッチパターンは、30MBのデータパッケージとしてバンドルされ、MEMFSに事前にロードされ、アプリケーション設定はIndexedDBを介してリロード間で永続化されます。
本番環境
Brotli圧縮により、総転送量は約70MBから約18MBに削減されます。PDFエクスポートはQPdfWriter(QtGui内にあり、利用できないPrintSupportモジュールなしで生存します)を通じて機能し、結果をダウンロードします。カスタムHTMLシェルがQtのデフォルトローダーを置き換え、スプラッシュスクリーンとプログレスバーを表示し、JSPIサポートなしでアクセスした場合にフレンドリーなメッセージを表示します。
試してみる
ロードされたら、以下を試してください。
- DXFを開く: File → Open → コンピュータからDXFを選択します。お持ちでない場合は、LibreCADリポジトリにサンプルファイルがあります。
- 線を描く: Lineツールをクリックし、キャンバス上の2点を選択します。
- パン/ズーム: マウスホイールでズーム、中央ドラッグでパンします。
- 保存: File → Save As → ブラウザがDXFをダウンロードします。
- PDFエクスポート: File → Print → PDFをダウンロードします。
技術仕様
ビルド
Qtバージョン
6.9.3、WebAssembly用にソースからビルド
サスペンドバックエンド
JSPI (QT_EMSCRIPTEN_ASYNCIFY=2) + ネイティブWasm例外
Emscripten
4.0.7
ベースイメージ
Ubuntu 24.04 (Docker)
C++標準
C++17
スレッド
シングルスレッド
メモリモデル
wasm32 (4 GB上限)
バイナリサイズ
librecad.wasm
39 MB (生) → 16 MB (Brotli)
librecad.data (フォント + パターン)
30 MB (生) → 2.2 MB (Brotli)
librecad.js (ランタイムグルー)
264 KB (生) → 52 KB (Brotli)
総転送量 (Brotli)
約18 MB
動作するもの
DXFの開く/編集/保存
はい (ブラウザのファイルピッカー + ダウンロード)
DWG読み込み
はい (libdxfrwバンドル)
モーダルダイアログ、ドロップダウン、カラーピッカー
はい、任意の深度までネスト可能 (JSPI)
すべての描画ツール
はい (線、円弧、円、ポリライン、スプライン、ハッチ、寸法、テキスト)
すべての編集ツール
はい (移動、回転、スケール、ミラー、トリム、面取り、オフセット、展開)
レイヤー、ブロック、ライブラリ挿入
はい
SVGエクスポート
はい
PDFエクスポート
はい (QPdfWriter、ファイルとしてダウンロード)
設定の永続化
はい (IndexedDB)
翻訳 (30言語以上)
はい (バンドルされた.qmファイル)
ブラウザサポート
Chromiumベース (Chrome / Edge 137+); Firefox/Safariはまだ (JSPI)
マルチウィンドウMDI
インキャンバスのみ (Web上ではOSウィンドウなし)
物理プリンターへの印刷
いいえ (PDFはブラウザの印刷機能を使用)
ソースコード
フォークはgithub.com/magik6k/LibreCAD-Webのwasm-portブランチにあります。アップストリームはgithub.com/LibreCAD/LibreCADです。すべての変更は#if defined(Q_OS_WASM)、#ifndef LC_NO_PRINT、#ifndef LC_NO_NETWORKガードで隔離されています。デスクトップビルドは同じソースツリーから同様にコンパイルおよび実行されます。
興味深い部分はすべてプラットフォームレイヤーにあり、LibreCAD自体のコードではありません。QtのWebAssemblyバックエンドへのいくつかの小さなパッチ(プロミッシングイベントハンドラ、ARGB32バックエンドストア)、ソースからのQtビルドレシピ、JavaScriptのファイルオープン/セーブシムです。ネストされたダイアログを機能させるために、LibreCAD本体のコードはほとんど変更する必要がありませんでした。JSPIがその重みを担っています。Qtのパッチは、アップストリームに提案する価値があるほど小さいです。
注意点
- 現時点ではChromiumのみ。ネストされたダイアログの修正は、現在Chromiumベースのブラウザ(Chrome / Edge 137+)で提供されているWebAssembly JSPIに依存しています。FirefoxとSafariも対応を進めており、対応され次第、このビルドもそこで動作するはずです。
- 初回ロードには数秒かかります。18MBのWASM + データファイルをダウンロードしてコンパイルする必要があります。その後はキャッシュされます。
- 保存はダウンロードになります。ブラウザは開いたファイルに書き戻すことができません。「保存」および「名前を付けて保存」は、ディスク上のコピーを上書きするようにダウンロードされたコピーを渡します。これはWebプラットフォームの制限であり、バグではありません。
- リロード間で最近使用したファイルはありません。最近使用したファイルのパスは、リロード時に消える一時的なインメモリハンドルです。ファイルリストは保存されますが、ファイル自体は保存されません。ディスクから再度開いてください。
- モバイルブラウザはテストされていません。UIはマウス+キーボード向けに設計されています。タッチイベントはQtの入力システムを介してルーティングされますが、電話ではツールバーが非常に小さくなります。
ライセンス
LibreCADはGPL-2.0ライセンスです。WebAssemblyバイナリはGPL-2.0ソースのコンパイルされた形式であるため、同じライセンスが適用されます。この正確なビルドのソースは、上記のwasm-portブランチにあります。