2024-03-10 16:49:07 -04: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;
|
2020-12-08 16:37:08 -08:00
|
|
|
|
using SabreTools.Core.Tools;
|
2020-12-08 14:53:49 -08:00
|
|
|
|
using SabreTools.FileTypes;
|
2016-09-19 20:36:12 -07:00
|
|
|
|
|
2021-02-02 10:23:43 -08:00
|
|
|
|
namespace SabreTools.DatItems.Formats
|
2016-09-19 18:04:24 -07:00
|
|
|
|
{
|
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")]
|
2024-03-10 20:39:54 -04:00
|
|
|
|
public sealed class Rom : DatItem<Models.Metadata.Rom>
|
2019-01-08 17:40:12 -08:00
|
|
|
|
{
|
2024-03-10 16:49:07 -04:00
|
|
|
|
#region Constants
|
|
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
|
/// Non-standard key for inverted logic
|
|
|
|
|
|
/// </summary>
|
|
|
|
|
|
public const string DataAreaKey = "DATAAREA";
|
|
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
|
/// Non-standard key for inverted logic
|
|
|
|
|
|
/// </summary>
|
|
|
|
|
|
public const string PartKey = "PART";
|
|
|
|
|
|
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
|
2020-08-20 13:17:14 -07:00
|
|
|
|
#region Fields
|
2019-01-08 17:40:12 -08:00
|
|
|
|
|
2024-03-10 20:39:54 -04:00
|
|
|
|
/// <inheritdoc>/>
|
|
|
|
|
|
protected override ItemType ItemType => ItemType.Rom;
|
|
|
|
|
|
|
|
|
|
|
|
/// <inheritdoc>/>
|
|
|
|
|
|
protected override string? NameKey => Models.Metadata.Rom.NameKey;
|
|
|
|
|
|
|
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;
|
|
|
|
|
|
}
|
2023-08-14 13:17:51 -04:00
|
|
|
|
}
|
2020-09-03 12:17:36 -07:00
|
|
|
|
|
2020-09-07 22:00:02 -07:00
|
|
|
|
[JsonIgnore]
|
2024-03-09 21:34:26 -05:00
|
|
|
|
public bool OriginalSpecified
|
2023-08-14 13:17:51 -04:00
|
|
|
|
{
|
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-03 11:02:06 -07:00
|
|
|
|
|
2020-09-07 22:00:02 -07:00
|
|
|
|
[JsonIgnore]
|
|
|
|
|
|
public bool DataAreaSpecified
|
|
|
|
|
|
{
|
|
|
|
|
|
get
|
|
|
|
|
|
{
|
2024-03-10 16:49:07 -04:00
|
|
|
|
var dataArea = GetFieldValue<DataArea?>(Rom.DataAreaKey);
|
2024-03-09 21:34:26 -05:00
|
|
|
|
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-10 16:49:07 -04:00
|
|
|
|
var part = GetFieldValue<Part?>(Rom.PartKey);
|
2024-03-09 21:34:26 -05:00
|
|
|
|
return part != null
|
|
|
|
|
|
&& (!string.IsNullOrEmpty(part.GetName())
|
|
|
|
|
|
|| !string.IsNullOrEmpty(part.GetFieldValue<string?>(Models.Metadata.Part.InterfaceKey)));
|
2020-09-07 22:00:02 -07:00
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2024-03-09 23:43:43 -05:00
|
|
|
|
#endregion
|
2020-09-03 11:02:06 -07:00
|
|
|
|
|
2019-01-08 17:40:12 -08:00
|
|
|
|
#region Constructors
|
|
|
|
|
|
|
2024-03-10 20:39:54 -04:00
|
|
|
|
public Rom() : base()
|
2019-01-08 17:40:12 -08:00
|
|
|
|
{
|
2024-03-10 16:49:07 -04:00
|
|
|
|
SetFieldValue<DupeType>(DatItem.DupeTypeKey, 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
|
|
|
|
}
|
|
|
|
|
|
|
2024-03-10 20:39:54 -04:00
|
|
|
|
public Rom(BaseFile baseFile) : base()
|
2019-01-08 17:40:12 -08:00
|
|
|
|
{
|
2024-03-08 20:42:24 -05:00
|
|
|
|
SetName(baseFile.Filename);
|
2024-03-10 20:39:54 -04:00
|
|
|
|
SetFieldValue<string?>(Models.Metadata.Rom.DateKey, baseFile.Date);
|
2024-03-09 21:34:26 -05:00
|
|
|
|
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));
|
2024-03-10 20:39:54 -04:00
|
|
|
|
SetFieldValue<long?>(Models.Metadata.Rom.SizeKey, baseFile.Size);
|
2024-03-09 21:34:26 -05:00
|
|
|
|
SetFieldValue<string?>(Models.Metadata.Rom.SpamSumKey, System.Text.Encoding.UTF8.GetString(baseFile.SpamSum ?? []));
|
2019-01-08 17:40:12 -08:00
|
|
|
|
|
2024-03-10 16:49:07 -04:00
|
|
|
|
SetFieldValue<DupeType>(DatItem.DupeTypeKey, 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
|
|
|
|
}
|
|
|
|
|
|
|
2024-03-10 20:39:54 -04:00
|
|
|
|
public Rom(Models.Metadata.Rom item) : base(item)
|
2023-08-14 14:53:28 -04:00
|
|
|
|
{
|
2024-03-10 20:39:54 -04:00
|
|
|
|
SetFieldValue<DupeType>(DatItem.DupeTypeKey, 0x00);
|
|
|
|
|
|
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
|
|
|
|
|
|
|
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(),
|
2024-03-10 16:49:07 -04:00
|
|
|
|
Parent = GetFieldValue<Machine>(DatItem.MachineKey)!.GetFieldValue<string?>(Models.Metadata.Machine.NameKey),
|
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
|
2023-08-14 13:17:51 -04:00
|
|
|
|
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);
|
2020-09-04 15:02:15 -07:00
|
|
|
|
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
|
2023-04-19 16:39:58 -04:00
|
|
|
|
key ??= string.Empty;
|
2020-08-17 17:28:32 -07:00
|
|
|
|
|
|
|
|
|
|
return key;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
#endregion
|
2019-01-08 17:40:12 -08:00
|
|
|
|
}
|
2016-09-19 18:04:24 -07:00
|
|
|
|
}
|