顯示具有 UEd 標籤的文章。 顯示所有文章
顯示具有 UEd 標籤的文章。 顯示所有文章

2014年3月23日 星期日

自訂瀏覽視窗

UE的內容瀏覽器(Content Browser)相信是大家最常用的功能之一,它除了列出在檔案裡的各種資源外,還有其他頁面用來列出類別或場景物件等功能。這每一頁在UE中稱為瀏覽視窗,而且開發者可以自行添加新的頁面。

瀏覽視窗的基礎類別是WxBrower,每個頁面都需要繼承自它。它的重要成員有:

  • MenuBar[wxMenuBar*]:如果有指定,切換到這頁時會出現指定的選單。UE會自動加上Docking子選單。
  • Activated():切換到這頁時會呼叫此函式。
  • Send(ECallbackEventType):這其實是FCallbackEventDevice界面的處理事件函式,WxBrower有繼承該界面並覆寫。預設是呼叫Update()。
  • Update():更新視窗。像是如果收到CALLBACK_RefreshEditor_AllBrowsers事件的話預設會呼叫這個函式。
  • IsClonable():傳回這個視窗允不允許被複製。不允許的話,Docking選單裡的Clone Browser選項會變成不能按。

2013年12月26日 星期四

編輯器的復原和重做功能

UEd裡的許多編輯器有提供常見的復原(Undo)和重做(Redo)功能,例如AnimSet Editor、Matinee、PhAT等,它們其實都是透過交易(Transaction)功能實作出來的。本篇就來介紹一下如何利用交易為自訂的編輯器寫出復原和重做功能。

首先要知道交易功能是利用UObject的序列化(Serialization)實作出來的功能,概念上就是把變更前後的物件狀態儲存起來,然後復原時恢復成變更前的狀態,重做時回到變更後的狀態。所以你想要復原的狀態必需是某個UnrealScript類別的欄位。

基本上復原和重做功能就是在變更物件時順便建立一份交易資料,然後利用它復原或重做。建立交易資料的步驟如下:

2013年2月25日 星期一

Unreal的通用combo box對話窗

當撰寫編輯器,需要讓使用者先選擇一個選項再進行後續步驟時,可以使用UEd提供WxDlgGenericComboEntry類別,叫出一個combo box對話窗。例如AnimSetViewer選取LOD和bone時,都是利用WxDlgGenericComboEntry來達成。

TArray<FString> Options;
// Add option strings
Options.AddItem( TEXT("Option1") );
Options.AddItem( TEXT("Option2") );
Options.AddItem( TEXT("Option3") );

WxDlgGenericComboEntry Dialog;

if( Dialog.ShowModal( TEXT("MyTitle"), TEXT("MyCaption"), Options, 0, TRUE ) == wxID_OK )
{
    ...
}

2013年1月30日 星期三

自訂屬性控制項

UEd的屬性視窗會根據屬性的型別使用不同的控制項,也提供開發者自訂屬性控制項的擴充功能。屬性控制項的基礎類別是WxItemPropertyControl,自訂屬性控制項必須直接或間接繼承此類別。因為UEd會利用wxWidget的RTTI機制建立控制項,開發者需要使用wxWidget提供的類別宣告和定義巨集註冊自訂類別。還要在DefaultEditor.ini檔設定屬性和自訂控制項的綁定,UEd才會使用自訂控制項取代預設的控制項。

2012年12月22日 星期六

自訂樹狀結構編輯器

許多Unreal資源都以樹狀或圖(一種以相連的結點構成的數學模型)表示,例如AnimTree和Kismet。為了方便撰寫這類編輯器,UEd提供一組以LinkedObj為名的類別,在此翻譯為鏈結物件。

鏈結物件以方形繪出,左右下三邊可能會有一個方塊或三角形代表接點。鏈結物件有四種接點:輸入、輸出、變數和事件。輸入在左,輸出在右,變數在左下,事件在右下。請參考下圖:
以下列出鏈結物件相關的類別:

2012年11月30日 星期五

自訂預覽視窗

先前提過如何撰寫資源編輯器的主視窗,接著本篇來介紹如何撰寫預覽視窗。許多資源編輯器都有預覽視窗,例如AnimSetViewer和AnimTreeEditor。UEd提供FEditorLevelViewportClient類別方便開發者撰寫預覽畫面,以及FPreviewScene類別方便管理預覽場景,接下來說明一下幾個相關的類別。

FEditorLevelViewportClient


在一般的資源編輯器中,預覽畫面大多是繼承FEditorLevelViewportClient類別加以改寫,它代表用來看預覽畫面的一個視埠,可說是撰寫預覽視窗時的主要框架。其實它不限用於預覽,Matinee編輯器的軌道視窗也是用它寫的。FEditorLevelViewportClient類別並不包括視窗的部分,所以需要把它放進一個視窗。它以虛擬函式的方式提供輸入、繪製、更新的擴充界面。以下列出幾個主要的成員:

2012年11月27日 星期二

自訂資源編輯器

自訂新的資源時,通常也需要在UEd裡撰寫相應的編輯器。就好比AnimSet有AnimSetViewer,AnimTree有AnimTreeEditor。UEd的GUI是用wxWidgets寫的,這是一個第三方跨平台的GUI函式庫。

