Add parsing for scenegraph material definitions.

This does not yet convert the material definitions to unity
materials. That will be done in a follow up as there are a
bunch of different properties that will need to be handled.

Author: ammaraskar

.gitignore

@@ -22,6 +22,8 @@
 
 # Autogenerated Jetbrains Rider plugin
 /[Aa]ssets/Plugins/Editor/JetBrains*
+# Jetbrains Rider directory
+.idea/
 
 # Visual Studio cache directory
 .vs/

Assets/Scripts/OpenTS2/Content/DBPF/Scenegraph/ScenegraphMaterialDefinitionAsset.cs

@@ -0,0 +1,11 @@
+using OpenTS2.Files.Formats.DBPF.Scenegraph.Block;
+
+namespace OpenTS2.Content.DBPF.Scenegraph
+{
+    public class ScenegraphMaterialDefinitionAsset : AbstractAsset
+    {
+        public MaterialDefinitionBlock MaterialDefinition { get; }
+
+        public ScenegraphMaterialDefinitionAsset(MaterialDefinitionBlock material) => (MaterialDefinition) = (material);
+    }
+}

Assets/Scripts/OpenTS2/Content/DBPF/Scenegraph/ScenegraphMaterialDefinitionAsset.cs.meta

@@ -20,6 +20,7 @@ public static class TypeIDs
         /// </summary>
         public const uint SCENEGRAPH_TXTR = Scenegraph.Block.ImageDataBlock.TYPE_ID;
         public const uint SCENEGRAPH_LIFO = Scenegraph.Block.MipLevelInfoBlock.TYPE_ID;
+        public const uint SCENEGRAPH_TXMT = Scenegraph.Block.MaterialDefinitionBlock.TYPE_ID;
         public const uint NHOOD_TERRAIN = 0xABCB5DA4;
         // Neighborhood info
         public const uint NHOOD_INFO = 0xAC8A7A2E;

Assets/Scripts/OpenTS2/Files/Formats/DBPF/GroupsTypes.cs

@@ -0,0 +1,61 @@
+using System;
+using System.Collections.Generic;
+using OpenTS2.Files.Utils;
+using UnityEngine;
+
+namespace OpenTS2.Files.Formats.DBPF.Scenegraph.Block
+{
+    public class MaterialDefinitionBlock : ScenegraphDataBlock
+    {
+        public const uint TYPE_ID = 0x49596978;
+        public const string BLOCK_NAME = "cMaterialDefinition";
+        public override string BlockName => BLOCK_NAME;
+
+        public ScenegraphResource Resource { get; }
+
+        /// <summary>
+        /// A dictionary mapping material properties such as "reflectivity" -> "0.5" and
+        /// "stdMatCullMode" -> "cullClockwise".
+        /// </summary>
+        public Dictionary<string, string> MaterialProperties { get; }
+
+        /// <summary>
+        /// A list of textures used by the material.
+        /// </summary>
+        public string[] TextureNames { get; }
+
+        public MaterialDefinitionBlock(PersistTypeInfo blockTypeInfo, ScenegraphResource resource,
+            Dictionary<string, string> materialProperties, string[] textureNames) : base(blockTypeInfo)
+            => (Resource, MaterialProperties, TextureNames) = (resource, materialProperties, textureNames);
+    }
+
+    public class MaterialDefinitionBlockReader : IScenegraphDataBlockReader<MaterialDefinitionBlock>
+    {
+        public MaterialDefinitionBlock Deserialize(IoBuffer reader, PersistTypeInfo blockTypeInfo)
+        {
+            // TODO: there's some special handling needed for versions < 8, not implemented yet and probably not
+            // necessary if there's no files of that version.
+            Debug.Assert(blockTypeInfo.Version >= 8);
+
+            var resource = ScenegraphResource.Deserialize(reader);
+            var materialName = reader.ReadVariableLengthPascalString();
+            var definitionName = reader.ReadVariableLengthPascalString();
+
+            var numberOfProperties = reader.ReadInt32();
+            var properties = new Dictionary<string, string>(numberOfProperties);
+            for (var i = 0; i < numberOfProperties; i++)
+            {
+                properties[reader.ReadVariableLengthPascalString()] = reader.ReadVariableLengthPascalString();
+            }
+
+            var numberOfTextures = reader.ReadUInt32();
+            var textures = new string[numberOfTextures];
+            for (var i = 0; i < numberOfTextures; i++)
+            {
+                textures[i] = reader.ReadVariableLengthPascalString();
+            }
+
+            return new MaterialDefinitionBlock(blockTypeInfo, resource, properties, textures);
+        }
+    }
+}

