外掛介紹-Data-Shapes @ BIM BIM BANG BANG! 學習筆記!

1. 外掛名稱 : Data-Shapes

2. 版本 : 2017.4.212

4.作者: Mostafa El Ayoubi

內容簡介:

Dynamo 1.3了!! 掌聲!! 但是Dynamo Player似乎被遺忘了... 沒關係! 今天介紹一個外掛來輔助Dynamo player的使用! Data-Shapes!!
Data-Shapes 最有趣的是UI生成的功能，使用者直接選擇參數類型，例如布林(Boolean)、圖片(Image)、下拉選單(DropDown)...等，設定好需求的數值輸入模式之後，以WindowsForm的形式呈現，讓使用者可以直接利用Dynamo player 啟動程式，不需要另外打開dynamo；而Data-Shapes另一個強大的功能就是-版本比較！原理是透過document來比較不同的Revit 專案。

以下是以Dynamo Player啟動程式的範例~

---------------------------------------------------

以下開始說明使用方式:

01.UI.MultipleInputForm 是生成Form的第一代Node，根據Node說明輸入一些簡寫就產生功能鍵，例如 s =字串，但是不同外掛版本的更新，常常造成這個Node無法正常使用，因此還是建議以UI.MultipleInputForm ++執行，後面的範例都是用"UI.MultipleInputForm ++"執行

"UI.MultipleInputForm ++" ，我們可以寫好功能說明、放自己的Logo、放很多的功能、連結說明文件（可以是網頁、圖片、PDF...)

02.UI.Boolean input 布林輸入，預設值是false，因此不選擇就按"Set Values"的話，就會得到False的值，反之如果勾選的話，就會得到True的值

03.UI.ColorInput Data，啟動之後，會跳出選擇顏色的視窗，選擇完顏色會回傳Revit.DB的顏色資訊，因此就可以用在Revit的顏色顯示上，這個功能在分析或是比較上會很常用喔！可以好好練習一下(另外補充，RevitDB.Color要在Dynamo裡面使用的話，還需要用Clockwork的外掛-RevitColor.ToDynamoColor)

04.UI.DirectoryPath Data，用來設定資料的路徑，例如說存放Excel檔案的位置或是讀取資料的路徑

05.UI.DropDown Data，下拉選單可以設定一些預設值讓人選擇，例如說特定的族群類型或是不同的數值

06.UI.FilePath Data，這與上面的路徑選擇不同，這是直接選取了某個檔案

07.UI.Image Data則是可以輸入圖片，顯示在Form上(其實我不太確定這個可以幹嘛~哈)

08.UI.Listview列表選擇，提前設定一些數值以供選擇

09.UI.RadioButtons單選數值，例如某個輸入值僅接受單一數值的時候就可以使用

10.UI.SelectEdges點選Revit裡面的邊緣線，選進Dynamo之後，應該就直接是Line囉，我選擇牆的邊緣線就直接是Line了，其他類型應該也是如此

11.UI.SelectFaces Data，點選面，這兩個Node應該都與內建的功能差不多，只是變成可以在DynamoPlayer上面使用

12.UI.SelectLinkedElement(s) Data，選擇連結檔案，這個功能在後續的比較版本上會用到

13.UI.SelectModelElements Data，選擇物件，這一個Node應該不用多說，肯定是會不斷使用的功能，我們可以先限制品類，再框選的時候就可以避開不必要的東西

14.UI.Slider，slider存在的意義應該跟上面的一樣，如果不打開dynamo的話，就用這個方式來控制數值

15.UI.TextBox Data，或許有某些狀況是允許自行輸入文字的，例如說備註、名稱...等

16.UI.TextNote Data，最後這一個應該也是用來說明用的，或是大家有其他用法的話，拜託再跟我分享一下，感謝

到這邊為止，就是UI部分的逐一說明，希望沒有把大家嚇跑!講這麼多，到底要如何運用這些東西呢？我就以簡單的案例來說明一下吧！

---------------------------------------------------

後面慢慢補充ModificationTracker的部分~ 想要馬上了解的朋友可以點擊"這裡"

A.ModificationTracker.ModelComparison 通常應該是跟目前開啟的專案比較吧，所以第一個CurrentVersionDocument可以不用輸入，第二個比較專案則先用連結方式帶入專案，再用Archi-lab的外掛"Get Documets"取得連結檔案的document來比較