using System;
using System.Xml.Serialization;
using Newtonsoft.Json;
using Newtonsoft.Json.Converters;
using SabreTools.Core;
using SabreTools.Core.Tools;
using SabreTools.FileTypes;
namespace SabreTools.DatItems.Formats
{
///
/// Represents a generic file within a set
///
[JsonObject("rom"), XmlRoot("rom")]
public class Rom : DatItem
{
#region Fields
#region Common
///
/// Name of the item
///
[JsonProperty("name"), XmlElement("name")]
public string? Name
{
get => _internal.ReadString(Models.Internal.Rom.NameKey);
set => _internal[Models.Internal.Rom.NameKey] = value;
}
///
/// What BIOS is required for this rom
///
[JsonProperty("bios", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("bios")]
public string? Bios
{
get => _internal.ReadString(Models.Internal.Rom.BiosKey);
set => _internal[Models.Internal.Rom.BiosKey] = value;
}
///
/// Byte size of the rom
///
[JsonProperty("size", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("size")]
public long? Size
{
get => _internal.ReadLong(Models.Internal.Rom.SizeKey);
set => _internal[Models.Internal.Rom.SizeKey] = value;
}
[JsonIgnore]
public bool SizeSpecified { get { return Size != null; } }
///
/// File CRC32 hash
///
[JsonProperty("crc", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("crc")]
public string? CRC
{
get => _internal.ReadString(Models.Internal.Rom.CRCKey);
set => _internal[Models.Internal.Rom.CRCKey] = TextHelper.NormalizeCRC32(value);
}
///
/// File MD5 hash
///
[JsonProperty("md5", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("md5")]
public string? MD5
{
get => _internal.ReadString(Models.Internal.Rom.MD5Key);
set => _internal[Models.Internal.Rom.MD5Key] = TextHelper.NormalizeMD5(value);
}
///
/// File SHA-1 hash
///
[JsonProperty("sha1", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("sha1")]
public string? SHA1
{
get => _internal.ReadString(Models.Internal.Rom.SHA1Key);
set => _internal[Models.Internal.Rom.SHA1Key] = TextHelper.NormalizeSHA1(value);
}
///
/// File SHA-256 hash
///
[JsonProperty("sha256", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("sha256")]
public string? SHA256
{
get => _internal.ReadString(Models.Internal.Rom.SHA256Key);
set => _internal[Models.Internal.Rom.SHA256Key] = TextHelper.NormalizeSHA256(value);
}
///
/// File SHA-384 hash
///
[JsonProperty("sha384", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("sha384")]
public string? SHA384
{
get => _internal.ReadString(Models.Internal.Rom.SHA384Key);
set => _internal[Models.Internal.Rom.SHA384Key] = TextHelper.NormalizeSHA384(value);
}
///
/// File SHA-512 hash
///
[JsonProperty("sha512", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("sha512")]
public string? SHA512
{
get => _internal.ReadString(Models.Internal.Rom.SHA512Key);
set => _internal[Models.Internal.Rom.SHA512Key] = TextHelper.NormalizeSHA512(value);
}
///
/// File SpamSum fuzzy hash
///
[JsonProperty("spamsum", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("spamsum")]
public string? SpamSum
{
get => _internal.ReadString(Models.Internal.Rom.SpamSumKey);
set => _internal[Models.Internal.Rom.SpamSumKey] = value;
}
///
/// Rom name to merge from parent
///
[JsonProperty("merge", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("merge")]
public string? MergeTag
{
get => _internal.ReadString(Models.Internal.Rom.MergeKey);
set => _internal[Models.Internal.Rom.MergeKey] = value;
}
///
/// Rom region
///
[JsonProperty("region", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("biregionos")]
public string? Region
{
get => _internal.ReadString(Models.Internal.Rom.RegionKey);
set => _internal[Models.Internal.Rom.RegionKey] = value;
}
///
/// Data offset within rom
///
[JsonProperty("offset", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("offset")]
public string? Offset
{
get => _internal.ReadString(Models.Internal.Rom.OffsetKey);
set => _internal[Models.Internal.Rom.OffsetKey] = value;
}
///
/// File created date
///
[JsonProperty("date", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("date")]
public string? Date
{
get => _internal.ReadString(Models.Internal.Rom.DateKey);
set => _internal[Models.Internal.Rom.DateKey] = value;
}
///
/// Rom dump status
///
[JsonProperty("status", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("status")]
[JsonConverter(typeof(StringEnumConverter))]
public ItemStatus ItemStatus
{
get => _internal.ReadString(Models.Internal.Rom.StatusKey).AsItemStatus();
set => _internal[Models.Internal.Rom.StatusKey] = value.FromItemStatus(yesno: false);
}
[JsonIgnore]
public bool ItemStatusSpecified { get { return ItemStatus != ItemStatus.NULL && ItemStatus != ItemStatus.None; } }
///
/// Determine if the rom is optional in the set
///
[JsonProperty("optional", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("optional")]
public bool? Optional
{
get => _internal.ReadBool(Models.Internal.Rom.OptionalKey);
set => _internal[Models.Internal.Rom.OptionalKey] = value;
}
[JsonIgnore]
public bool OptionalSpecified { get { return Optional != null; } }
///
/// Determine if the CRC32 hash is inverted
///
[JsonProperty("inverted", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("inverted")]
public bool? Inverted
{
get => _internal.ReadBool(Models.Internal.Rom.InvertedKey);
set => _internal[Models.Internal.Rom.InvertedKey] = value;
}
[JsonIgnore]
public bool InvertedSpecified { get { return Inverted != null; } }
#endregion
#region Archive.org
///
/// Source of file
///
[JsonProperty("ado_source", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("ado_source")]
public string? ArchiveDotOrgSource
{
get => _internal.ReadString(Models.Internal.Rom.SourceKey);
set => _internal[Models.Internal.Rom.SourceKey] = value;
}
///
/// Archive.org recognized file format
///
[JsonProperty("ado_format", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("ado_format")]
public string? ArchiveDotOrgFormat
{
get => _internal.ReadString(Models.Internal.Rom.FormatKey);
set => _internal[Models.Internal.Rom.FormatKey] = value;
}
///
/// Original filename
///
[JsonProperty("original_filename", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("original_filename")]
public string? OriginalFilename
{
get => _internal.ReadString(Models.Internal.Rom.OriginalKey);
set => _internal[Models.Internal.Rom.OriginalKey] = value;
}
///
/// Image rotation
///
///
/// TODO: This might be Int32?
///
[JsonProperty("rotation", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("rotation")]
public string? Rotation
{
get => _internal.ReadString(Models.Internal.Rom.RotationKey);
set => _internal[Models.Internal.Rom.RotationKey] = value;
}
///
/// Summation value?
///
[JsonProperty("summation", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("summation")]
public string? Summation
{
get => _internal.ReadString(Models.Internal.Rom.SummationKey);
set => _internal[Models.Internal.Rom.SummationKey] = value;
}
#endregion
#region AttractMode
///
/// Alternate name for the item
///
[JsonProperty("alt_internalname", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("alt_internalname")]
public string? AltName
{
get => _internal.ReadString(Models.Internal.Rom.AltRomnameKey);
set => _internal[Models.Internal.Rom.AltRomnameKey] = value;
}
///
/// Alternate title for the item
///
[JsonProperty("alt_title", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("alt_title")]
public string? AltTitle
{
get => _internal.ReadString(Models.Internal.Rom.AltTitleKey);
set => _internal[Models.Internal.Rom.AltTitleKey] = value;
}
#endregion
#region Logiqx
///
/// Alternate title for the item
///
[JsonProperty("mia", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("mia")]
public bool? MIA
{
get => _internal.ReadBool(Models.Internal.Rom.MIAKey);
set => _internal[Models.Internal.Rom.MIAKey] = value;
}
[JsonIgnore]
public bool MIASpecified { get { return MIA != null; } }
#endregion
#region OpenMSX
///
/// OpenMSX sub item type
///
/// Hack on top of internal model
[JsonProperty("original", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("original")]
public Original? Original
{
get => _internal.Read("ORIGINAL");
set => _internal["ORIGINAL"] = value;
}
[JsonIgnore]
public bool OriginalSpecified { get { return Original != null && Original != default; } }
///
/// OpenMSX sub item type
///
[JsonProperty("openmsx_subtype", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("openmsx_subtype")]
[JsonConverter(typeof(StringEnumConverter))]
public OpenMSXSubType OpenMSXSubType
{
get => _internal.ReadString(Models.Internal.Rom.OpenMSXMediaType).AsOpenMSXSubType();
set => _internal[Models.Internal.Rom.OpenMSXMediaType] = value.FromOpenMSXSubType();
}
[JsonIgnore]
public bool OpenMSXSubTypeSpecified { get { return OpenMSXSubType != OpenMSXSubType.NULL; } }
///
/// OpenMSX sub item type
///
/// Not related to the subtype above
[JsonProperty("openmsx_type", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("openmsx_type")]
public string? OpenMSXType
{
get => _internal.ReadString(Models.Internal.Rom.OpenMSXType);
set => _internal[Models.Internal.Rom.OpenMSXType] = value;
}
///
/// Item remark (like a comment)
///
[JsonProperty("remark", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("remark")]
public string? Remark
{
get => _internal.ReadString(Models.Internal.Rom.RemarkKey);
set => _internal[Models.Internal.Rom.RemarkKey] = value;
}
///
/// Boot state
///
/// TODO: Investigate where this value came from?
[JsonProperty("boot", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("boot")]
public string? Boot
{
get => _internal.ReadString("BOOT");
set => _internal["BOOT"] = value;
}
#endregion
#region SoftwareList
///
/// Data area information
///
/// Hack on top of internal model
[JsonProperty("dataarea", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("dataarea")]
public DataArea? DataArea
{
get => _internal.Read("DATAAREA");
set => _internal["DATAAREA"] = value;
}
[JsonIgnore]
public bool DataAreaSpecified
{
get
{
return DataArea != null
&& (!string.IsNullOrEmpty(DataArea.Name)
|| DataArea.SizeSpecified
|| DataArea.WidthSpecified
|| DataArea.EndiannessSpecified);
}
}
///
/// Loading flag
///
[JsonProperty("loadflag", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("loadflag")]
[JsonConverter(typeof(StringEnumConverter))]
public LoadFlag LoadFlag
{
get => _internal.ReadString(Models.Internal.Rom.LoadFlagKey).AsLoadFlag();
set => _internal[Models.Internal.Rom.LoadFlagKey] = value.FromLoadFlag();
}
[JsonIgnore]
public bool LoadFlagSpecified { get { return LoadFlag != LoadFlag.NULL; } }
///
/// Original hardware part associated with the item
///
/// Hack on top of internal model
[JsonProperty("part", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("part")]
public Part? Part
{
get => _internal.Read("PART");
set => _internal["PART"] = value;
}
[JsonIgnore]
public bool PartSpecified
{
get
{
return Part != null
&& (!string.IsNullOrEmpty(Part.Name)
|| !string.IsNullOrEmpty(Part.Interface));
}
}
///
/// SoftwareList value associated with the item
///
[JsonProperty("value", DefaultValueHandling = DefaultValueHandling.Ignore), XmlElement("value")]
public string? Value
{
get => _internal.ReadString(Models.Internal.Rom.ValueKey);
set => _internal[Models.Internal.Rom.ValueKey] = value;
}
#endregion
#endregion // Fields
#region Accessors
///
public override string? GetName() => Name;
///
public override void SetName(string? name) => Name = name;
#endregion
#region Constructors
///
/// Create a default, empty Rom object
///
public Rom()
{
_internal = new Models.Internal.Rom();
Name = null;
ItemType = ItemType.Rom;
DupeType = 0x00;
ItemStatus = ItemStatus.None;
}
///
/// Create a "blank" Rom object
///
///
///
///
public Rom(string name, string machineName)
{
_internal = new Models.Internal.Rom();
Name = name;
ItemType = ItemType.Rom;
Size = null;
ItemStatus = ItemStatus.None;
Machine = new Machine
{
Name = machineName,
Description = machineName,
};
}
///
/// Create a Rom object from a BaseFile
///
///
public Rom(BaseFile baseFile)
{
_internal = new Models.Internal.Rom();
Name = baseFile.Filename;
Size = baseFile.Size;
CRC = TextHelper.ByteArrayToString(baseFile.CRC);
MD5 = TextHelper.ByteArrayToString(baseFile.MD5);
SHA1 = TextHelper.ByteArrayToString(baseFile.SHA1);
SHA256 = TextHelper.ByteArrayToString(baseFile.SHA256);
SHA384 = TextHelper.ByteArrayToString(baseFile.SHA384);
SHA512 = TextHelper.ByteArrayToString(baseFile.SHA512);
SpamSum = System.Text.Encoding.UTF8.GetString(baseFile.SpamSum ?? Array.Empty());
ItemType = ItemType.Rom;
DupeType = 0x00;
ItemStatus = ItemStatus.None;
Date = baseFile.Date;
}
///
/// Create a Rom object from the internal model
///
public Rom(Models.Internal.Rom? rom)
{
_internal = rom ?? new Models.Internal.Rom();
ItemType = ItemType.Rom;
DupeType = 0x00;
ItemStatus = ItemStatus.None;
}
#endregion
#region Cloning Methods
///
public override object Clone()
{
return new Rom()
{
Name = this.Name,
ItemType = this.ItemType,
DupeType = this.DupeType,
Machine = this.Machine?.Clone() as Machine,
Source = this.Source?.Clone() as Source,
Remove = this.Remove,
_internal = this._internal?.Clone() as Models.Internal.Rom ?? new Models.Internal.Rom(),
};
}
///
/// Convert Rom object to a BaseFile
///
public BaseFile ConvertToBaseFile()
{
return new BaseFile()
{
Filename = this.Name,
Parent = this.Machine?.Name,
Date = this.Date,
Size = this.Size,
CRC = TextHelper.StringToByteArray(this.CRC),
MD5 = TextHelper.StringToByteArray(this.MD5),
SHA1 = TextHelper.StringToByteArray(this.SHA1),
SHA256 = TextHelper.StringToByteArray(this.SHA256),
SHA384 = TextHelper.StringToByteArray(this.SHA384),
SHA512 = TextHelper.StringToByteArray(this.SHA512),
SpamSum = System.Text.Encoding.UTF8.GetBytes(this.SpamSum ?? string.Empty),
};
}
#endregion
#region Comparision Methods
///
/// Fill any missing size and hash information from another Rom
///
/// Rom to fill information from
public void FillMissingInformation(Rom other) => _internal.FillMissingHashes(other?._internal);
///
/// Get unique duplicate suffix on name collision
///
/// String representing the suffix
public string GetDuplicateSuffix() => _internal.GetDuplicateSuffix();
///
/// Returns if the Rom contains any hashes
///
/// True if any hash exists, false otherwise
public bool HasHashes() => _internal.HasHashes();
///
/// Returns if all of the hashes are set to their 0-byte values
///
/// True if any hash matches the 0-byte value, false otherwise
public bool HasZeroHash() => _internal.HasZeroHash();
#endregion
#region Sorting and Merging
///
public override string GetKey(ItemKey bucketedBy, bool lower = true, bool norename = true)
{
// Set the output key as the default blank string
string? key;
// Now determine what the key should be based on the bucketedBy value
switch (bucketedBy)
{
case ItemKey.CRC:
key = CRC;
break;
case ItemKey.MD5:
key = MD5;
break;
case ItemKey.SHA1:
key = SHA1;
break;
case ItemKey.SHA256:
key = SHA256;
break;
case ItemKey.SHA384:
key = SHA384;
break;
case ItemKey.SHA512:
key = SHA512;
break;
case ItemKey.SpamSum:
key = SpamSum;
break;
// 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;
return key;
}
#endregion
}
}