C#開發BIMFACE系列41 服務端API之模型對比

BIMFACE二次開發系列目錄     【已更新最新開發文章，點選檢視詳細】

　　在建築施工圖審查系統中，設計單位提交設計完成的模型/圖紙，審查專家審查模型/圖紙。審查過程中如果發現不符合規範的地方，則流程退回到設計單位，設計單位人員根據審查意見重新調整設計，調整完成後再次提交到審查專家。此時為了便於專家審查，需要知道當前輪次的模型/圖紙與上一輪次的模型/圖紙發生了哪些異動，針對異動情況進行審查即可。

先看效果

 

效果如上圖。左側是當前審查輪次的模型，中間是上一輪次的模型，右側是2個模型的對比產生的異動列表。

（1）點選“新增構建”中的構件，自動定位到當前輪次中新增的目標構件。異動構件以淺綠色表示。2個模型視角同步移動。

 

（2）點選“刪除構建”中的構件，自動定位到上一輪次中的目標構件，本輪次中的構件被刪除，所以不顯示。異動構件以淺綠色表示。2個模型視角同步移動。

 （3）點選“修改構建”中的構件，自動定位到當前輪次中修改的構件以及上一輪次對應的構件。異動構件以淺綠色表示。2個模型視角同步移動。

 

BIMFACE之前是沒有三維模型聯動對比的功能，在我和BIMFACE的技術支援團隊的美麗小姐姐溝通後，他們把我的要求納入了他們產品的需求，經過工程師們加班加點的辛苦付出，很快就實現了該功能。特此感謝BIMFACE團隊的所有小夥伴，感謝你們對開發者的信任與接受，感謝你們的辛苦付出。

滴水之恩，當湧泉相報，奉獻上BIMFace C#版SDK開源專案。

開源地址：https://gitee.com/NAlps/BIMFace.SDK

作者：張傳寧（系統架構師、技術總監 南京群耀 http://www.sparkcn.com） QQ：905442693 微信：savionzhang

歡迎下載使用，交流、分享。

下面介紹BIMFACE模型對比功能的原理與實現。

　　模型對比可以對兩個檔案/模型進行差異性分析，確定兩個檔案/模型之間構件的幾何和屬性差異，包括增加的構件、刪除的構件和修改的構件。 模型對應可以用於進行檔案/模型的版本對比。

特別說明：模型對比是在BIMFACE雲端進行的，通常需要5~10分鐘。當模型對比完成後，BIMFACE能通知對比結果。

前置條件

• 您需要將修改前和修改後的模型上傳到雲端並轉換成功以後才能發起模型對比；
• 目前僅支援.rvt單檔案的模型對比。

基本步驟

1. 通過服務端API發起模型對比（對比前後模型檔案的fileId）；
2. 等待雲端對比任務執行；
3. 對比完成後，在網頁端通過呼叫JavaScript API實現差異模型的顯示；
4. 除了顯示差異模型，還需要呼叫服務端API獲取對比結果（包括新增、刪除、修改的構件列表）。

對比流程

　　模型檔案經過雲端轉換後，生成了BIMFACE定義的資料包。因此，要對比兩個模型檔案，實際上需要對比兩個檔案的資料包。如下圖所示，檔案B是檔案A修改後的版本，對比完成之後，其結果包括兩個部分：

• 幾何差異；
• 變更構件及屬性。

 

BIMFACE提供了服務端API，用於發起對比，獲取對比狀態、獲取對比結果。請參考我的部落格：

C#開發BIMFACE系列30 服務端API之模型對比1：發起模型對比

C#開發BIMFACE系列31 服務端API之模型對比2：獲取模型對比狀態

C#開發BIMFACE系列32 服務端API之模型對比3：批量獲取模型對比狀態

C#開發BIMFACE系列33 服務端API之模型對比4：獲取模型對比結果

C#開發BIMFACE系列34 服務端API之模型對比5：獲取模型構建對比差異

測試程式

發起模型對比

呼叫伺服器端的API獲取對比結果