為了結合UE系統以及寫碼方便,UEd繼承wxWidgets的類別進行擴充。原本wxWidgets的類別前綴小寫的wx,UEd繼承後變成首字大寫的Wx,所以可以依此區分是否為原wxWidget內建的型別。

以下列出幾個撰寫編輯器主視窗時常用的類別。當然編輯器不是只有主視窗而已,只是篇幅已經太長,其他像顯示3D物件的部份就另外再寫一篇好了。

2012年8月18日 星期六

自訂編輯器引擎

UEd在開啟編輯器前會先建立一個型別為EditorEngine的編輯器引擎物件,然後將它的位址存放在全域指標GEditor裡。UEd提供讓開發者自訂編輯器引擎的功能,只要繼承UnrealEdEngine自訂引擎類別,然後在DefaultEngine.ini裡指定自訂的類別即可:
[Engine.Engine]
EditorEngine=MyEditor.MyEditorEngine 
EditorEngine類別提供許多虛擬函式可供覆載,以下列出重要的函式:
  • Init():引擎初始化。
  • PreExit():關閉引擎前會呼叫這個函式。
  • Tick( DeltaSeconds ):更新遊戲時會呼叫這個函式。
  • Exec( Command, OutputDevice=GLog ):執行控制台指令。
  • PlayInEditor():在編輯器中啓動試玩功能時會呼叫這個函式。
  • EndPlayMap() :在編輯器中關閉試玩功能時會呼叫這個函式。

2012年6月3日 星期日

動態列表

動態列表(Dynamic List)是一個連UE本身也尚未使用的功能,UDN上也沒有相關的網頁,在此簡單的說明一下。它用於屬性視窗,原本字串或名稱屬性的預設控制項是打字輸入,使用動態列表的話,可以把控制項改成是自訂選項的下拉式清單。使用這個功能需要作三個設定:
  • 想要動態列表的字串或名稱屬性要加上元資料設定。
  • 在DefaultEditor.ini裡設定自訂屬性控制項為UnrealEd.PropertyInputCombo。
  • 覆寫UObject的GetDynamicListValues()函式以自訂選項。第一個參數即為元資料設定的值。第二個參數為要傳回的選項。

2012年5月13日 星期日

開關Unreal屬性編輯

開發者可以在UnrealScript中為一個屬性指定另一個布林屬性作為可編輯開關。當指定的布林屬性為false時,在UEd的屬性視窗中被指定的屬性控制項會變成不可編輯的失能狀態。

指定的方法是透過設定UnrealScript的EditCondition元資料。以下程式碼展示如何設定EditCondition元資料:
class TestEditCondition extends Object;

var() bool bSwitch1;

var() int Int1 <EditCondition = bSwitch1>;

var bool bSwitch2;

var() int Int2 <EditCondition = bSwitch2>;

2012年3月11日 星期日

為內建的Unreal資源新增右鍵選項

在UEd的內容瀏覽器裡的資源圖示上按右鍵會出現選單。依照資源的種類會出現不同選項,可以自訂GenericBrowserType類別來為自訂的資源客製選項。

但是如果要為內建的Unreal資源新增右鍵選項呢?其實還是一樣自訂GenericBrowserType類別就可以了,UEd會優先使用專案覆寫的而不是內建的GenericBrowserType。以下程式碼示範如何為內建的SkeletalMesh新增屬性視窗選項:

2012年3月8日 星期四

更新Unreal的屬性視窗

在撰寫編輯器時,如果使用屬性視窗顯示UnrealScript物件,那麼在程式碼中去修改物件屬性時,會需要通知屬性視窗更新。雖然UE有提供更新的方法:
GCallbackEvent->Send(CALLBACK_ObjectPropertyChanged, Obj);

不過有兩個問題:
  • 如果第二個參數傳入NULL,那整個屬性視窗樹都會重建(請參考WxPropertyWindow::Rebuild()),這個動作可能會很慢。
  • 如果指定物件,WxPropertyWindow::Rebuild()只會檢查指定物件是否在第一層才更新(請參考WxPropertyWindow::ContainsObject())。但如是是第一層以下的子物件才擁被修改的屬性,那麼將不會更新視窗。

Unreal編輯器的兩個世界

UE的程式碼使用一個全域變數GWorld指向遊戲世界,其型別為UWorld。開發者可以透過這個全域指標呼叫UWorld的函式SpawnActor()來產生Actor,或者呼叫SingleLineCheck()進行射線檢查看看有沒有打中物件。

從Actor:Spawn()不需指定世界可以看得出UE是假設世界只有一個,Actor也沒有提供得知自己身處於哪個世界的方法。或者至少可以退一步說,就算有複數個世界,在呼叫UE前得先把GWorld設定好。

PIE的另一個世界


然而編輯器的PIE(Play in Editor)功能需要有另一個世界以供試玩,才不會在試玩過程中破壞了編輯到一半的關卡。PIE是採用偷天換日的寫法來達成,在同一個frame中適時切換GWorld指向編輯世界和試玩世界,讓兩者輪流更新。主要的相關變數或函式有: