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

2014年5月30日 星期五

自訂UnrealScript內建型別

UnrealScript跟C++一樣可以自訂struct、class、enum型別,但是如果想要增加內建型別的話,還是得修改編譯器才辦得的。雖然新增一個內建型別並不是一件簡單的事情,不過UE的程式結構寫得很系統化,很容易就可以找到要改哪些地方。本篇就來示範一下如何為UnrealScript增加一個倍精確度浮點數型別。

由於UnrealScript裡已經定義了一個名為double的struct在Object.uc如下:
struct {DOUBLE} double
{
    var native const int  A;
    var native const int  B;
};  
所以在本例中的倍精確度浮點數型別就改叫real以避免名稱衝突。當然real寫完之後其實是可以取代原來的double。這個struct只是給原生屬性佔位用的,實際上不能在UnrealScript中當成浮點數使用。

除了加入double型別外,當然還會示範如何加入基本的四則運算:
native(1111) static final operator(20) real +  ( real A, real B );
native(1112) static final operator(20) real -  ( real A, real B );
native(1113) static final operator(16) real *  ( real A, real B );
native(1114) static final operator(16) real /  ( real A, real B );
先在UnNames.h中定義待會會用到的名稱:
REGISTER_NAME( 16, DoubleProperty)
REGISTER_NAME( 17, Real) 
所有的內建型別都有對應的屬性類別,在UnType.h中定義對應double型別的UDoubleProperty類別:

2014年4月29日 星期二

使用C++實作UnrealScript也認得的原生類別

一般而言,想要使用C++實作類別給UnrealScript使用時,通常會使用UnrealScript撰寫原生類別,這樣會編譯器自動產生對應的C++類別定義,比較方便。但如果想要連一行UnrealScript都不寫,只用C++實作出UnrealScript也認得的類別,其實還是做得到的。

C++的類別可以分為POD(Plain Old Data)以及非POD。POD可以對應到UnrealScript的struct;而非POD的類別則要對應到UnrealScript的class,也就是必須繼承UObject才行。這種類別稱為固有類別(Intrinsic Class)。

固有類別比起一般的C++類別多了一些要注意的事項:
  • 必須直接或間接繼承UObject
  • 要在類別定義內使用DECLARE_CLASS_INTRINSIC巨集
  • 若有想要在UnrealScript中使用的欄位,要在成員函式StaticConstructor註冊。
  • 若有參考到UnrealScript物件的欄位,必需使用EmitObjectReference函式或AddReferencedObjects函式註冊。
  • 可在成員函式InitializeIntrinsicPropertyValues給定欄位初值。
  • 在AUTO_INITIALIZE_REGISTRANTS_XXX使用StaticClass()註冊,XXX替換成實際的Script Package名稱。

2013年10月17日 星期四

自訂UnrealScript型別轉換

UnrealScript跟其他程式語言一樣,有型別轉換的功能。每個型別轉換對應到一個轉換指令,可在一個二維全域陣列GConversions中查表找出對應的指令代碼,再到全域函式指標陣列GCasts中找到對應的轉換函式。

如果要自訂型別轉換,大致需要以下步驟:
  • 在列舉型別ECastToken中新增一個成員代表這個轉換指令。
  • GConversions的第一個索引是目標型別,第二個索引是來源型別。我們需要修改對應的GConversions元素成自訂的轉換指令。
  • 撰寫對應的轉換函式並且註冊到GCasts。
 

範例


本例示範如何新增一個從物件轉成名稱的型別轉換,轉換後變成該物件的名稱。首先新增CST_ObjectToName代表這個轉換:

2013年9月19日 星期四

自訂UnrealScript常數

UnrealScript跟其他程式語言一樣,有提供常數這個語言構件,本篇來介紹一下要怎麼擴充自訂的常數型別。