對比差異分為三類：新增、修改、刪除。返回結果對應的實體類如下：

    /// <summary>
    /// 模型對比差異類
    /// </summary>
    public class ModelCompareDiff
    {
        /// <summary>
        ///  對比差異構件所屬類別ID。樣例 : "-2001320"
        /// </summary>
        [JsonProperty("categoryId", NullValueHandling = NullValueHandling.Ignore)]
        public string CategoryId { get; set; }

        /// <summary>
        ///  對比差異構件所屬類別名稱。樣例 : "framework"
        /// </summary>
        [JsonProperty("categoryName", NullValueHandling = NullValueHandling.Ignore)]
        public string CategoryName { get; set; }

        /// <summary>
        ///  對比構件差異型別：NEW、DELETE、CHANGE
        /// </summary>
        [JsonProperty("diffType", NullValueHandling = NullValueHandling.Ignore)]
        public string DiffType { get; set; }

        /// <summary>
        ///   對比差異構件ID。樣例 : "296524"
        /// </summary>
        [JsonProperty("elementId", NullValueHandling = NullValueHandling.Ignore)]
        public string ElementId { get; set; }

        /// <summary>
        ///  對比差異構件名稱
        /// </summary>
        [JsonProperty("elementName", NullValueHandling = NullValueHandling.Ignore)]
        public string ElementName { get; set; }

        /// <summary>
        ///  對比差異構件的族名稱。樣例 : "framework 1"
        /// </summary>
        [JsonProperty("family", NullValueHandling = NullValueHandling.Ignore)]
        public string Family { get; set; }

        /// <summary>
        ///  對比差異構件來源構件ID。樣例 : "0213154515478"
        /// </summary>
        [JsonProperty("id", NullValueHandling = NullValueHandling.Ignore)]
        public string Id { get; set; }

        /// <summary>
        ///  對比差異構件變更檔案ID，即(當前)變更後的檔案ID。樣例 : "1136893002033344"
        /// </summary>
        [JsonProperty("followingFileId", NullValueHandling = NullValueHandling.Ignore)]
        public string FollowingFileId { get; set; }

        /// <summary>
        /// 對比差異構件來原始檔ID，即 (歷史)變更前的檔案ID。樣例 : "0213154515478"
        /// </summary>
        [JsonProperty("previousFileId", NullValueHandling = NullValueHandling.Ignore)]
        public string PreviousFileId { get; set; }

        /// <summary>
        ///  對比差異構件所屬專業。樣例 : "civil"
        /// </summary>
        [JsonProperty("specialty", NullValueHandling = NullValueHandling.Ignore)]
        public string Specialty { get; set; }
    }

返回的差異結果如下：

{
    "code": "success",
    "message": null,
    "data": {
        "data": [{
                "diffType": "NEW",
                "id": "1946876"
            }, {
                "diffType": "NEW",
                "id": "1946877"
            }, {
                "diffType": "NEW",
                "id": "1946878"
            }, {
                "diffType": "CHANGE",
                "id": "40539"
            }, {
                "diffType": "CHANGE",
                "id": "40541"
            }, {
                "diffType": "CHANGE",
                "id": "40542"
            }, {
                "diffType": "DELETE",
                "id": "22243"
            }
        ],
        "page": 1,
        "total": 7
    }
}

前端使用JS來實現同步聯動效果，以及點選異動構件後自動定位到構件所在的視角。

// 同步新舊模型的平移和旋轉操作
function correspond() {
    latestViewer = latest.getViewer();
    var state, focus;

    prevViewer = prev.getViewer();
    view1Bind = function (data) {
        //用新模型的狀態更新舊模型狀態
        var latestState = latestViewer.getCurrentState();
        prev.setState(latestState);
        prev.getViewer().camera.up.copy(latestViewer.getViewer().camera.up);
    }

    view2Bind = function (data) {
        //用舊模型的狀態更新新模型狀態
        var prevState = prev.getCurrentState();
        latestViewer.setState(prevState);
        latestViewer.getViewer().camera.up.copy(prev.getViewer().camera.up);
    }

    //考慮到死迴圈的影響，不能同時監聽render事件，因此以滑鼠所在位置模型的監聽為主
    document.querySelector('#container').addEventListener('mousemove',
        function (e) {
            if (focus == undefined) {
                var width = document.querySelector('.latest').offsetWidth;
                if (e.clientX > width) {
                    focus = 1;
                    latestViewer.removeEventListener('Rendered', view1Bind);
                    prev.addEventListener('Rendered', view2Bind);
                } else {
                    focus = 0;
                    prev.removeEventListener('Rendered', view2Bind);
                    latestViewer.addEventListener('Rendered', view1Bind);
                }
            }
        });

    view1.addEventListener('mouseover',
        function (e) {
            if (focus == 0) {
                return;
            }
            focus = 0;
            // 解綁與重新繫結事件，同步新舊模型的Rendered
            prev.removeEventListener('Rendered', view2Bind);
            latestViewer.addEventListener('Rendered', view1Bind);
        });

    view2.addEventListener('mouseover',
        function () {
            if (focus == 1) {
                return;
            }
            focus = 1;
            // 解綁與重新繫結事件，同步新舊模型的Rendered
            latestViewer.removeEventListener('Rendered', view1Bind);
            prev.addEventListener('Rendered', view2Bind);
        });

    // 同步新舊模型的Hover事件
    prev.addEventListener('ComponentsHoverChanged',
        function (e) {
            latestViewer.getViewer().modelManager.sceneState.setHoverId(e.objectId);
        });

    latestViewer.addEventListener('ComponentsHoverChanged',
        function (e) {
            prev.getViewer().modelManager.sceneState.setHoverId(e.objectId);
        });

    var ViewerEvent = Glodon.Bimface.Viewer.Viewer3D;
    latestViewer.setCameraAnimation(false);
    prev.setCameraAnimation(false);
}

//建立異動列表與構件的click事件
function createDom(result) {
        // 設定構件差異構件樹的UI
        var newItems = result.newItems,
            deleteItems = result.deleteItems,
            changeItems = result.changeItems;
        var typeBoxs = document.querySelectorAll('.type-box');
        typeBoxs[0].innerHTML =
            `<div class="title"><i class="icon arrow"></i><i class="icon-type new"></i>新增構件（${newItems.length}）</div>
                                      <ul id="addElement" class="type-ul">${createDomNode(newItems)}</ul>`;

        // 刪除構件列表
        typeBoxs[1].innerHTML =
            `<div class="title"><i class="icon arrow"></i><i class="icon-type remove"></i>刪除構件（${deleteItems.length}）</div>
                                      <ul id="removeElement" class="type-ul">${createDomNode(deleteItems)}</ul>`;

        // 修改構件列表
        typeBoxs[2].innerHTML =
            `<div class="title"><i class="icon arrow"></i><i class="icon-type revise"></i>修改構件（${changeItems.length}）</div>
                                      <ul id="reviseElement" class="type-ul">${createDomNode(changeItems)}</ul>`;

        // 差異構件樹列表
        document.querySelector('.compare-content').addEventListener('click',
            function (e) {
                var element = e.target;
                if (element.tagName == 'I' && element.hasClass('arrow')) {
                    if (element.hasClass('close')) {
                        element.removeClass('close');
                        element.parentElement.nextElementSibling.removeClass('close');
                    } else {
                        element.addClass('close');
                        element.parentElement.nextElementSibling.addClass('close');
                    }
                } else if (element.tagName == 'SPAN' && element.getAttribute('type')) {
                    var type = element.getAttribute('type'),
                        id = element.parentElement.getAttribute('data-oid');
                    if (type == 'NEW') {
                        latestViewer.setSelectedComponentsById([id]);// 高亮選中構件
                        latestViewer.zoomToSelectedComponents();  // 定位
                        view1Bind();
                    } else if (type == 'DELETE') {
                        prev.setSelectedComponentsById([id]);// 高亮選中構件
                        prev.zoomToSelectedComponents(); // 定位
                        view2Bind();
                    } else {
                        latestViewer.setSelectedComponentsById([id]); // 高亮選中構件
                        latestViewer.zoomToSelectedComponents();// 定位;
                        view1Bind();
                        prev.setSelectedComponentsById([id]);
                    }
                }
            });
    }

上述測試程式使用了 《BIMFace.SDK.CSharp》開源SDK。歡迎大家下載使用。

BIMFACE二次開發系列目錄     【已更新最新開發文章，點選檢視詳細】