Update descriptions, convert tzx to tap

Author: voytas

src/Spectron.Files/Extensions/TapFileExtensions.cs

@@ -28,4 +28,25 @@ public static TzxFile ToTzx(this TapFile tapFile)
 
         return tzx;
     }
+
+    /// <summary>
+    /// Converts a TzxFile to a TapFile, only including standard speed data blocks.
+    /// Any other block types will be ignored since they cannot be represented in a TapFile.
+    /// </summary>
+    /// <param name="tzxFile">The TzxFile to convert.</param>
+    /// <returns>A TapFile containing the standard speed data blocks.</returns>
+    public static TapFile ToTap(this TzxFile tzxFile)
+    {
+        var tap = new TapFile();
+
+        foreach (var block in tzxFile.Blocks.Where(b => b is StandardSpeedDataBlock).Cast<StandardSpeedDataBlock>())
+        {
+            if (TapData.TryParse(block.Data, out var tapData))
+            {
+                tap.Blocks.Add(tapData);
+            }
+        }
+
+        return tap;
+    }
 }

src/Spectron.Files/Tzx/Blocks/ArchiveInfoBlock.cs

@@ -125,7 +125,7 @@ internal TextInfo(ByteStreamReader reader)
         /// <summary>
         /// Converts the TextInfo class to its equivalent string representation.
         /// </summary>
-        /// <returns>The string representation of this object.</returns>
+        /// <returns>A string representation of TextInfo object.</returns>
         public override string ToString() => Text;
     }
 }

src/Spectron.Files/Tzx/Blocks/CallSequenceBlock.cs

@@ -45,4 +45,10 @@ internal CallSequenceBlock(ByteStreamReader reader)
             .ReadWords(length)
             .Select(offset => (short)offset).ToList();
     }
+
+    /// <summary>
+    /// Converts the 'Call Sequence' block class to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of 'Call Sequence' object.</returns>
+    public override string ToString() => $"{Offsets.Count} call(s)";
 }

src/Spectron.Files/Tzx/Blocks/CustomInfoBlock.cs

@@ -51,4 +51,10 @@ internal CustomInfoBlock(ByteStreamReader reader)
         var length = reader.ReadDWord();
         Info.AddRange(reader.ReadBytes((int)length));
     }
+
+    /// <summary>
+    /// Converts the 'Custom Info' block class to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of 'Custom Info' object.</returns>
+    public override string ToString() => $"Custom Info: {Identification}";
 }

src/Spectron.Files/Tzx/Blocks/DirectRecordingBlock.cs

@@ -1,5 +1,6 @@
 using OldBit.Spectron.Files.IO;
 using OldBit.Spectron.Files.Serialization;
+using OldBit.Spectron.Files.Tap;
 
 namespace OldBit.Spectron.Files.Tzx.Blocks;
 
@@ -65,4 +66,19 @@ internal DirectRecordingBlock(ByteStreamReader reader)
         var length = reader.ReadByte() | reader.ReadByte() << 8 | reader.ReadByte() << 16;
         Data.AddRange(reader.ReadBytes(length));
     }
+
+    /// <summary>
+    /// Converts the 'Direct Recording' block to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of the 'Direct Recording' object which corresponds to
+    /// Program name or Length value.</returns>
+    public override string ToString()
+    {
+        if (TapData.TryParse(Data, out var tap))
+        {
+            return tap.ToString();
+        }
+
+        return Length == 1 ? "1 byte" : $"{Length} bytes";
+    }
 }

src/Spectron.Files/Tzx/Blocks/GlueBlock.cs

@@ -36,4 +36,10 @@ internal GlueBlock(ByteStreamReader reader)
     {
         Data = new List<byte>(reader.ReadBytes(9));
     }
+
+    /// <summary>
+    /// Converts the 'Glue' block to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of the 'Glue' object.</returns>
+    public override string ToString() => "Glue";
 }

src/Spectron.Files/Tzx/Blocks/GroupEndBlock.cs

@@ -12,4 +12,10 @@ public class GroupEndBlock : IBlock
     /// </summary>
     [FileData(Order = 0)]
     public byte BlockId => BlockCode.GroupEnd;
+
+    /// <summary>
+    /// Converts the 'Group End' block to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of 'Group End' object.</returns>
+    public override string ToString() => "Group End";
 }

src/Spectron.Files/Tzx/Blocks/GroupStartBlock.cs

@@ -48,6 +48,6 @@ internal GroupStartBlock(ByteStreamReader reader)
     /// <summary>
     /// Converts the 'Group Start' block to its equivalent string representation.
     /// </summary>
-    /// <returns>The string representation of this object which corresponds to Name value.</returns>
+    /// <returns>A string representation of the 'Group Start' object which corresponds to Name value.</returns>
     public override string ToString() => Name;
 }

src/Spectron.Files/Tzx/Blocks/HardwareTypeBlock.cs

@@ -97,7 +97,7 @@ internal HardwareInfo(ByteStreamReader reader)
         /// <summary>
         /// Converts the 'Hardware Info' to its equivalent string representation.
         /// </summary>
-        /// <returns>The string representation of this object.</returns>
+        /// <returns>A string representation of the 'Hardware Info' object.</returns>
         public override string ToString() => HardwareNames.GetName(HardwareTypeId, HardwareId);
     }
 }

src/Spectron.Files/Tzx/Blocks/JumpToBlock.cs

@@ -35,4 +35,10 @@ internal JumpToBlock(ByteStreamReader reader)
     {
         Jump = (short)reader.ReadWord();
     }
+
+    /// <summary>
+    /// Converts the 'Jump To' block to its equivalent string representation.
+    /// </summary>
+    /// <returns>A string representation of the 'Jump To' object which corresponds to Name value.</returns>
+    public override string ToString() => $"Jump to {Jump}";
 }