在UnrealScript中,常數實際上是用一個編成位元組碼(byte code)的指令代表。要自訂新的常數,大致上需要以下的步驟:
  • 找一個還未使用的位元組碼當作自訂的常數指令碼
  • 如果這個常數需要使用新的名稱,可以在UnNames.h註冊新的名字
  • 修改UByteCodeSerializer使得新增的指令可以正確地序列化
  • 撰寫對應的函式並且註冊到GNatives
  • 修改FTokenBase使解析器可以記錄新的常數型別
  • 修改FScriptCompiler讓編譯器認得新的指令

2013年8月31日 星期六

修正UnrealScript不能使用out bool array的問題

在UnrealScript中不允許使用宣告使用out bool參數的函式,例如:
function TestOutBool(out bool Bool);
編譯器會回報"Booleans may not be out parameters"。

這是因為布林變數實作上其實只是個bitfield,在編譯時同一個類別的布林屬性會湊在一起,儘量減少總共需要的大小。然而如果把上述宣告為原生函式,要產生C++標頭檔時,會遇到無法在C++中表示reference to bitfield的問題。雖然可以為這種情況作特殊處理,不過其實只要改為宣告為out byte就可以解決了。

然而宣告使用out array<bool>參數的函式會遇到編譯器回報同樣的錯誤:
function TestOutBoolArray(out array<bool> Array);

2013年7月29日 星期一

自訂UnrealScript指令

UDN花了許多篇幅解釋UnrealScript底層的運作,不過卻沒提如何自訂新的指令。本篇將透過一個簡單的範例說明如何擴充UnrealScript的指令。

UnrealScript並未提供擴充機制,讓開發者可以在自己的專案裡撰寫程式碼自訂新的指令。雖然增加擴充機制不會太難,主要是讓FScriptCompiler和UByteCodeSerializer可以subclassing,不過由於不是這次的主題,所以本例中就直接修改底層的程式碼。

要自訂新的指令,大致上需要以下的步驟:
  • 找一個還未使用的位元碼(byte code)當作自訂指令碼
  • 如果這個指令需要使用一個新的名稱,可以在UnNames.h註冊一個新的名字
  • 修改UByteCodeSerializer使得新增的指令可以正確地序列化。
  • 撰寫對應的函式並且註冊到GNatives
  • 修改FScriptCompiler讓編譯器認得新的指令

2013年5月26日 星期日

原生屬性定義語法

當你需要在UnrealScript類別中定義非UnrealScript型別的欄位時,就會需要使用原生屬性語法,當然你只能在原生類別中定義原生屬性。在此所謂的原生即指C++,也就是說可以使用C++型別來定義屬性。當然因為畢竟UnrealScript還是認不得這些型別,所以不能在UnrealScript中去呼叫這些原生屬性的C++函式,通常是透過原生函式來操作。

原生屬性定義大致上是利用大括號指定C++型別:
var native pointer property_name{ pointee_type };
先來看最簡單的例子:
var native pointer          pv;
上面pv的C++型別其實就是void*。
也可以在屬性名稱右邊加個大括號指定C++型別。例如:
var native pointer          pfile{FILE};
上面pfile的C++型別就會是FILE*。
另外pointer也可和array一起使用:

2012年12月30日 星期日

在C++中存取UnrealScript函式

在C++中要存取UnrealScript函式時,一般的做法是宣告此類別和函式為原生類別和函式,這樣在編譯UnrealScript時會自動產生對應的 C++類別和函式定義,就可讓C++認得此函式了。不過如果是非原生類別,難道就沒有其他方法可以存取函式嗎?答案是當然可以,不然用C++實作的 UnrealScript虛擬機就寫不出來了。

由UnrealScript定義的函式必須放在一個繼承自Object的類別內,UnrealScript並沒有支援非成員函式。Object類別在C++中的對應型別為UObject。由於Object這個名稱容易混淆,所以接下來 皆以UObject稱之。每個UObject都會記得自己所屬類別以及相關成員,包括函式在內。可以用UObject::FindFunction()函式取得對應的UFunction物件,並且用ProcesEvent()函式執行UFunction。

UnrealScript類別的狀態(state)內也可定義函式,會遮蔽同名的非狀態函式。FindFunction()預設會先找目前作用中的狀態是否有同名函式,然後再找父狀態,都沒有才找同名的非狀態函式。如果不想要狀態函式的話可以讓第二個參數為TRUE。

