UtilTest.cs 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359
  1. /*
  2. * Copyright (c) Contributors, http://opensimulator.org/
  3. * See CONTRIBUTORS.TXT for a full list of copyright holders.
  4. *
  5. * Redistribution and use in source and binary forms, with or without
  6. * modification, are permitted provided that the following conditions are met:
  7. * * Redistributions of source code must retain the above copyright
  8. * notice, this list of conditions and the following disclaimer.
  9. * * Redistributions in binary form must reproduce the above copyright
  10. * notice, this list of conditions and the following disclaimer in the
  11. * documentation and/or other materials provided with the distribution.
  12. * * Neither the name of the OpenSimulator Project nor the
  13. * names of its contributors may be used to endorse or promote products
  14. * derived from this software without specific prior written permission.
  15. *
  16. * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
  17. * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  18. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  19. * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
  20. * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  21. * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  22. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  23. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  25. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26. */
  27. using System;
  28. using NUnit.Framework;
  29. using OpenMetaverse;
  30. using OpenSim.Tests.Common;
  31. namespace OpenSim.Framework.Tests
  32. {
  33. [TestFixture]
  34. public class UtilTests : OpenSimTestCase
  35. {
  36. [Test]
  37. public void VectorOperationTests()
  38. {
  39. Vector3 v1, v2;
  40. double expectedDistance;
  41. double expectedMagnitude;
  42. double lowPrecisionTolerance = 0.001;
  43. //Lets test a simple case of <0,0,0> and <5,5,5>
  44. {
  45. v1 = new Vector3(0, 0, 0);
  46. v2 = new Vector3(5, 5, 5);
  47. expectedDistance = 8.66;
  48. Assert.That(Util.GetDistanceTo(v1, v2),
  49. new DoubleToleranceConstraint(expectedDistance, lowPrecisionTolerance),
  50. "Calculated distance between two vectors was not within tolerances.");
  51. expectedMagnitude = 0;
  52. Assert.That(Util.GetMagnitude(v1), Is.EqualTo(0), "Magnitude of null vector was not zero.");
  53. expectedMagnitude = 8.66;
  54. Assert.That(Util.GetMagnitude(v2),
  55. new DoubleToleranceConstraint(expectedMagnitude, lowPrecisionTolerance),
  56. "Magnitude of vector was incorrect.");
  57. TestDelegate d = delegate() { Util.GetNormalizedVector(v1); };
  58. bool causesArgumentException = TestHelpers.AssertThisDelegateCausesArgumentException(d);
  59. Assert.That(causesArgumentException, Is.True,
  60. "Getting magnitude of null vector did not cause argument exception.");
  61. Vector3 expectedNormalizedVector = new Vector3(.577f, .577f, .577f);
  62. double expectedNormalizedMagnitude = 1;
  63. Vector3 normalizedVector = Util.GetNormalizedVector(v2);
  64. Assert.That(normalizedVector,
  65. new VectorToleranceConstraint(expectedNormalizedVector, lowPrecisionTolerance),
  66. "Normalized vector generated from vector was not what was expected.");
  67. Assert.That(Util.GetMagnitude(normalizedVector),
  68. new DoubleToleranceConstraint(expectedNormalizedMagnitude, lowPrecisionTolerance),
  69. "Normalized vector generated from vector does not have magnitude of 1.");
  70. }
  71. //Lets test a simple case of <0,0,0> and <0,0,0>
  72. {
  73. v1 = new Vector3(0, 0, 0);
  74. v2 = new Vector3(0, 0, 0);
  75. expectedDistance = 0;
  76. Assert.That(Util.GetDistanceTo(v1, v2),
  77. new DoubleToleranceConstraint(expectedDistance, lowPrecisionTolerance),
  78. "Calculated distance between two vectors was not within tolerances.");
  79. expectedMagnitude = 0;
  80. Assert.That(Util.GetMagnitude(v1), Is.EqualTo(0), "Magnitude of null vector was not zero.");
  81. expectedMagnitude = 0;
  82. Assert.That(Util.GetMagnitude(v2),
  83. new DoubleToleranceConstraint(expectedMagnitude, lowPrecisionTolerance),
  84. "Magnitude of vector was incorrect.");
  85. TestDelegate d = delegate() { Util.GetNormalizedVector(v1); };
  86. bool causesArgumentException = TestHelpers.AssertThisDelegateCausesArgumentException(d);
  87. Assert.That(causesArgumentException, Is.True,
  88. "Getting magnitude of null vector did not cause argument exception.");
  89. d = delegate() { Util.GetNormalizedVector(v2); };
  90. causesArgumentException = TestHelpers.AssertThisDelegateCausesArgumentException(d);
  91. Assert.That(causesArgumentException, Is.True,
  92. "Getting magnitude of null vector did not cause argument exception.");
  93. }
  94. //Lets test a simple case of <0,0,0> and <-5,-5,-5>
  95. {
  96. v1 = new Vector3(0, 0, 0);
  97. v2 = new Vector3(-5, -5, -5);
  98. expectedDistance = 8.66;
  99. Assert.That(Util.GetDistanceTo(v1, v2),
  100. new DoubleToleranceConstraint(expectedDistance, lowPrecisionTolerance),
  101. "Calculated distance between two vectors was not within tolerances.");
  102. expectedMagnitude = 0;
  103. Assert.That(Util.GetMagnitude(v1), Is.EqualTo(0), "Magnitude of null vector was not zero.");
  104. expectedMagnitude = 8.66;
  105. Assert.That(Util.GetMagnitude(v2),
  106. new DoubleToleranceConstraint(expectedMagnitude, lowPrecisionTolerance),
  107. "Magnitude of vector was incorrect.");
  108. TestDelegate d = delegate() { Util.GetNormalizedVector(v1); };
  109. bool causesArgumentException = TestHelpers.AssertThisDelegateCausesArgumentException(d);
  110. Assert.That(causesArgumentException, Is.True,
  111. "Getting magnitude of null vector did not cause argument exception.");
  112. Vector3 expectedNormalizedVector = new Vector3(-.577f, -.577f, -.577f);
  113. double expectedNormalizedMagnitude = 1;
  114. Vector3 normalizedVector = Util.GetNormalizedVector(v2);
  115. Assert.That(normalizedVector,
  116. new VectorToleranceConstraint(expectedNormalizedVector, lowPrecisionTolerance),
  117. "Normalized vector generated from vector was not what was expected.");
  118. Assert.That(Util.GetMagnitude(normalizedVector),
  119. new DoubleToleranceConstraint(expectedNormalizedMagnitude, lowPrecisionTolerance),
  120. "Normalized vector generated from vector does not have magnitude of 1.");
  121. }
  122. }
  123. [Test]
  124. public void UUIDTests()
  125. {
  126. Assert.IsTrue(Util.isUUID("01234567-89ab-Cdef-0123-456789AbCdEf"),
  127. "A correct UUID wasn't recognized.");
  128. Assert.IsFalse(Util.isUUID("FOOBAR67-89ab-Cdef-0123-456789AbCdEf"),
  129. "UUIDs with non-hex characters are recognized as correct UUIDs.");
  130. Assert.IsFalse(Util.isUUID("01234567"),
  131. "Too short UUIDs are recognized as correct UUIDs.");
  132. Assert.IsFalse(Util.isUUID("01234567-89ab-Cdef-0123-456789AbCdEf0"),
  133. "Too long UUIDs are recognized as correct UUIDs.");
  134. Assert.IsFalse(Util.isUUID("01234567-89ab-Cdef-0123+456789AbCdEf"),
  135. "UUIDs with wrong format are recognized as correct UUIDs.");
  136. }
  137. [Test]
  138. public void GetHashGuidTests()
  139. {
  140. string string1 = "This is one string";
  141. string string2 = "This is another";
  142. // Two consecutive runs should equal the same
  143. Assert.AreEqual(Util.GetHashGuid(string1, "secret1"), Util.GetHashGuid(string1, "secret1"));
  144. Assert.AreEqual(Util.GetHashGuid(string2, "secret1"), Util.GetHashGuid(string2, "secret1"));
  145. // Varying data should not eqal the same
  146. Assert.AreNotEqual(Util.GetHashGuid(string1, "secret1"), Util.GetHashGuid(string2, "secret1"));
  147. // Varying secrets should not eqal the same
  148. Assert.AreNotEqual(Util.GetHashGuid(string1, "secret1"), Util.GetHashGuid(string1, "secret2"));
  149. }
  150. [Test]
  151. public void SLUtilTypeConvertTests()
  152. {
  153. int[] assettypes = new int[]{-1,0,1,2,3,5,6,7,8,10,11,12,13,17,18,19,20,21,22
  154. ,24,25};
  155. string[] contenttypes = new string[]
  156. {
  157. "application/octet-stream",
  158. "image/x-j2c",
  159. "audio/ogg",
  160. "application/vnd.ll.callingcard",
  161. "application/vnd.ll.landmark",
  162. "application/vnd.ll.clothing",
  163. "application/vnd.ll.primitive",
  164. "application/vnd.ll.notecard",
  165. "application/vnd.ll.folder",
  166. "application/vnd.ll.lsltext",
  167. "application/vnd.ll.lslbyte",
  168. "image/tga",
  169. "application/vnd.ll.bodypart",
  170. "audio/x-wav",
  171. "image/tga",
  172. "image/jpeg",
  173. "application/vnd.ll.animation",
  174. "application/vnd.ll.gesture",
  175. "application/x-metaverse-simstate",
  176. "application/vnd.ll.link",
  177. "application/vnd.ll.linkfolder",
  178. };
  179. for (int i=0;i<assettypes.Length;i++)
  180. {
  181. Assert.That(SLUtil.SLAssetTypeToContentType(assettypes[i]) == contenttypes[i], "Expecting {0} but got {1}", contenttypes[i], SLUtil.SLAssetTypeToContentType(assettypes[i]));
  182. }
  183. for (int i = 0; i < contenttypes.Length; i++)
  184. {
  185. int expected;
  186. if (contenttypes[i] == "image/tga")
  187. expected = 12; // if we know only the content-type "image/tga", then we assume the asset type is TextureTGA; not ImageTGA
  188. else
  189. expected = assettypes[i];
  190. Assert.AreEqual(expected, SLUtil.ContentTypeToSLAssetType(contenttypes[i]),
  191. String.Format("Incorrect AssetType mapped from Content-Type {0}", contenttypes[i]));
  192. }
  193. int[] inventorytypes = new int[] {-1,0,1,2,3,6,7,8,10,15,17,18,20};
  194. string[] invcontenttypes = new string[]
  195. {
  196. "application/octet-stream",
  197. "image/x-j2c",
  198. "audio/ogg",
  199. "application/vnd.ll.callingcard",
  200. "application/vnd.ll.landmark",
  201. "application/vnd.ll.primitive",
  202. "application/vnd.ll.notecard",
  203. "application/vnd.ll.rootfolder",
  204. "application/vnd.ll.lsltext",
  205. "image/x-j2c",
  206. "application/vnd.ll.primitive",
  207. "application/vnd.ll.clothing",
  208. "application/vnd.ll.gesture"
  209. };
  210. for (int i=0;i<inventorytypes.Length;i++)
  211. {
  212. Assert.AreEqual(invcontenttypes[i], SLUtil.SLInvTypeToContentType(inventorytypes[i]),
  213. String.Format("Incorrect Content-Type mapped from InventoryType {0}", inventorytypes[i]));
  214. }
  215. invcontenttypes = new string[]
  216. {
  217. "image/x-j2c","image/jp2","image/tga",
  218. "image/jpeg","application/ogg","audio/ogg",
  219. "audio/x-wav","application/vnd.ll.callingcard",
  220. "application/x-metaverse-callingcard",
  221. "application/vnd.ll.landmark",
  222. "application/x-metaverse-landmark",
  223. "application/vnd.ll.clothing",
  224. "application/x-metaverse-clothing","application/vnd.ll.bodypart",
  225. "application/x-metaverse-bodypart","application/vnd.ll.primitive",
  226. "application/x-metaverse-primitive","application/vnd.ll.notecard",
  227. "application/x-metaverse-notecard","application/vnd.ll.folder",
  228. "application/vnd.ll.rootfolder","application/vnd.ll.lsltext",
  229. "application/x-metaverse-lsl","application/vnd.ll.lslbyte",
  230. "application/x-metaverse-lso","application/vnd.ll.trashfolder",
  231. "application/vnd.ll.snapshotfolder",
  232. "application/vnd.ll.lostandfoundfolder","application/vnd.ll.animation",
  233. "application/x-metaverse-animation","application/vnd.ll.gesture",
  234. "application/x-metaverse-gesture","application/x-metaverse-simstate",
  235. "application/octet-stream"
  236. };
  237. sbyte[] invtypes = new sbyte[]
  238. {
  239. 0, 0, 0, 0, 1, 1, 1, 2, 2, 3, 3, 18, 18, 18, 18, 6, 6, 7, 7, -1, 8, 10, 10, 10, 10
  240. , 14, 15, 16, 19, 19, 20, 20, 15, -1
  241. };
  242. for (int i = 0; i < invtypes.Length; i++)
  243. {
  244. Assert.AreEqual(invtypes[i], SLUtil.ContentTypeToSLInvType(invcontenttypes[i]),
  245. String.Format("Incorrect InventoryType mapped from Content-Type {0}", invcontenttypes[i]));
  246. }
  247. }
  248. [Test]
  249. public void FakeParcelIDTests()
  250. {
  251. byte[] hexBytes8 = { 0xfe, 0xdc, 0xba, 0x98, 0x76, 0x54, 0x32, 0x10 };
  252. byte[] hexBytes16 = {
  253. 0xf0, 0xe1, 0xd2, 0xc3, 0xb4, 0xa5, 0x96, 0x87,
  254. 0x77, 0x69, 0x5a, 0x4b, 0x3c, 0x2d, 0x1e, 0x0f };
  255. UInt64 var64Bit = (UInt64)0xfedcba9876543210;
  256. //Region handle is for location 255000,256000.
  257. ulong regionHandle1 = 1095216660736000;
  258. uint x1 = 100;
  259. uint y1 = 200;
  260. uint z1 = 22;
  261. ulong regionHandle2;
  262. uint x2, y2, z2;
  263. UUID fakeParcelID1, uuid;
  264. ulong bigInt64 = Util.BytesToUInt64Big(hexBytes8);
  265. Assert.AreEqual(var64Bit, bigInt64,
  266. "BytesToUint64Bit conversion of 8 bytes to UInt64 failed.");
  267. //Test building and decoding using some typical input values
  268. fakeParcelID1 = Util.BuildFakeParcelID(regionHandle1, x1, y1);
  269. Util.ParseFakeParcelID(fakeParcelID1, out regionHandle2, out x2, out y2);
  270. Assert.AreEqual(regionHandle1, regionHandle2,
  271. "region handle decoded from FakeParcelID wth X/Y failed.");
  272. Assert.AreEqual(x1, x2,
  273. "X coordinate decoded from FakeParcelID wth X/Y failed.");
  274. Assert.AreEqual(y1, y2,
  275. "Y coordinate decoded from FakeParcelID wth X/Y failed.");
  276. fakeParcelID1 = Util.BuildFakeParcelID(regionHandle1, x1, y1, z1);
  277. Util.ParseFakeParcelID(fakeParcelID1, out regionHandle2, out x2, out y2, out z2);
  278. Assert.AreEqual(regionHandle1, regionHandle2,
  279. "region handle decoded from FakeParcelID with X/Y/Z failed.");
  280. Assert.AreEqual(x1, x2,
  281. "X coordinate decoded from FakeParcelID with X/Y/Z failed.");
  282. Assert.AreEqual(y1, y2,
  283. "Y coordinate decoded from FakeParcelID with X/Y/Z failed.");
  284. Assert.AreEqual(z1, z2,
  285. "Z coordinate decoded from FakeParcelID with X/Y/Z failed.");
  286. //Do some more extreme tests to check the encoding and decoding
  287. x1 = 0x55aa;
  288. y1 = 0x9966;
  289. z1 = 0x5a96;
  290. fakeParcelID1 = Util.BuildFakeParcelID(var64Bit, x1, y1);
  291. Util.ParseFakeParcelID(fakeParcelID1, out regionHandle2, out x2, out y2);
  292. Assert.AreEqual(var64Bit, regionHandle2,
  293. "region handle decoded from FakeParcelID with X/Y/Z failed.");
  294. Assert.AreEqual(x1, x2,
  295. "X coordinate decoded from FakeParcelID with X/Y/Z failed.");
  296. Assert.AreEqual(y1, y2,
  297. "Y coordinate decoded from FakeParcelID with X/Y/Z failed.");
  298. fakeParcelID1 = Util.BuildFakeParcelID(var64Bit, x1, y1, z1);
  299. Util.ParseFakeParcelID(fakeParcelID1, out regionHandle2, out x2, out y2, out z2);
  300. Assert.AreEqual(var64Bit, regionHandle2,
  301. "region handle decoded from FakeParcelID with X/Y/Z failed.");
  302. Assert.AreEqual(x1, x2,
  303. "X coordinate decoded from FakeParcelID with X/Y/Z failed.");
  304. Assert.AreEqual(y1, y2,
  305. "Y coordinate decoded from FakeParcelID with X/Y/Z failed.");
  306. Assert.AreEqual(z1, z2,
  307. "Z coordinate decoded from FakeParcelID with X/Y/Z failed.");
  308. x1 = 64;
  309. y1 = 192;
  310. fakeParcelID1 = Util.BuildFakeParcelID(regionHandle1, x1, y1);
  311. Util.FakeParcelIDToGlobalPosition(fakeParcelID1, out x2, out y2);
  312. Assert.AreEqual(255000+x1, x2,
  313. "Global X coordinate decoded from regionHandle failed.");
  314. Assert.AreEqual(256000+y1, y2,
  315. "Global Y coordinate decoded from regionHandle failed.");
  316. uuid = new UUID("00dd0700-00d1-0700-3800-000032000000");
  317. Util.FakeParcelIDToGlobalPosition(uuid, out x2, out y2);
  318. }
  319. }
  320. }