Revise for audio, texture, globalinit (#1520)

* Redo documentation for audio, texture, globalinit

* revert the one change

* SPAAAAAAAAAAAAAAAAAAAACE

Author: Miepee

UndertaleModLib/Models/UndertaleEmbeddedAudio.cs

@@ -12,7 +12,7 @@ public class UndertaleEmbeddedAudio : UndertaleNamedResource, PaddedObject, IDis
     /// <summary>
     /// The name of the embedded audio entry.
     /// </summary>
-    /// <remarks>This is an UTMT only attribute. GameMaker does not store names for them.</remarks>
+    /// <remarks>This is a UTMT only attribute. GameMaker does not store names for them.</remarks>
     public UndertaleString Name { get; set; }
 
     /// <summary>
@@ -56,13 +56,13 @@ public override string ToString()
         try
         {
             // TODO: Does only the GUI set this?
-            return Name.Content + " (" + GetType().Name + ")";
+            return $"{Name.Content} ({GetType().Name})";
         }
         catch
         {
             Name = new UndertaleString("EmbeddedSound Unknown Index");
         }
-        return Name.Content + " (" + GetType().Name + ")";
+        return $"{Name.Content} ({GetType().Name})";
     }
 
     /// <inheritdoc/>

UndertaleModLib/Models/UndertaleEmbeddedTexture.cs

@@ -20,6 +20,9 @@ public class UndertaleEmbeddedTexture : UndertaleNamedResource, IDisposable
     /// <summary>
     /// The name of the embedded texture entry.
     /// </summary>
+    /// <remarks>
+    /// This is UTMT specific. The data file does not contain names for embedded textures.
+    /// </remarks>
     public UndertaleString Name { get; set; }
 
     /// <summary>
@@ -59,13 +62,13 @@ public TexData TextureData
     /// <summary>
     /// Helper variable for whether or not this texture is to be stored externally or not.
     /// </summary>
-    public bool TextureExternal { get; set; } = false;
+    public bool TextureExternal { get; set; }
 
 
     /// <summary>
     /// Helper variable for whether or not a texture was loaded yet.
     /// </summary>
-    public bool TextureLoaded { get; set; } = false;
+    public bool TextureLoaded { get; set; }
 
     /// <summary>
     /// Width of the texture. 2022.9+ only.

UndertaleModLib/Models/UndertaleGlobalInit.cs

@@ -6,14 +6,16 @@ namespace UndertaleModLib.Models;
 /// <summary>
 /// A global initialization entry in a data file.
 /// </summary>
-/// <remarks>Never seen in GMS1.4 so uncertain if the structure was the same.</remarks>
+/// <remarks></remarks>
+// TODO: Never seen in GMS1.4 so uncertain if the structure was the same.
 public class UndertaleGlobalInit : UndertaleObject, INotifyPropertyChanged, IDisposable
 {
     private UndertaleResourceById<UndertaleCode, UndertaleChunkCODE> _code = new();
 
     /// <summary>
     /// The <see cref="UndertaleCode"/> object which contains the code.
     /// </summary>
+    /// <remarks>This code is executed at a global scope, before the first room of the game executes.</remarks>
     public UndertaleCode Code { get => _code.Resource; set { _code.Resource = value; PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Code))); } }
 
     /// <inheritdoc />
@@ -29,7 +31,7 @@ public void Serialize(UndertaleWriter writer)
     public void Unserialize(UndertaleReader reader)
     {
         _code = new UndertaleResourceById<UndertaleCode, UndertaleChunkCODE>();
-        _code.Unserialize(reader); // TODO: reader.ReadUndertaleObject if one object starts with another one
+        _code.Unserialize(reader);   // Cannot use ReadUndertaleObject, as that messes things up.
     }
 
     /// <inheritdoc/>
@@ -39,4 +41,4 @@ public void Dispose()
 
         _code.Dispose();
     }
-}
+}