additional sound metadata

Author: MattFiler

CathodeLib/Scripts/CATHODE/SoundEnvironmentData.cs

@@ -13,6 +13,8 @@ namespace CATHODE
     /* DATA/ENV/PRODUCTION/x/WORLD/SOUNDENVIRONMENTDATA.DAT */
     public class SoundEnvironmentData : CathodeFile
     {
+        //This stores the reverbs that are used within the level. Similar to SoundLoadZones, these can be stored with spatial zones, but this feature is unused.
+
         public List<string> Entries = new List<string>();
         public static new Implementation Implementation = Implementation.CREATE | Implementation.LOAD | Implementation.SAVE;
         public SoundEnvironmentData(string path) : base(path) { }
@@ -22,7 +24,7 @@ override protected bool LoadInternal()
         {
             using (BinaryReader reader = new BinaryReader(File.OpenRead(_filepath)))
             {
-                reader.BaseStream.Position += 4;
+                reader.BaseStream.Position += 4; //version
                 int entryCount = reader.ReadInt32();
                 for (int i = 0; i < entryCount; i++)
                 {
@@ -32,6 +34,7 @@ override protected bool LoadInternal()
                         Entries.Add(Utilities.ReadString(contentReader));
                     }
                 }
+                reader.BaseStream.Position += 4; //zone count - always zero
             }
             return true;
         }
@@ -45,11 +48,8 @@ override protected bool SaveInternal()
                 writer.Write(Entries.Count);
                 for (int i = 0; i < Entries.Count; i++)
                 {
-                    writer.Write(new byte[100]);
-                    long resetPos = writer.BaseStream.Position;
-                    writer.BaseStream.Position -= 100;
                     Utilities.WriteString(Entries[i], writer);
-                    writer.BaseStream.Position = resetPos;
+                    writer.Write(new byte[100 - Entries[i].Length]);
                 }
                 writer.Write(0);
             }

CathodeLib/Scripts/CATHODE/SoundEventData.cs

@@ -13,6 +13,8 @@ namespace CATHODE
     /* DATA/ENV/PRODUCTION/x/WORLD/SOUNDEVENTDATA.DAT */
     public class SoundEventData : CathodeFile
     {
+        //This stores all available sound events within soundbanks, along with their associated max attenuation and metadata (parameters)
+
         public List<Soundbank> Entries = new List<Soundbank>();
         public static new Implementation Implementation = Implementation.CREATE | Implementation.LOAD | Implementation.SAVE;
         public SoundEventData(string path) : base(path) { }
@@ -22,17 +24,17 @@ override protected bool LoadInternal()
         {
             using (BinaryReader reader = new BinaryReader(File.OpenRead(_filepath)))
             {
-                reader.BaseStream.Position += 4;
+                reader.BaseStream.Position += 4; //version
                 int entryCount = reader.ReadInt32();
                 for (int i = 0; i < entryCount; i++)
                 {
                     Soundbank.Event e = new Soundbank.Event();
                     int length = reader.ReadInt32();
                     for (int x = 0; x < length; x++) e.name += reader.ReadChar();
                     length = reader.ReadInt32();
-                    for (int x = 0; x < length; x++) e.args += reader.ReadChar();
-                    reader.BaseStream.Position += 2;
-                    e.unknown = reader.ReadInt16();
+                    for (int x = 0; x < length; x++) e.metadata += reader.ReadChar();
+
+                    e.max_attenuation = reader.ReadSingle();
 
                     uint soundbankID = reader.ReadUInt32();
                     Soundbank soundbank = Entries.FirstOrDefault(o => o.id == soundbankID);
@@ -53,20 +55,23 @@ override protected bool SaveInternal()
             {
                 writer.BaseStream.SetLength(0);
                 writer.Write(0);
-                writer.Write(Entries.Count);
+                writer.Write(0);
+                int count = 0;
                 for (int i = 0; i < Entries.Count; i++)
                 {
                     for (int x = 0; x < Entries[i].events.Count; x++)
                     {
                         writer.Write(Entries[i].events[x].name.Length);
                         Utilities.WriteString(Entries[i].events[x].name, writer);
-                        writer.Write(Entries[i].events[x].args.Length);
-                        Utilities.WriteString(Entries[i].events[x].args, writer);
-                        writer.Write((Int16)0);
-                        writer.Write(Entries[i].events[x].unknown);
+                        writer.Write(Entries[i].events[x].metadata.Length);
+                        Utilities.WriteString(Entries[i].events[x].metadata, writer);
+                        writer.Write(Entries[i].events[x].max_attenuation);
                         writer.Write(Entries[i].id);
+                        count++;
                     }
                 }
+                writer.BaseStream.Position = 4;
+                writer.Write(count);
             }
             return true;
         }
@@ -80,10 +85,9 @@ public class Soundbank
 
             public class Event
             {
-                public string name;
-                public string args;
-
-                public int unknown;
+                public string name = "";
+                public string metadata = "";
+                public float max_attenuation = 1024.0f;
             }
         };
         #endregion

CathodeLib/Scripts/CATHODE/SoundFlashModels.cs

@@ -44,6 +44,7 @@ override protected bool SaveInternal()
                 for (int i = 0; i < Entries.Count; i++)
                 {
                     writer.Write(Entries[i].flash_texture_id);
+                    writer.Write(Entries[i].model_indexes.Count);
                     for (int x = 0; x < Entries[i].model_indexes.Count; x++)
                         writer.Write(Entries[i].model_indexes[x]);
                 }

CathodeLib/Scripts/CATHODE/SoundLoadZones.cs

@@ -13,7 +13,7 @@ namespace CATHODE
     /* DATA/ENV/PRODUCTION/x/WORLD/SOUNDLOADZONES.DAT */
     public class SoundLoadZones : CathodeFile
     {
-        //This seems to specify all the sound banks that are loaded within the level. They can be specified via spatial zones, but this feature is never used.
+        //This specifies all the sound banks that are loaded within the level. They can be specified via spatial zones, but this feature is never used.
 
         public List<string> Entries = new List<string>();
         public static new Implementation Implementation = Implementation.CREATE | Implementation.LOAD | Implementation.SAVE;