使用ProcessEvent()函式時要注意如果要執行的UFunction有參數或傳回值,第二個參數必須傳入一塊代表參數和傳回值的區塊,用來傳遞給UFunction實際的參數並且傳回執行結果。例如若要在C++執行以下UnrealScript函式:
function int foo(int i);

2012年10月10日 星期三

在C++中存取UnrealScript物件屬性

在C++中要存取UnrealScript物件的屬性時,一般的做法是宣告此類別為原生類別,這樣在編譯UnrealScript時會自動產生對應的C++類別定義,就可讓C++認得此類別的成員。不過如果是非原生類別,難道就沒有其他方法可以存取其屬性嗎?答案是當然可以,不然用C++實作的UnrealScript虛擬機就寫不出來了。

由UnrealScript定義的類別必須繼承自Object,它在C++中的對應型別為UObject。由於Object這個名稱容易混淆,所以接下來皆以UObject稱之。每個UObject都會記得自己當初建立時的UnrealScript類別,在UnrealScript中可以用Object:Class屬性取得,在C++中可以用UObject::GetClass()函式取得。它在C++中是一個型別為UClass的物件,記錄著對應UnrealScript類別的相關資訊,可以從這裡得知這個類別包括屬性在內的所有成員。

取得屬性


以下程式碼展示如何在一個UObject中取得其所有屬性:
for( UProperty* Property = GetClass()->PropertyLink; Property; Property = Property->PropertyLinkNext )
{
    ...
}
UnrealScript屬性在C++中的對應型別稱為UProperty,它是一個基底類別,依據屬性的型別有各自的具象類別:

2012年4月21日 星期六

在Visual Studio建立UnrealScript專案

nFringe是一套可以讓Visual Studio支援UnrealScript的軟體,它可以建立UnrealScript專案,支援IntelliSense和除錯器,有分要收費的商業授權和免費的非商業授權。非商業授權可以免費註冊並且使用所有腳本相關功能,對於不想花錢的UDK使用者而言,能免費使用中斷點和單步執行等除錯功能絕對是一大福音。

安裝


  • 首先安裝好Visual Studio 2008並且確認可以使用。
  • 下載nFringe,並且安裝。
  • 註冊nFringe。一定要註冊才能正常運作。

建立UnrealScript專案


從主選單點選File>New>Project..,會出現一個對話窗:

2012年4月14日 星期六

UnrealScript起步

UnrealScript是UE所提供的腳本語言,透過它你可以控制角色移動、運鏡、播放動畫和特效、甚至畫出簡單的UI。UDK的使用者只需要文字編輯器就可編寫UnrealScript了。每次起動UDK時會自動偵測腳本是否有被修改,所以寫完UnrealScript要測試時只要重新起動UDK就可以了。本篇為UDK的使用者簡介如何入門UnrealScript。請注意本篇使用的UDK版本為2012年3月版。

撰寫腳本


安裝完UDK後,可以在Development\Src\UTGame\Classes路徑下找到副檔名為uc的腳本檔,在Src下的其他子目錄如果有Classes目錄裡面也有放uc檔。在先前提到的UTGame\Classes路徑下找到UTCheatManager.uc檔,然後用文字編輯器打開檔案,在尾端鍵入以下程式碼:

2012年3月7日 星期三

UnrealScript和C++之間的函式呼叫

UnrealScript是用C++實作的腳本語言。雖然有些功能可以用UnrealScript實作,不過在需要效能的場合還是得跟C++溝通。UnrealScript類別若宣告成native,會在自動生成的C++標頭檔裡產生對應的C++類別。當然這功能需要有原始碼授權才能正常運作。

UnrealScript呼叫C++函式


UnrealScript不能直接存取C++的函式。不過可以在UnrealScript宣告native function,在C++實作,使得UnrealScript函式可以呼叫native function來使用C++函式。例如在Actor.uc檔內:
class Actor extends Object
    native
...
native final function bool Move( vector Delta );