Revit二次開發，在winform中製作3d預覽效果

目前，見到使用的三維預覽，是以二維平面生成的線段，類似如：

那麼如何做到真正的三維效果呢？我們知道，要在winform中生成三維，那一般得需要有3d引擎。但我們不太可能為了某一個功能，跑去開發一個3d引擎，如果真能開發出3d引擎，那麼你自己就可以開一家公司了，光3d引擎技術就夠你吃香的喝辣的了。

言歸正傳，本文是使用Revit的三維效果，嵌入到winfrom中實現的。

正文開始之前，先看下最終效果：

請注意，此三維預覽，是在winform中先預覽，然後才去Revit中，生成你的實際效果。而不是將Revit的建築預覽到Winform中。

一、首先我們先實現IExternalCommand接口，製作一個插件

<code>using Autodesk.Revit.DB; using Autodesk.Revit.DB.Architecture; using Autodesk.Revit.DB.Structure; using Autodesk.Revit.UI; using Autodesk.Revit.UI.Selection; using Previewer; using Previewer.Extensions; using Previewer.Runtime; using System; using System.Collections.Generic; using System.Diagnostics; using System.Linq; using System.Runtime.CompilerServices; using System.Text; using System.Windows.Forms; namespace Rotation { /// /// Revit預覽 /// /// marc [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)] [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)] [Autodesk.Revit.Attributes.Journaling(Autodesk.Revit.Attributes.JournalingMode.NoCommandData)] public class DefaultCommand : IExternalCommand { /// /// 執行指令 /// /// /// /// /// public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements) { var activeDocument = commandData.Application.ActiveUIDocument; var document = activeDocument.Document; IDataContext context = new DataContext(commandData); RevitRuntime.SetDataContext(context); Result result; Transaction tran = new Transaction(document, Guid.NewGuid().ToString()); try { tran.Start(); IWork work = new PreviewWork(); result = work.Run(); tran.Commit(); } catch (System.Exception exp) { tran.RollBack(); result = Result.Failed; Debug.WriteLine(exp.Message); } finally { tran.Dispose(); } return result; } } } /<code>

上述接口實現，裡面就一句核心代碼：IWork.Run()，也就是說業務邏輯的代碼，已經放在了Run方法中，那麼我們看下IWork接口

二、定義IWork業務邏輯接口

<code>using Autodesk.Revit.UI; namespace Previewer { /// /// 邏輯作業接口 /// /// marc public interface IWork { /// /// 運行 /// /// Result Run(); } }/<code>

三、實現IWork方法

<code>using Autodesk.Revit.DB; using Autodesk.Revit.UI; using Previewer.UI; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Windows.Forms; namespace Previewer { /// /// Revit預覽的具體邏輯 /// /// marc public class PreviewWork : IWork { /// /// 運行 /// /// public virtual Result Run() { this.ShowForm(); return Result.Succeeded; } /// /// 顯示窗體 /// private void ShowForm() { var document = PreviewConfigure.GetOrCreateDocument(PreviewRealtime.ProjectName); using (Transaction tran = new Transaction(document, Guid.NewGuid().ToString())) { tran.Start(); var form = new PreviewForm(); DialogResult result = form.ShowDialog(); if (result != DialogResult.OK) { tran.RollBack(); return; } tran.Commit(); } } } } /<code>

如上述，我們的具體實現，只是顯示了一個Winform窗體。

四、我們在顯示Winform窗體之前，先創建一個自定義的Winform控件

自定義Winform控件的界面如下：

​

五、下面創建一個Winform窗體，並載入上面的自定義控件，界面如下：

​

右側看不見的區域，就是自定義控件的東西。用來顯示三維預覽的。

六、看下Winform窗體的代碼，講解下：

<code>using Autodesk.Revit.DB; using Autodesk.Revit.DB.Structure; using Previewer.Core; using Previewer.CustomControls; using Previewer.Runtime; using Previewer.UI; using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Windows.Forms; namespace Previewer { /// /// 預覽窗體 /// /// marc public partial class PreviewForm : FormBase { /// /// 實時預覽對象 /// private readonly IPreviewRealtime _previewRealtime; private Preview _preview; /// /// 構造函數 /// public PreviewForm() { InitializeComponent(); this._previewRealtime = new PreviewRealtime(); this.LoadPreviewControl(); } /// /// 加載預覽控件 /// private void LoadPreviewControl() { this._preview = new Preview { Dock = DockStyle.Fill, Location = new System.Drawing.Point(0, 0), Name = "Preview", TabIndex = 0, Text = "預覽", IsVisibleDocuments = false, IsVisibleDropdownList = true }; this.PreviewPanel.Controls.Add(_preview); _preview.SetDefaultDocument(this._previewRealtime.Document); } /// /// 預覽效果 /// /// /// private void PreviewButton_Click(object sender, EventArgs e) { this._preview.Clear(); this._previewRealtime.Build(); this.TipLabel1.Visible = true; this.TipLabel2.Visible = true; this.TipLabel3.Visible = true; this.TipLabel4.Visible = true; this.CreateButton.Visible = true; } /// /// 真正的在Revit中生成想要的圖元，效果等於你在預覽圖中看到的一樣 /// /// /// private void CreateButton_Click(object sender, EventArgs e) { var document = RevitRuntime.DataContext.Document; IDraw draw = new Draw(); draw.Demo(document); this.DialogResult = DialogResult.OK; this.Close(); } /// /// 當窗體關閉時發生 /// /// /// private void PreviewForm_FormClosed(object sender, FormClosedEventArgs e) { this._preview.Clear(); } } } /<code>

我們使用LoadPreviewControl()方法加載了三維預覽控件，初始化了Preview對象，Preview對象是自定義的Winform控件。

預覽方法PreviewButton_Click()是一個點擊事件，點擊後，將出現預覽效果。他的核心是調用了this._previewRealtime.Build();

預覽效果滿意後，可以使用CreateButton_Click()進行確定，並自動關閉窗體，然後在Revit中生成剛剛預覽的效果。

由於之前預覽時生成的預覽效果，將以族實例的方式存儲在Revit中，所以，我們在關閉窗體，或者多次預覽時，都需要調用一下清除方法：this._preview.Clear();

七、看一下Preview自定義控件的方法定義

​

IsVisibleDocuments：是否顯示文檔選擇列表

IsVisibleDropdownList：是否顯示下拉列表

Clear：清空當前Document文檔已經生成的預覽對象

SetDefaultDocument：設置默認操作文檔

SetDefaultView：設置默認視圖，不設的話，我們默認為3d

八、生成預覽的接口定義

<code>using Autodesk.Revit.DB; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace Previewer.UI { /// /// 實時預覽接口 /// /// marc public interface IPreviewRealtime { /// /// 預覽所用的文檔對象 /// Document Document { get; } /// /// 創建 /// void Build(); } } /<code>

該接口定義了一個屬性Document，代表將在哪個Document中生成預覽效果。

還定義了一個Build()方法，調用該方法後，將即時在此Document中生成預覽效果。

九、繪製圖像。也就是建築了。

<code>using Autodesk.Revit.DB; namespace Previewer.Core { /// /// 繪製 /// /// marc public interface IDraw { /// /// 製作一個demo /// /// 操作文檔 void Demo(Document document); } }/<code>

由於我們只是為了Demo，所以繪製方法裡，就只寫了一個生成Demo的方法。實際生產中，可以自行更換為您自己需要的方法。

最後，你就可以生成這個dll，加載到Revit中進行實際測試了。文章最後附上了完整源碼，並帶有完整註釋。祝您用餐愉快。

源碼下載：https://download.csdn.net/download/mazhiyuan1981/12915401