Files
SabreTools.Serialization/SabreTools.Metadata.DatItems/Formats/Disk.cs
2026-04-02 21:07:41 -04:00

206 lines
6.2 KiB
C#

using System.Xml.Serialization;
using Newtonsoft.Json;
using SabreTools.Data.Extensions;
using SabreTools.Data.Models.Metadata;
using SabreTools.Text.Extensions;
namespace SabreTools.Metadata.DatItems.Formats
{
/// <summary>
/// Represents Compressed Hunks of Data (CHD) formatted disks which use internal hashes
/// </summary>
[JsonObject("disk"), XmlRoot("disk")]
public sealed class Disk : DatItem<Data.Models.Metadata.Disk>
{
#region Constants
/// <summary>
/// Non-standard key for inverted logic
/// </summary>
public const string DiskAreaKey = "DISKAREA";
/// <summary>
/// Non-standard key for inverted logic
/// </summary>
public const string PartKey = "PART";
#endregion
#region Fields
[JsonIgnore]
public bool DiskAreaSpecified
{
get
{
var diskArea = Read<DiskArea?>(DiskAreaKey);
return diskArea is not null && !string.IsNullOrEmpty(diskArea.Name);
}
}
/// <inheritdoc>/>
public override ItemType ItemType => ItemType.Disk;
public string? Name
{
get => (_internal as Data.Models.Metadata.Disk)?.Name;
set => (_internal as Data.Models.Metadata.Disk)?.Name = value;
}
public bool? Optional
{
get => (_internal as Data.Models.Metadata.Disk)?.Optional;
set => (_internal as Data.Models.Metadata.Disk)?.Optional = value;
}
[JsonIgnore]
public bool PartSpecified
{
get
{
var part = Read<Part?>(PartKey);
return part is not null
&& (!string.IsNullOrEmpty(part.Name)
|| !string.IsNullOrEmpty(part.Interface));
}
}
public ItemStatus? Status
{
get => (_internal as Data.Models.Metadata.Disk)?.Status;
set => (_internal as Data.Models.Metadata.Disk)?.Status = value;
}
public bool? Writable
{
get => (_internal as Data.Models.Metadata.Disk)?.Writable;
set => (_internal as Data.Models.Metadata.Disk)?.Writable = value;
}
#endregion
#region Constructors
public Disk() : base()
{
DupeType = 0x00;
Status = ItemStatus.None;
}
public Disk(Data.Models.Metadata.Disk item) : base(item)
{
DupeType = 0x00;
// Process hash values
string? md5 = ReadString(Data.Models.Metadata.Disk.MD5Key);
if (md5 is not null)
Write<string?>(Data.Models.Metadata.Disk.MD5Key, TextHelper.NormalizeMD5(md5));
string? sha1 = ReadString(Data.Models.Metadata.Disk.SHA1Key);
if (sha1 is not null)
Write<string?>(Data.Models.Metadata.Disk.SHA1Key, TextHelper.NormalizeSHA1(sha1));
}
public Disk(Data.Models.Metadata.Disk item, Machine machine, Source source) : this(item)
{
Source = source;
CopyMachineInformation(machine);
}
#endregion
#region Cloning Methods
/// <inheritdoc/>
public override object Clone() => new Disk(_internal.DeepClone() as Data.Models.Metadata.Disk ?? []);
/// <summary>
/// Convert a disk to the closest Rom approximation
/// </summary>
/// <returns></returns>
public Rom ConvertToRom()
{
var rom = new Rom(_internal.ConvertToRom()!);
// Create a DataArea if there was an existing DiskArea
var diskArea = Read<DiskArea?>(DiskAreaKey);
if (diskArea is not null)
{
var dataArea = new DataArea();
dataArea.Name = diskArea.Name;
rom.Write<DataArea?>(Rom.DataAreaKey, dataArea);
}
rom.DupeType = DupeType;
rom.Machine = Machine?.Clone() as Machine;
rom.Write(Rom.PartKey, Read<Part>(PartKey)?.Clone() as Part);
rom.RemoveFlag = RemoveFlag;
rom.Source = Source?.Clone() as Source;
return rom;
}
#endregion
#region Comparision Methods
/// <summary>
/// Fill any missing size and hash information from another Disk
/// </summary>
/// <param name="other">Disk to fill information from</param>
public void FillMissingInformation(Disk other)
=> _internal.FillMissingHashes(other._internal);
/// <summary>
/// Returns if the Rom contains any hashes
/// </summary>
/// <returns>True if any hash exists, false otherwise</returns>
public bool HasHashes() => _internal.HasHashes();
/// <summary>
/// Returns if all of the hashes are set to their 0-byte values
/// </summary>
/// <returns>True if any hash matches the 0-byte value, false otherwise</returns>
public bool HasZeroHash() => _internal.HasZeroHash();
#endregion
#region Sorting and Merging
/// <inheritdoc/>
public override string GetKey(ItemKey bucketedBy, Machine? machine, Source? source, bool lower = true, bool norename = true)
{
// Set the output key as the default blank string
string? key;
#pragma warning disable IDE0010
// Now determine what the key should be based on the bucketedBy value
switch (bucketedBy)
{
case ItemKey.MD5:
key = ReadString(Data.Models.Metadata.Disk.MD5Key);
break;
case ItemKey.SHA1:
key = ReadString(Data.Models.Metadata.Disk.SHA1Key);
break;
// Let the base handle generic stuff
default:
return base.GetKey(bucketedBy, machine, source, lower, norename);
}
#pragma warning restore IDE0010
// Double and triple check the key for corner cases
key ??= string.Empty;
if (lower)
key = key.ToLowerInvariant();
return key;
}
#endregion
}
}