From 4649ff9dde34c181e3783ef7880d4adb7c3aa562 Mon Sep 17 00:00:00 2001
From: Anton Tarasenko <dkanus@gmail.com>
Date: Tue, 5 Jul 2022 20:19:35 +0700
Subject: [PATCH] Add `Vector` boxes and refs

---
 sources/Types/Boxes/BoxAPI.uc                |  29 +++
 sources/Types/Boxes/Native/VectorArrayBox.uc | 179 +++++++++++++++++++
 sources/Types/Boxes/Native/VectorBox.uc      | 117 ++++++++++++
 sources/Types/Refs/Native/VectorArrayRef.uc  | Bin 0 -> 36456 bytes
 sources/Types/Refs/Native/VectorRef.uc       | Bin 0 -> 4488 bytes
 sources/Types/Refs/RefAPI.uc                 |  29 +++
 6 files changed, 354 insertions(+)
 create mode 100644 sources/Types/Boxes/Native/VectorArrayBox.uc
 create mode 100644 sources/Types/Boxes/Native/VectorBox.uc
 create mode 100644 sources/Types/Refs/Native/VectorArrayRef.uc
 create mode 100644 sources/Types/Refs/Native/VectorRef.uc

diff --git a/sources/Types/Boxes/BoxAPI.uc b/sources/Types/Boxes/BoxAPI.uc
index 3143bcf..b4ae913 100644
--- a/sources/Types/Boxes/BoxAPI.uc
+++ b/sources/Types/Boxes/BoxAPI.uc
@@ -136,6 +136,35 @@ public final function IntArrayBox IntArray(array<int> arrayValue)
     return box;
 }
 
+/**
+ *  Creates initialized box that stores an `Vector` value.
+ *
+ *  @param  value   Value to store in the box.
+ *  @return `VectorBox`, containing `value`.
+ */
+public final function VectorBox Vector(optional Vector value)
+{
+    local VectorBox box;
+    box = VectorBox(_.memory.Allocate(class'VectorBox'));
+    box.Initialize(value);
+    return box;
+}
+
+/**
+ *  Creates initialized box that stores an array of `Vector` values.
+ *  Initializes it with a given array.
+ *
+ *  @param  arrayValue  Initial array value to store in the box.
+ *  @return `VectorArrayBox`, containing `arrayValue`.
+ */
+public final function VectorArrayBox VectorArray(array<Vector> arrayValue)
+{
+    local VectorArrayBox box;
+    box = VectorArrayBox(_.memory.Allocate(class'VectorArrayBox'));
+    box.Initialize(arrayValue);
+    return box;
+}
+
 defaultproperties
 {
 }
