Files
SabreTools/SabreTools.DatItems/Formats/Rom.cs

273 lines
9.5 KiB
C#
Raw Normal View History

2024-03-05 01:42:42 -05:00
using System.Xml.Serialization;
2022-11-03 12:22:17 -07:00
using Newtonsoft.Json;
2020-12-08 13:23:59 -08:00
using SabreTools.Core;
using SabreTools.Core.Tools;
2020-12-08 14:53:49 -08:00
using SabreTools.FileTypes;
2021-02-02 10:23:43 -08:00
namespace SabreTools.DatItems.Formats
{
2019-01-08 17:40:12 -08:00
/// <summary>
/// Represents a generic file within a set
/// </summary>
2020-09-08 10:12:41 -07:00
[JsonObject("rom"), XmlRoot("rom")]
2019-01-08 17:40:12 -08:00
public class Rom : DatItem
{
2020-08-20 13:17:14 -07:00
#region Fields
2019-01-08 17:40:12 -08:00
2020-09-07 22:00:02 -07:00
[JsonIgnore]
2024-03-09 21:34:26 -05:00
public bool ItemStatusSpecified
2019-01-08 17:40:12 -08:00
{
2024-03-09 21:34:26 -05:00
get
{
var status = GetFieldValue<ItemStatus>(Models.Metadata.Rom.StatusKey);
return status != ItemStatus.NULL && status != ItemStatus.None;
}
}
2020-09-07 22:00:02 -07:00
[JsonIgnore]
2024-03-09 21:34:26 -05:00
public bool OriginalSpecified
{
2024-03-09 21:34:26 -05:00
get
{
var original = GetFieldValue<Original?>("ORIGINAL");
return original != null && original != default;
}
2023-08-14 22:33:05 -04:00
}
2020-09-07 22:00:02 -07:00
[JsonIgnore]
public bool DataAreaSpecified
{
get
{
2024-03-09 21:34:26 -05:00
var dataArea = GetFieldValue<DataArea?>("DATAAREA");
return dataArea != null
&& (!string.IsNullOrEmpty(dataArea.GetName())
|| dataArea.GetFieldValue<long?>(Models.Metadata.DataArea.SizeKey) != null
|| dataArea.GetFieldValue<long?>(Models.Metadata.DataArea.WidthKey) != null
|| dataArea.GetFieldValue<Endianness>(Models.Metadata.DataArea.EndiannessKey) != Endianness.NULL);
2020-09-07 22:00:02 -07:00
}
}
[JsonIgnore]
public bool PartSpecified
{
get
{
2024-03-09 21:34:26 -05:00
var part = GetFieldValue<Part?>("PART");
return part != null
&& (!string.IsNullOrEmpty(part.GetName())
|| !string.IsNullOrEmpty(part.GetFieldValue<string?>(Models.Metadata.Part.InterfaceKey)));
2020-09-07 22:00:02 -07:00
}
}
#endregion // Fields
2020-08-17 17:28:32 -07:00
#region Accessors
/// <inheritdoc/>
2024-03-08 15:31:21 -05:00
public override string? GetName() => GetFieldValue<string>(Models.Metadata.Rom.NameKey);
2020-09-02 12:19:12 -07:00
/// <inheritdoc/>
2024-03-08 15:31:21 -05:00
public override void SetName(string? name) => SetFieldValue(Models.Metadata.Rom.NameKey, name);
2020-08-17 17:28:32 -07:00
#endregion
2019-01-08 17:40:12 -08:00
#region Constructors
/// <summary>
/// Create a default, empty Rom object
/// </summary>
public Rom()
{
2023-09-04 23:51:37 -04:00
_internal = new Models.Metadata.Rom();
2023-08-15 01:38:01 -04:00
Machine = new Machine();
2024-03-08 20:42:24 -05:00
SetName(null);
2020-08-20 13:17:14 -07:00
ItemType = ItemType.Rom;
DupeType = 0x00;
2024-03-09 21:34:26 -05:00
SetFieldValue<ItemStatus>(Models.Metadata.Rom.StatusKey, ItemStatus.None);
2019-01-08 17:40:12 -08:00
}
/// <summary>
/// Create a "blank" Rom object
/// </summary>
/// <param name="name"></param>
/// <param name="machineName"></param>
/// <param name="omitFromScan"></param>
public Rom(string name, string machineName)
2019-01-08 17:40:12 -08:00
{
2023-09-04 23:51:37 -04:00
_internal = new Models.Metadata.Rom();
2024-03-08 20:42:24 -05:00
SetName(name);
2020-08-20 13:17:14 -07:00
ItemType = ItemType.Rom;
2024-03-09 21:34:26 -05:00
SetFieldValue<long?>(Models.Metadata.Rom.SizeKey, null);
SetFieldValue<ItemStatus>(Models.Metadata.Rom.StatusKey, ItemStatus.None);
2019-01-08 17:40:12 -08:00
2020-08-20 13:17:14 -07:00
Machine = new Machine
2019-01-08 17:40:12 -08:00
{
Name = machineName,
Description = machineName,
};
}
/// <summary>
/// Create a Rom object from a BaseFile
/// </summary>
/// <param name="baseFile"></param>
public Rom(BaseFile baseFile)
{
2023-09-04 23:51:37 -04:00
_internal = new Models.Metadata.Rom();
2023-08-15 01:38:01 -04:00
Machine = new Machine();
2024-03-08 20:42:24 -05:00
SetName(baseFile.Filename);
2024-03-09 21:34:26 -05:00
SetFieldValue<long?>(Models.Metadata.Rom.SizeKey, baseFile.Size);
SetFieldValue<string?>(Models.Metadata.Rom.CRCKey, TextHelper.ByteArrayToString(baseFile.CRC));
SetFieldValue<string?>(Models.Metadata.Rom.MD5Key, TextHelper.ByteArrayToString(baseFile.MD5));
SetFieldValue<string?>(Models.Metadata.Rom.SHA1Key, TextHelper.ByteArrayToString(baseFile.SHA1));
SetFieldValue<string?>(Models.Metadata.Rom.SHA256Key, TextHelper.ByteArrayToString(baseFile.SHA256));
SetFieldValue<string?>(Models.Metadata.Rom.SHA384Key, TextHelper.ByteArrayToString(baseFile.SHA384));
SetFieldValue<string?>(Models.Metadata.Rom.SHA512Key, TextHelper.ByteArrayToString(baseFile.SHA512));
SetFieldValue<string?>(Models.Metadata.Rom.SpamSumKey, System.Text.Encoding.UTF8.GetString(baseFile.SpamSum ?? []));
2019-01-08 17:40:12 -08:00
2020-08-20 13:17:14 -07:00
ItemType = ItemType.Rom;
DupeType = 0x00;
2024-03-09 21:34:26 -05:00
SetFieldValue<ItemStatus>(Models.Metadata.Rom.StatusKey, ItemStatus.None);
SetFieldValue<string?>(Models.Metadata.Rom.DateKey, baseFile.Date);
2019-01-08 17:40:12 -08:00
}
2023-08-14 14:53:28 -04:00
/// <summary>
/// Create a Rom object from the internal model
/// </summary>
2023-09-04 23:51:37 -04:00
public Rom(Models.Metadata.Rom? rom)
2023-08-14 14:53:28 -04:00
{
2024-02-28 19:19:50 -05:00
_internal = rom ?? [];
2023-08-14 14:53:28 -04:00
ItemType = ItemType.Rom;
DupeType = 0x00;
2024-03-09 21:34:26 -05:00
SetFieldValue<ItemStatus>(Models.Metadata.Rom.StatusKey, ItemStatus.None);
2023-08-14 14:53:28 -04:00
}
2019-01-08 17:40:12 -08:00
#endregion
#region Cloning Methods
2022-11-03 12:22:17 -07:00
/// <inheritdoc/>
2019-01-08 17:40:12 -08:00
public override object Clone()
{
return new Rom()
{
ItemType = this.ItemType,
DupeType = this.DupeType,
2023-08-15 01:38:01 -04:00
Machine = this.Machine.Clone() as Machine ?? new Machine(),
Source = this.Source?.Clone() as Source,
2020-08-20 13:17:14 -07:00
Remove = this.Remove,
2019-01-08 17:40:12 -08:00
2024-02-28 19:19:50 -05:00
_internal = this._internal?.Clone() as Models.Metadata.Rom ?? [],
2019-01-08 17:40:12 -08:00
};
}
2020-12-08 11:09:05 -08:00
/// <summary>
/// Convert Rom object to a BaseFile
/// </summary>
public BaseFile ConvertToBaseFile()
{
return new BaseFile()
{
2024-03-09 21:34:26 -05:00
Filename = GetName(),
2023-08-15 01:38:01 -04:00
Parent = this.Machine.Name,
2024-03-09 21:34:26 -05:00
Date = GetFieldValue<string?>(Models.Metadata.Rom.DateKey),
Size = GetFieldValue<long?>(Models.Metadata.Rom.SizeKey),
CRC = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.CRCKey)),
MD5 = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.MD5Key)),
SHA1 = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.SHA1Key)),
SHA256 = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.SHA256Key)),
SHA384 = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.SHA384Key)),
SHA512 = TextHelper.StringToByteArray(GetFieldValue<string?>(Models.Metadata.Rom.SHA512Key)),
SpamSum = System.Text.Encoding.UTF8.GetBytes(GetFieldValue<string?>(Models.Metadata.Rom.SpamSumKey) ?? string.Empty),
2020-12-08 11:09:05 -08:00
};
}
2019-01-08 17:40:12 -08:00
#endregion
#region Comparision Methods
2020-08-17 17:28:32 -07:00
/// <summary>
/// Fill any missing size and hash information from another Rom
/// </summary>
/// <param name="other">Rom to fill information from</param>
2023-08-14 22:33:05 -04:00
public void FillMissingInformation(Rom other) => _internal.FillMissingHashes(other?._internal);
2020-08-17 17:28:32 -07:00
/// <summary>
/// Get unique duplicate suffix on name collision
/// </summary>
/// <returns>String representing the suffix</returns>
2023-08-14 22:33:05 -04:00
public string GetDuplicateSuffix() => _internal.GetDuplicateSuffix();
2020-08-17 17:28:32 -07:00
2020-09-17 23:37:42 -07:00
/// <summary>
/// Returns if the Rom contains any hashes
/// </summary>
/// <returns>True if any hash exists, false otherwise</returns>
2023-08-14 22:33:05 -04:00
public bool HasHashes() => _internal.HasHashes();
2020-09-17 23:37:42 -07:00
/// <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>
2023-08-14 22:33:05 -04:00
public bool HasZeroHash() => _internal.HasZeroHash();
2020-08-17 14:57:54 -07:00
2019-01-08 17:40:12 -08:00
#endregion
2020-08-17 17:28:32 -07:00
#region Sorting and Merging
2020-12-14 15:31:28 -08:00
/// <inheritdoc/>
public override string GetKey(ItemKey bucketedBy, bool lower = true, bool norename = true)
2020-08-17 17:28:32 -07:00
{
// Set the output key as the default blank string
string? key;
2020-08-17 17:28:32 -07:00
// Now determine what the key should be based on the bucketedBy value
switch (bucketedBy)
{
2020-12-14 15:31:28 -08:00
case ItemKey.CRC:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.CRCKey);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.MD5:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.MD5Key);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.SHA1:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.SHA1Key);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.SHA256:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.SHA256Key);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.SHA384:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.SHA384Key);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.SHA512:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.SHA512Key);
2020-08-17 17:28:32 -07:00
break;
2020-12-14 15:31:28 -08:00
case ItemKey.SpamSum:
2024-03-09 21:34:26 -05:00
key = GetFieldValue<string?>(Models.Metadata.Rom.SpamSumKey);
break;
2020-08-17 17:28:32 -07:00
// Let the base handle generic stuff
default:
return base.GetKey(bucketedBy, lower, norename);
}
// Double and triple check the key for corner cases
key ??= string.Empty;
2020-08-17 17:28:32 -07:00
return key;
}
#endregion
2019-01-08 17:40:12 -08:00
}
}