Forge Viewer：3D モデル差異の視覚化

BIM 360 Team の登場とともに導入された機能に、3D モデルバージョン間の差異をチェックするモデル比較機能がありました。現在では、BIM 360 の「変更の表示」機能として利用することが出来ます。

この機能は Autodesk.DiffTool エクステンションで実装されていて、Forge Viewer 上で利用することで、2 つのバージョン間の変更点（差異）を視覚的に Viewer 上に表現することが出来るようになります。いまのところ、Viewer の Extension ドキュメントには記載されていませんので、参考としてご確認ください。

Autodesk.DiffTool エクステンションを使用するには、まず 2 つのモデル Viewer カンバスにロードしてから、オプションを設定してエクステンションをロードするだけです。

指定可能なオプションは次のとおりです。

primaryModels (必須)：

ロードされた Autodesk.Viewing.Model インスタンスの配列で、追加、削除、変更されたオブジェクトの点で、現在の状態として差分操作に参加します。

diffModels (必須)：

ロードされた他の Autodesk.Viewing.Model インスタンスの配列です。比較するモデルのペアを定義するには、配列長が primaryModels と一致している必要があります。

versionA

モデルのバージョン識別子です。

versionB（必須）：

差分モデルのバージョン識別子です。

mimeType （必須）：

mimeType を定義することで、内部ロジックが若干適応され、モデルから分野、カテゴリ、名前をより良く抽出できるようになります。現在サポートされている MIME タイプは次のとおりです。

- 'application/vnd.autodesk.revit'：Revit プロジェクトー .rvt
- 'application/vnd.autodesk.autocad.dwg' ：AutoCAD 3D モデル－.dwg
- 'application/vnd.autodesk.navisworks' ：Navisworks モデルー .nwd

変更された要素のみを表示したりといったように、フィルタリング操作の機能を提供します。また、個々の変更点を簡単に見つけることができます。

Autodesk.DiffTool エクステンション は、「並べて表示」ビュー（'sidebyside'）や「オーバーレイ」ビュー（'overlay'）を提供します。特にコードを追加することなく、用意されたツールバーボタンから両者を切り替えることが可能です。

[変更] パネル右上には、2 つのモデルの比較結果を CSV ファイルとして保存するボタンも用意されています。

Autodesk.DiffTool エクステンションは次のようなコードでロードして利用が可能です。

    function onViewerGeometryLoaded(event) {
        var extensionConfig = {}
        extensionConfig.mimeType = 'application/vnd.autodesk.revit'
        extensionConfig.primaryModels = [_viewer3d_1.getVisibleModels()[1]]
        extensionConfig.diffModels = [_viewer3d_1.getVisibleModels()[0]]
        extensionConfig.diffMode = 'overlay'
        extensionConfig.versionA = 'sample_architecture.rvt v1'
        extensionConfig.versionB = 'sample_architecture.rvt v2'
        _viewer3d_1.loadExtension('Autodesk.DiffTool', extensionConfig)
            .then(function (res) {
                window.DIFF_EXT = _viewer3d_1.getExtension('Autodesk.DiffTool');
                console.log(window.DIFF_EXT);
            })
            .catch(function (err) {
                console.log(err);
            });
    }

注意事項と制限事項:

Autodesk.DiffTool エクステンションは SVF ベースのモデルや SVF2 ベースのモデルで動作します。
クラウド上でバージョンのモデル間の差異を返す REST API はありません。現状では、Model Derivative API：メタデータの活用 のブログ記事でご紹介した方法でメタデータを解析することになってしまいます。

By Toshiaki Isezaki