\ No newline at end of file
diff --git a/sources/Types/Boxes/Native/VectorArrayBox.uc b/sources/Types/Boxes/Native/VectorArrayBox.uc
new file mode 100644
index 0000000..bb8f782
--- /dev/null
+++ b/sources/Types/Boxes/Native/VectorArrayBox.uc
@@ -0,0 +1,179 @@
+/**
+ *  This file either is or was auto-generated from the template for
+ *  array box.
+ *      Copyright 2022 Anton Tarasenko
+ *------------------------------------------------------------------------------
+ * This file is part of Acedia.
+ *
+ * Acedia is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Acedia is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
+ */
+class VectorArrayBox extends ArrayBox;
+
+var protected array< Vector > value;
+
+//      Compares an element from the array to the passed `item`.
+//      Does not check boundary conditions, so make sure passed index is valid.
+//
+//  `0` means values are equal;
+//  `-1` means value at `index1` is strictly smaller;
+//  `1` means value at `index1` is strictly larger.
+//  ^ Only these 3 values can be returned.
+private function int _compareTo(int index, Vector item)
+{
+    if (value[index] == item) {
+        return 0;
+    }
+    if (value[index].x < item.x) {
+        return -1;
+    }
+    if (value[index].y < item.y) {
+        return -1;
+    }
+    if (value[index].z < item.z) {
+        return -1;
+    }
+    return 1;
+}
+
+/**
+ *  Returns stored value.
+ *
+ *  @return Value, stored in this box.
+ */
+public final function array< Vector > Get()
+{
+    return value;
+}
+
+/**
+ *  Initialized box value. Can only be called once.
+ *
+ *  @param  boxValue    Value to store in this box.
+ *  @return Reference to the caller `VectorArrayBox` to allow for method
+ *      chaining.
+ */
+public final function VectorArrayBox Initialize(array< Vector > boxValue)
+{
+    if (IsInitialized()) return self;
+    value = boxValue;
+    MarkInitialized();
+    return self;
+}
+
+/**
+ *  Returns current length of stored array.
+ *  Cannot fail.
+ *
+ *  @return Returns length of the stored array. Guaranteed to be non-negative.
+ */
+public final function int GetLength()
+{
+    return value.length;
+}
+
+/**
+ *  Returns item at `index`. If index is invalid, returns `defaultValue`.
+ *
+ *  @param  index           Index of an item that array has to return.
+ *  @param  defaultValue    Value that will be returned if either `index < 0`
+ *      or `index >= self.GetLength()`.
+ *  @return Either value at `index` in the caller array or `defaultValue` if
+ *      passed `index` is invalid.
+ */
+public final function Vector GetItem(
+    int                     index,
+    optional Vector    defaultValue)
+{
+    if (index < 0)              return defaultValue;
+    if (index >= value.length)  return defaultValue;
+    return value[index];
+}
+
+/**
+ *  Finds first occurrence of `item` in caller `FloatArrayBox` and returns
+ *  it's index.
+ *
+ *  @param  item    Item to find in array.
+ *  @return Index of first occurrence of `item` in caller `FloatArrayBox`.
+ *      `-1` if `item` is not found.
+ */
+public final function int Find(Vector item)
+{
+    local int i;
+    for (i = 0; i < value.length; i += 1)
+    {
+        if (_compareTo(i, item) == 0) {
+            return i;
+        }
+    }
+    return -1;
+}
+
+public function bool IsEqual(Object other)
+{
+    local int           i;
+    local VectorArrayBox otherBox;
+    local array<Vector>  otherValue;
+    otherBox = VectorArrayBox(other);
+    if (otherBox == none) {
+        return false;
+    }
+    otherValue = otherBox.value;
+    if (value.length != otherValue.length) {
+        return false;
+    }
+    for (i = 0; i < value.length; i += 1)
+    {
+        if (value[i] != otherValue[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+
+protected function int CalculateHashCode()
+{
+    local int i;
+    local int result;
+    result = 28492904;
+    for (i = 0; i < value.length; i += 1) {
+        result = CombineHash(result, CalculateVectorHashCode(value[i]));
+    }
+    return result;
+}
+
+private final function int CalculateVectorHashCode(Vector someVector)
+{
+    local int hashCode;
+    hashCode = CalculateFloatHashCode(someVector.x);
+    hashCode = CombineHash(hashCode, CalculateFloatHashCode(someVector.y));
+    return CombineHash(hashCode, CalculateFloatHashCode(someVector.z));
+}
+
+private final function int CalculateFloatHashCode(float someFloat)
+{
+    local int integerPart, fractionalPart;
+    integerPart = Ceil(someFloat) - 1;
+    if (someFloat - integerPart != 0) {
+        fractionalPart = Ceil(1 / (someFloat - integerPart));
+    }
+    else {
+        fractionalPart = -26422645;
+    }
+    return CombineHash(integerPart, fractionalPart);
+}
+
+defaultproperties
+{
+}
diff --git a/sources/Types/Boxes/Native/VectorBox.uc b/sources/Types/Boxes/Native/VectorBox.uc
new file mode 100644
index 0000000..75e1c3e
--- /dev/null
+++ b/sources/Types/Boxes/Native/VectorBox.uc
@@ -0,0 +1,117 @@
+/**
+ *  This file either is or was auto-generated from the template for
+ *  value box.
+ *      Copyright 2022 Anton Tarasenko
+ *------------------------------------------------------------------------------
+ * This file is part of Acedia.
+ *
+ * Acedia is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Acedia is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Acedia.  If not, see <https://www.gnu.org/licenses/>.
+ */
+class VectorBox extends ValueBox;
+
+var protected Vector value;
+
+protected function Finalizer()
+{
+    value = Vect(0.0, 0.0, 0.0);
+}
+
+/**
+ *  Returns stored value.
+ *
+ *  @return Value, stored in this reference.
+ */
+public final function Vector Get()
+{
+    return value;
+}
+
+/**
+ *  Returns x-coordinate of the stored value.
+ *
+ *  @return Value, stored in this reference.
+ */
+public final function float GetX()
+{
+    return value.x;
+}
+
+/**
+ *  Returns y-coordinate of the stored value.
+ *
+ *  @return Value, stored in this reference.
+ */
+public final function float GetY()
+{
+    return value.y;
+}
+
+/**
+ *  Returns z-coordinate of the stored value.
+ *
+ *  @return Value, stored in this reference.
+ */
+public final function float GetZ()
+{
+    return value.z;
+}
+
+/**
+ *  Initialized box value. Can only be called once.
+ *
+ *  @param  boxValue    Value to store in this reference.
+ *  @return Reference to the caller `VectorBox` to allow for method chaining.
+ */
+public final function VectorBox Initialize(Vector boxValue)
+{
+    if (IsInitialized()) return self;
+    value = boxValue;
+    MarkInitialized();
+    return self;
+}
+
+public function bool IsEqual(Object other)
+{
+    local VectorBox otherBox;
+    otherBox = VectorBox(other);
+    if (otherBox == none) {
+        return false;
+    }
+    return value == otherBox.value;
+}
+
+protected function int CalculateHashCode()
+{
+    local int hashCode;
+    hashCode = CalculateFloatHashCode(value.x);
+    hashCode = CombineHash(hashCode, CalculateFloatHashCode(value.y));
+    return CombineHash(hashCode, CalculateFloatHashCode(value.z));
+}
+
+private final function int CalculateFloatHashCode(float someFloat)
+{
+    local int integerPart, fractionalPart;
+    integerPart = Ceil(someFloat) - 1;
+    if (someFloat - integerPart != 0) {
+        fractionalPart = Ceil(1 / (someFloat - integerPart));
+    }
+    else {
+        fractionalPart = -26422645;
+    }
+    return CombineHash(integerPart, fractionalPart);
+}
+
+defaultproperties
+{
+}
\ No newline at end of file
diff --git a/sources/Types/Refs/Native/VectorArrayRef.uc b/sources/Types/Refs/Native/VectorArrayRef.uc
new file mode 100644
index 0000000000000000000000000000000000000000..d2e0866d134e4fd1bb2beb50d601dffde5f478c0
GIT binary patch
literal 36456
zcmeI5ZIcwqamVMiBm5o4Z{$78z#V$w2<hw)he6ti;~)T`P+Z`f1s1esdGIdW31NSA
z+xe^9KbhHG-7~YdAf93ZW~ZkrD=Q!VnUz)D^MC()VewD)`uoM-EtdAawAby$pBD#<
zWBco&y&o?2?XP|N>xEt4UmV#d|Mpq?`=`ZTYrD62X)T^D&Mh8UtEa8yo?Y2rJZO}T
z?7JuSms8<=-#$M#`reAspqM$?v(HEN{VVHtWbGd|s!+dge;qH*m)7vk>$1^#Zhel7
z&qv1d3%ho4@umH{Xn$R@-thU<{=RLrp?_@Do-Q8SRgHem=JCG1#A9DmuAAp=X3YGV
zNsU<}u?HrRy(G1ul)smLA2ykz{o_XE#R6TUhhN*ZS9a~Cz2CQM$dc>OKQ`$i`FqVC
z=#AwpTdN0)3)Tw@dSdUierR-p3vc<-=shrMw9D3VWWBITpOL=#-Qv5&AMEPytcR@b
z&_3U=@$Z>+9T<np#kcL97U&vop!EDro8xBNSn9pPkw&@N=10$4ZTyhMa&gtJIL}z}
zfqi<q_-AYRW1GYA$(7~eS9Y!PUb&)A^?)7Y6WO_}kq4HoF}|?R$R6*I7tyAU8$J?p
z?rFQHJLGX-BZMCQ+&DlENXEHyt^H&z5AB5n`Tk{-^h0|;G-<@xZWqhN9~Zmkf4^T`
zH|^cF_LoeLf3o*K+Fv*A#pm00<u`T>+Kh*sk;i_UW9IAN1WOL=JGgdB#kcWxB!uLH
zi))K3HpXQe-^aPM_{RA8w($fPZlzb-=kKiTEqkHq>(&ciu`l?%Z7nX_48CojxcUdX
zdc)e?vR>z{9Tv0SB;vLdJe<yQ9VOj^@VRC4l@~Ts<exDyM*35e9DeLFJZv&Tf7puq
zF8FZJJ|n+9`*+`Zfuk<Fuz}O?9lY!rmw3n{qbt1*@d>HzHr#q@ZC^BR!f)aAYn#Ih
zdp)<={Mzv3f>Ggh-Y7mb`#5hsj_mIXHV(copFg%M|CX@tLbHbZ)(R{D4enUm`$n1m
zm+YTMo||?R1l?c!#lC~ugVuW3;x~;R^Zd~$;)l=ef4Fz5ZkK%HbiW>qxHRtYUF7r9
z`UE}Zh(xa0Rri7iO(O1LXbYZQUqn>KKvFSQrprv-ZykRlrs7$6JJ)l3)%gEzqY!nM
z)`od8A{oJbi=23Upx{xn8tliZ39*h(Gzqs)jEl#O&tsdfa}4k3!ev!?@%b<>m(hXo
z>DUH;$X$G{EY`2u2>V74#8)5W>ht&U_80$UV<T~wc2GFC_-clRB)B?}7q;Q;J^CsJ
zVoirl7RPPA;3IKuINI5cg+=25j1&^Wg8sw)T{nq1PmV_(4}Ue1k>a|eIr4hZ^hAu6
z<gsut1A9U<pgp;n^zHV9rTk!5$^T@XJ56$7aV|k3AX=~2FD|}l`hDI0XCA!B9hQro
z<T2m3zGMz)<F0-CulCBi&n+%m3nFNxD(ZQ@OS31}n7;j=Ejc-F9D!VOywGM-ez4A;
z%MrM~j-yxal%v0Hz|mjNjH9Yy$<sBP(L_3DRT1{<C_)CZ-+cOsy}R9#HP@9+#$iWl
z_dFs*#yil&S4FFV--?I74Fcm&_*>v;#a?m8`%ROBM-)Y+)yVf()=pUr-Ws_JnFcbg
zx`~*W^|I3t1$2iSUoB(_dORfBg89!IWg?qr9<B$lPf_YZ!!oTGW6U1bU$ofp#fgqi
zkAb(1rydT1f;ksK_HGy3<6xj*(0Kcpch_Vi#M8L%4&NAE=oX{DD=cGlAz6(6?r|$t
ztQmhEv{=2@;#V&}9Y^r1&1cAw4s2fd*^b#ho>(Jic+B~Ri1-;eM-+|-n(=j5cLF<<
zV}LbeQRL#D4QBd`PPIz!AkS}GOZCTtlu6@Hl@=)A>lsHi#)v$a+&5Ouo?Awx;J)>w
zF7~w1@8vup?|zO?rQ*ee6yYT15OeluKPSD*CTp@?^1gZLQ6ZzHviOJgiM3<QxysdZ
zwmpk}$eH}_rzBmj@%pY^&l!#)K*$~>+g$Qc9cmRDshZL#imBwS%Cnb-(-}!GnT_OC
z-O5JrNZ@^**~}s~5!0bcrOMYj$mwbO_b5qgdkdN4$?FB!$2vP2YGU3i-4BO-Y8F|o
zkLY-4(q3<SXhl|w?cHxH1*myW#HuIoz-wS(6<%+UX2J^5|8|yI`5$uC<3d(5%?*`B
z)`+SlQH6*#x37-yq^DLdM!JuzE$g2j?eCb&_BMj0u?}*y_%=zfkH2;9fgBZ$*Xt6g
zyW}gLoKAWfNkrKzJ7L|Rv&R-?nauru!*lXump6Zri+OfP&ET-f=Ult`pyhz*rRL-G
zsg=phk?(IXGkQif%B|wSIPmHk2&wTxvi({cnAJnftU;HA5VI#)@YyRKj#uaHlPY4>
z#wy}^Jd1S&^FLSOq_j}cEoAh-Y*`f^_JQ!*uw#0Ex|p1G7@50cYW}W=#Hv?}Tl+fv
z%eJzuUR)7anhOi8zMT<1b8|Krf2FN{LAG9g5#CI;<*Pd~5h}HALs+xd2)(-VV)2j7
zqka9w`Ubq4_Ngivu>E7t10?ZR6S?BN9Smz$Resg7=JLu*hK*kFUYQ2jx1+}Q!s>`u
zPjbF1hQ#dUN`ou20N>m7otH5pd;M9lmww=H-5U#ws_4V2+4D%|aAchHFyBWA6uoCw
z$i5_0SsMm*r{z^cY}c#mWRAPWm&PFGswy*Hc~rdLOiJu|gfun#v8<Gzq6PS7zEyHn
zK0*ma3(ribe-LGrnaoEG-(MiI)+j-2aPRlE!{_+mID{_IPsD`HY+x=<Y(~L%jXZX|
zK8f?P0DqrHiRo{D*{m%r^t$1#XDma1ukppPL_C}pb+Ye~!>n4J&XH$jpXc#~h~s`E
zPs#r7K15BB>K}1gyT;i|@SEycx7%))@IrfJ@?4EX>|_1OT2hg3?A7qYjtMP>nJy;~
z#xtfRV;z~DfqOZR^|{858Wm`-L95Ox?mYV#BWBDr({-%fYqmY^(?=u8Be2&qSg_S&
zeXiJowvy87jTeEn`OE;hIatGfBQnDxeDBV8pNK!cT5?GcsbW33Yu^Qq=WqIJD>yyh
zUYlb+bMP4Amd}_GQ{Wz*`5qbT3f7yheR1Y%kZLKzwF~Dwo|zP|VA_Y)<ZrxRYcUM^
ztWIOMU9$PU?Psy-;@gKtr7wrOrUh9jd(vo%RjprxgQJt(x2h}g!XB~D8&6=g)5en;
zU$G)b0w1XtN2lyu^&a#k$!{V>_G)Sb#Y)a@h7~7onyfzd?6!I(`jAJ2-{@*+ycaR$
z6NhgsQx;g?4+eXtoAx_4^w~50!?E*LBi^QTazqDNZ#7JNX!D+?mn(%n8{Y}S8kNm@
zZ^vzKqqSzpjWwp%;n`!}_EoJ@xKX**nCMJMNd5au`}g1Wa@5c_^{h)>$2x~|W9GR|
zOV!uI(-{u=ZE#y>qkJwT_{Bg=n(zGhA@kSW>}+n9(o)T+6w%2wV{e6-cpYJyA5PNI
z>X*$DzB<{((I|cX#<stiRH-^GN2e4t*4T!JRKGWL9(vu~fd)h^G~DmC32o;$w0*j<
z##DUl@qDYbRSnPC#N0~#rbP|%bz(Fb5~tywv>bpsX3Z@4e(t0K(TyC1Y$;c8!01)-
zn!F}PAD1kn0Efq;k&C$Pk_Y5y>U;j=i>z>it2_=?>-l4>0n`t9sbWc+s9Up+&H1d(
zo+=xzT;d(@5Se|Zg+#Dv?@NZxX-ZH4nRsr+X+p9D_|X{b2Rt9}p^P89V9uWLGY{#H
ztChRy%2>^g0@2(*vQ>;}_Ou)tU=E&b2h~loC8R*zSaMk{HqAMO8y`yUnWc+Q`PvdK
zdWIhod}7|{>z8T03ekA4S$y>vJREyGtNc^r-ZD$on)p@o26V`5+{cETyOsM&k5vgP
z)HpAgZJD)$-|d0tWJ^CT9x6_JKXz=deOwBQ&6qL7rcZI-BHJe!!|AhZ<vS50Ki-@&
z&yfu7T9cfgIP>^}9Y)?!^H;~PK+Iw0nEQ?O6RV%#LKL=%{xOPBiM`WDHWSbTPYn*;
zs}#++j^E1%70IT&pZEu_)QagvL>yMAhzB0`Ii1W28<2v(9=AM?s@CTShh|(aE<x8}
z&0&O)XNCQrIx6m(WxCJx@Ud5KnDbdyRW-LK*6D0a)ZDzyI)7F_G7Ft0ls69}oz4e@
zSJTIPK0U!IPRioznI~GTngrsM!=2{)+%1t~XwIaEXB_gVve5h<Qm*ykm=!4F*;7<#
zm+cxHdVZbxu6gK?A2iyVk9dk1Du)5Z;uJ(=G17r&>K+B_-LP2`+RI;cvl{ZKx_)B+
zh6tmY%2X{j>w!58z4l7858a<T#{SIX%KD=(pE-zA&&*}{i{mMII<0(Xog_@gIy~Jj
zPxD@5+YFs<e_ra2X<T=2>D1J2i$qUsUoKaSm^<3u^cA)(B=(;9UQA-;@YJ@qnvz@(
zS(IbNh_WZIiA`~w{bG1xDJ;F>Qg1A`#ju{5*EkQS8LRdQ`uTnwRb1vU@p8ihvJ<ax
zgr)jflAzp2N#O|I;5C`-SKHv*?whCqo;q&jJu1}$q81U}7F?dUzPpA~P|$uAzKLh(
zbgtIYnLF75c^rEo+_j*&abDH$?_`c}$NL!DbiY2khE#Zj0j$rs;{)$?e;w{K4Y5|T
z6jyhwr{BXUo*YfVI5-i?Pi3Ql0#F<x-A$wNvG0xCYLePDX;BgC<t6B~BA&GH_Hacp
z>MU^NbwOlVPWBAn)6Mq~WK^UYsC%~5+mS<`f>uQtugFSTbuJaB>U`&LDb7gc^;Je0
zS$(Xf@Ga#+x*8~eezO-cch+R^t$N{CtxZ0ARXyi&^I+k~cBlL$A4zlf#1^YZ`^f;$
zjNGd=lkLuQeTqKrHY2(2Y~jt>vg7X>tM8g^kXK5NXJhAK4Y7MptXgOF*>mxVoCi*w
z`ojaF!Y=#wnnaF;VR6|L;A*^oF;yqT4^^LtU4GwR@JOyv;+Znl*Cd&r=W~*aQ`>zb
zC!xnU!$2<Jl%Ip_pL!t6sMTcU6z<Jgnwkf6+0DqOKG<*e+>15LrWJiE`RMZO>J`KN
z4v&)JTplH)$`YzN`xH?Jo07dqQXgV|F<pJtN@*^ZhpmJ(Tnb(Z!d}OfoWR<*pHYaz
zer6GQf-(r<Jh-=ABwn9sWPHfpq`1#Mk5|R3e`yXs4-==nJIlZ^+E*Ey<s^Ad;!_x}
zl@O>3(&aq+(wlXfuS4?s5jvkDrnrrUWOmE~wVLhU0UOrZTdfeCTnFSY+Oet`%(_!B
zF+$CY#%Exr?uO6a9)DMA!z}CAqT+!)SETY<*ClhfG`Gf(m1YFT+heA9zT_?xKz@#C
zweGmGp6^HI<!2w}aYeCQ9{PS~VWEXjHS-DyNOM`gHA;Mnh?#x((i@+BJ5}n?MIVbD
zR{}*&i^#otvY-D{MkWNS?{j#lmOa|*PmnH6veSESW7?i+unRq`J+YGZdu-Hep0;Nf
z-Ztxcm}7?2>zKnm#CIF*@KwbO>TE=`T1|Ktaqe^G`#JOF$-m086-m4T^nN_4W0?6m
zueFvJ`0n54O30>I8>ln=*TEp`%vtpM7!cK&JC;S}Cs1m{UJFNs_~v{%6IFBIbqE$T
zV*HAUZzpr_jr%!=-?n=CIfwTrr^{D}pdWhmG%!QR%dAv8{G7w*yl#l`n^aVXeLmE<
z(96v~q`W^Oz|`3*qFk&1=GGKB?+>~W(Ke5l*}8_Sh92b_E4N)gtfzRo=nG=>R}#Gu
z-(K7$^U^s!uaNs)O4J$iv&#Ib*Q$)MQ|USQs;z>iPt4UCaXtIDV|BK8X1`~zoUvhd
z(VxT2^9OWCxbH*i*`n*7G$Q^KcZTm*+DcYWW&y`_#*&>v>i0+^SI@ETeBVawnEKrv
z5fz3Jpzg|Pc30obZTCc$&f~475skgF?~ZH_f%B%iCJMgN7EjzCmZde;U*$^@`KCQn
z0b7hyp;Scq#8dMbnVpcl!;0LP^(Ge6J2@(z$LFUihG3l^`-vvzD0#>dYP~D(vPf%D
z-ClR{k|#@X?#+A3cE;AX>56N(nsU3KF2pm(5A1(p+|<5+kD^(;?w)m0+#Eg`{kF}6
z5wJ%2Hx;yqK{?9IkD+g~^hJBTzp2)G7l(7woZ3AR4ZT;3$KT?~l4>)2ulpwYwtp3R
zP+i9ln$!Kyb%oleUq_pp#oXQvc1R=yN!H=lT=dy)XOcZ2My<8VdcPeO=4WRkRtJLS
zUD9=@KIPTIZ|3Qv^Pcynf<7|;?Vw7#+j{vk$9;$D-ASx+CW~0veZTs32hQpa^8&OQ
zr|f($JY)X$XW5Y$=lo<hwW5@90S#4r$#oym8KT*`YRnX_jkCavMU@XpPbjiI&aLz1
z>W#xWYW(WK^;4w~zp60j%Qp>W{8!7AE#hUK(T%f_@Mh47?1_7TSEgGs2J$iN2|j|R
z@-<qaK|L=id!u$jw?l-m?@Vjx*_l&Gk#~7`<cyW?pib){)!J5b464G7+79VtevpYI
zHyn?i%JTCs5pWjO?>MYy`L>gt_<Nt~&o_(R%;i&AhBcR}c~_Obv~=36>3zeQEQOj=
zt;3o?L|>))O1>|xcb8Z2TXdZK#3Q)_m#BfY`xTF#+gdq@!`X93CqDzleO!1D@tp5D
ziO$FwMOa()Tk(y4iD=!5wohegzs?524%crxh7NfJhfc9s(9xgT&My~ALa}yrT+Q4I
z=cZ=rb08<jhVoNwW8KSjmzU$r%09=cHdcu46^=;a&!yVq$o0{e3v+YMK4YPLVO($F
zehIA(dvffdo3fUE`zf^e!K}mWZO6_FU@d_gwL+)ooY026V_31PdCI!g&FRKnH)@Ti
z*nO<oa)xxl<`6IG0Zcl!9{w~Pe=Z2Wnn~RWgkdf1&(4Weihi%vty#auCfZ~IF5PSP
z&br3e#Gacg*35fwtcj+mDc2Xho&|UW6@O97%=%{jAdc?ncT0$0P8$Di5S~tU!5WeC
zwE1_`vW98L>Od02hIB1X#^tM3ZasVNtr{fv{O)xLM&@_=uG{>sy!j11Di=45lOOGU
zyJy<zSzk4BZpzd1i81BFArn2ZM3N(3^j9s}_A6J_Gc|@N`g5xO#pqHWijg;|2>sBs
zh@TO$<VQP2&p{FW4)t0&mEJa;i|m=ZZ1of?`6j=AgUyAkhtKB0+G(Mc38%5SFNoin
z;r~aa3YO`xw{p!|lUp#}b+iB5#shrsTP;koWyUf8A!5pgJTnX2{XX$LJefPyYD_~s
z%u$Fo-d`M5tw_o@8ai<2E&s^fJo>xVs8b;q(R8~S-tow{>-@0Nsl4>7npwt~r`Lr;
zS(nczOVZDa`ST|8_0aj<E+zTWuu`CkW%S2y*>SJ-zg+x7lbOfU%(-~&&p_X9Ce8Wk
zp=fC?=+U{_gnC5@(bD@o_i81p>)Y@;YZ=<Ns1Dz=UN@PUP7vmP<CF5kQS^D(YtFya
zNADG{=dYrzzJ4o}9F3Vhc?{^Zi6qwJ_K^BIoe3K%K2DG0bHP7^MZ1PRiaX&|<RRo+
zam8_*&pb82_fYvIo_m(V#_Ea_v_BZ$vmUx(6xf%k8Qqokd;x!62YC{AjCieh_zMI6
zJV#nSwj7yikmNm#uq*r4*TBRPVXBY2ZLY;UC69>1T>abST@|@E&5eYRL{~+eX-c&g
zgs%uqYM&m}&ErhJ_xAY`-b#$@)9XDUK;A!&dz>Z@%lgIQ7xuXqhw{4Zpjl)u4ryJ|
z$Mbm{m&C{Ty&f<7I9ac12J4W1s+VN$Pv@<6A^GYZ4V`N`8fGqPQE^pQr!<PThm@Sc
z7}I`l_;YBvpI2mRRY<tzwJ}bB@Kic5!)sf#RyL{%K6$NYq#&y(=+|QCxoj&T*1M1G
zZ_VLDLOvnfTsE#Y@)o3_Ys1X3T6zz&o><=pgOkgC&Fw6*e~)r`gr&u=<>KO?w=%D>
z_hycL3?fS3S1aeT%W2w9uSVcXeQKpC+If{m6>}^Xwe0&$)QG0J4C%qC<neR(6pcO(
zR8H$B@tgDXZKYo4)6?nuAa%*;?5sl+x0iagvXGxs3KSjw-tDj+6&2N8L%OH|?bz!5
z-r_$EKdD}Uon8+(vRH|xtA=}sAS>^^5BGR;|D3yAGNkrjow;e8uxIbD;N~0S>@Nf4
z$kZa6{kq)$O`f1vP`lHzVa~5rjYJC{&oOO|Q>xb?u}V#T9W8<?k&!b9oa@7%tDMDg
z)qd=p)N!hx#%M81pGSP-d`#c{A<iSG7*@l5jT{tXtlIKy=cXv`C%TX!znVupn?K*B
zHd-szJg+bNu?)16I6Zf7F+Jz)^s3fXzx7kK5ba;NeFQpC6OVJ0{yXBHX^}%wlL}w=
GUjGll0i7NI

literal 0
HcmV?d00001

diff --git a/sources/Types/Refs/Native/VectorRef.uc b/sources/Types/Refs/Native/VectorRef.uc
new file mode 100644
index 0000000000000000000000000000000000000000..bfc2cd0b83c4caf5f6405f8e30ae8b67cc68508a
GIT binary patch
literal 4488
zcmd^?U2hXt5QgWvQvbtVI#sbNdIxRQ5D^+F1w>3~dWG%SiCbg4Ylq+<{yOx1W_&oi
zn?=RBLP9J1eC(Y0c+Y(8hxa}EPS3aYjTIUTJ$<{dsjW1dXq?$tv$1At?T@Y0D&8)9
zeq{rv9oVHP7Iw$ZMKyQIfp*4r=A25sd!<=$VH|6{6#t+?8XT*dyw<y!_@Y6n|A~H#
za~tV@W!)Mzy7L@}&(b!coJyAqNh<8F{h;4n&GvN~J?EPD#lLj@;rWktlk_{X<4b*#
zj_o%Uce8ZMuzVrZuo}e9gvg+RTIN)JpYC_!ScCn_xvY)52LF57+i34n<4Aj8$v*s7
zLKozR?hl;Ca|)+Avz|`jL9aAIJrSR*MNnRf-<h~USM`=sr|`<KD7|@PkL|g3AL&H$
zx|!BbC4VUInM%XLj(vn;B|5Z$)AA$D%6%J89o95TQV!idPM)~@j74FG+6kTU<f&G3
z`(Bi<-G<e6r?4NjSJ%C+6=&)Z(2<^C7g&P_o}FauX$|%pjVX$tsmskVl5uXk?Y6rE
zkEtZ&d$@27zyV}JySTM0QO@*$Anz|7>50af(8#jGFA95MM~c7S?1^r#FZzAm<Eh3M
znmyCQy04x4+JiUpz!^NoZevxi={A>4^$xAWQ;BV&9fUwWYw^21l#Bz(4>|kxK>8fJ
zPG}Kcdg$xNqCL^WO+V2obj82WvoDGRS#aztcAsnaspw90sw+A?X6%TBFJ&EW=edz3
zBZ7#z!eeDEOToXI6SJgKM~*lS3}=oJ_lK`U?2;d*z6QU6ej}YCj|O(x2X3Qx)`g5t
zgq(|Sy4PlY0<|O0TXWH_J(`GHbp1&-to1Bq%{}Flp1AOI#c?kG=;}nNc~5eP{S@;n
z?fg>7eLeSvk*LT8WP?9MI}&HkKhvDNIkq?2fyddFCRL=MxbIxBj#@?ZE%lGi!7IG6
z%9;2~Jo4$bQ^XFHF2y_kM>KMJYS)rbTF3TWgST7XjtZD16!vq)vW}`?SHFoP+BV-)
zykX6|k9OVc53qbK-Ad^KZe)Bg3tO}7w#-x5uTGiHgL*=P{8#6db5B$?WYl|rEF<nS
zXY`S{(Z2*<%$sP|Z-x4?{sf-L%^GJ5cgO0Dx(eb7yvVp{hp#katd2vLnC;CG^(A3C
z@#v1a5QzS{Bc@$N-0rw;zB*h_cgA&d3tX?iI$ZzS8Q1I2!1chpC8{3ZEzLYvjc>kR
z=vt!kk+-6<e=72$(;uk+A@|b(UsZBy)Pq936#LcMLp@*AG^zG_|DSK++|1=vhI)QZ
zQc@qy*8*K)boVb?YVJ$%4b6gb;d<w;hfGWtLzgmgRLP?J&Tmxr+g5|HBRV%~LcLNn
zG5(wi+&mK*F5OPOzR>B+gkv)cHmzyav!T}&I`AX;*hBkQ6%PzM>PCn5x46<vP-)^e
z%GTb2?ksMpy(7w}ABZyL>SRgtZN2}<omHo%MI8;k3JYo7#*1!-$N*2if8N&mo}@(`
zPa=rUc)Ue4QALlFR`oMEBC!CeO>Me2`ncRP@%4&SzJ2Ia=?ItFE4AVaW#w9j?s4ir
DJ6g0s

literal 0
HcmV?d00001

diff --git a/sources/Types/Refs/RefAPI.uc b/sources/Types/Refs/RefAPI.uc
index d271940..82ee688 100644
--- a/sources/Types/Refs/RefAPI.uc
+++ b/sources/Types/Refs/RefAPI.uc
@@ -169,6 +169,35 @@ public final function IntArrayRef IntArray(array<int> arrayValue)
     return ref;
 }
 
+/**
+ *  Creates reference object to store an `Vector` value.
+ *
+ *  @param  value   Initial value to store in reference.
+ *  @return `VectorRef`, containing `value`.
+ */
+public final function VectorRef Vector(optional Vector value)
+{
+    local VectorRef ref;
+    ref = VectorRef(_.memory.Allocate(class'VectorRef'));
+    ref.Set(value);
+    return ref;
+}
+
+/**
+ *  Creates reference object to store an array of `Vector` values.
+ *  Initializes it with a given array.
+ *
+ *  @param  arrayValue  Initial array value to store in reference.
+ *  @return `VectorArrayRef`, containing `arrayValue`.
+ */
+public final function VectorArrayRef VectorArray(array<Vector> arrayValue)
+{
+    local VectorArrayRef ref;
+    ref = VectorArrayRef(_.memory.Allocate(class'VectorArrayRef'));
+    ref.Set(arrayValue);
+    return ref;
+}
+
 /**
  *  Creates reference object to store an array of `int` values.
  *  Initializes it with an empty array.