Assets/Scripts/OpenTS2/Files/Formats/DBPF/Scenegraph/Block/MaterialDefinitionBlock.cs

@@ -0,0 +1,22 @@
+using System.IO;
+using OpenTS2.Common;
+using OpenTS2.Content;
+using OpenTS2.Content.DBPF.Scenegraph;
+using OpenTS2.Files.Formats.DBPF.Scenegraph.Block;
+using OpenTS2.Files.Utils;
+
+namespace OpenTS2.Files.Formats.DBPF.Scenegraph.Codecs
+{
+    [Codec(TypeIDs.SCENEGRAPH_TXMT)]
+    public class ScenegraphMaterialDefinitionCodec : AbstractCodec
+    {
+        public override AbstractAsset Deserialize(byte[] bytes, ResourceKey tgi, DBPFFile sourceFile)
+        {
+            var stream = new MemoryStream(bytes);
+            var reader = IoBuffer.FromStream(stream, ByteOrder.LITTLE_ENDIAN);
+
+            var material = ScenegraphResourceCollection.DeserializeSingletonScenegraphBlock<MaterialDefinitionBlock>(reader);
+            return new ScenegraphMaterialDefinitionAsset(material);
+        }
+    }
+}

Assets/Scripts/OpenTS2/Files/Formats/DBPF/Scenegraph/Block/MaterialDefinitionBlock.cs.meta

@@ -95,6 +95,7 @@ public static ScenegraphResourceCollection Deserialize(IoBuffer reader)
                 { ImageDataBlock.TYPE_ID, new ImageDataBlockReader() },
                 { MipLevelInfoBlock.TYPE_ID, new MipLevelInfoBlockReader() },
                 { GeometryDataContainerBlock.TYPE_ID, new GeometryDataContainerBlockReader() },
+                { MaterialDefinitionBlock.TYPE_ID, new MaterialDefinitionBlockReader() },
             };
     }
 }

Assets/Scripts/OpenTS2/Files/Formats/DBPF/Scenegraph/Codecs/ScenegraphMaterialDefinitionCodec.cs

@@ -0,0 +1,32 @@
+using NUnit.Framework;
+using OpenTS2.Common;
+using OpenTS2.Content;
+using OpenTS2.Content.DBPF.Scenegraph;
+using OpenTS2.Files.Formats.DBPF;
+
+public class ScenegraphMaterailDefinitionCodecTest
+{
+    [SetUp]
+    public void SetUp()
+    {
+        TestMain.Initialize();
+        ContentProvider.Get().AddPackage("TestAssets/Scenegraph/material_definition.package");
+    }
+
+    [Test]
+    public void TestLoadsMaterialDefinitionSuccessfully()
+    {
+        var materialAsset = ContentProvider.Get()
+            .GetAsset<ScenegraphMaterialDefinitionAsset>(new ResourceKey("ufocrash_cabin_txmt", 0x1C0532FA,
+                TypeIDs.SCENEGRAPH_TXMT));
+
+        Assert.That(materialAsset.MaterialDefinition.MaterialProperties.Count, Is.GreaterThan(0));
+
+        Assert.That(materialAsset.MaterialDefinition.MaterialProperties["reflectivity"], Is.EqualTo("0.025"));
+        Assert.That(materialAsset.MaterialDefinition.MaterialProperties["stdMatCullMode"], Is.EqualTo("cullClockwise"));
+        Assert.That(materialAsset.MaterialDefinition.MaterialProperties["stdMatSpecCoef"],
+            Is.EqualTo("0.94,0.94,0.94"));
+
+        Assert.That(materialAsset.MaterialDefinition.TextureNames, Is.EquivalentTo(new[]{ "ufocrash-cabin", }));
+    }
+}