SabreTools/SabreTools.Serialization
1
0
Fork 0
mirror of https://github.com/SabreTools/SabreTools.Serialization.git synced 2026-09-22 06:45:11 +00:00
Code Issues 56 Packages Projects Releases 20 Wiki Activity

Finish NES cart extension properties

Browse Source
This commit is contained in:
Matt Nadareski
2026-03-06 13:39:47 -05:00
parent 7dfb015dd5
commit d108a815d7
1 changed files with 213 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files

305
SabreTools.Serialization/Wrappers/NESCart.cs
View File

@@ -3,7 +3,6 @@ using SabreTools.Data.Models.NES;
namespace SabreTools.Serialization.Wrappers
{
// TODO: Add extension properties for more 1.0 and 2.0 header pieces
public partial class NESCart : WrapperBase<Cart>
{
#region Descriptive Properties
@@ -15,47 +14,18 @@ namespace SabreTools.Serialization.Wrappers
#region Extension Properties
#region Common
/// <inheritdoc cref="Cart.Header"/>
public Header? Header => Model.Header;
/// <inheritdoc cref="Cart.CHRROMData"/>
public byte[] CHRROMData => Model.CHRROMData;
/// <summary>
/// CHR-NVRAM size in bytes
/// </summary>
public int CHRNVRAMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.CHRRAMSize >> 4);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// CHR-RAM size in bytes
/// </summary>
public int CHRRAMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.CHRRAMSize & 0x0F);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// CHR-ROM size in bytes
/// </summary>
/// <remarks>Extended by NES 2.0</remarks>
public int CHRROMSize
{
get
@@ -72,30 +42,6 @@ namespace SabreTools.Serialization.Wrappers
}
}
/// <summary>
/// Extended console type
/// </summary>
/// <remarks>Only valid if <see cref="Flag7.ExtendedConsoleType"/> is set</remarks>
public ExtendedConsoleType ExtendedConsoleType
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return ExtendedConsoleType.RegularSystem;
#if NET20 || NET35
if ((Header.Flag7 & Flag7.ExtendedConsoleType) != 0)
#else
if (Header.Flag7.HasFlag(Flag7.ExtendedConsoleType))
#endif
return (ExtendedConsoleType)(header2.ExtendedSystemType & 0x0F);
// If flag is unset
return ExtendedConsoleType.RegularSystem;
}
}
/// <summary>
/// Indicates if an alternative nametable layout is in use
/// </summary>
@@ -156,6 +102,7 @@ namespace SabreTools.Serialization.Wrappers
/// <summary>
/// Indicates if the game is meant for an extended console type
/// </summary>
/// <remarks>Possibly only valid for NES 2.0</remarks>
public bool IsExtendedConsole
{
get
@@ -257,6 +204,7 @@ namespace SabreTools.Serialization.Wrappers
/// <summary>
/// Mapper number
/// </summary>
/// <remarks>Extended by NES 2.0</remarks>
public int MapperNumber
{
get
@@ -273,22 +221,6 @@ namespace SabreTools.Serialization.Wrappers
}
}
/// <summary>
/// PRG-NVRAM/EEPROM size in bytes
/// </summary>
public int PRGRAMEEPROMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.PRGRAMEEPROMSize >> 4);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// PRG-RAM size in bytes
/// </summary>
@@ -296,18 +228,30 @@ namespace SabreTools.Serialization.Wrappers
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
// Missing header
if (Header is null)
return 0;
byte shift = (byte)(header2.PRGRAMEEPROMSize & 0x0F);
return shift > 0 ? 64 << shift : 0;
if (Header is Header1 header1)
{
return header1.PRGRAMSize > 0 ? header1.PRGRAMSize * 8192 : 8192;
}
else if (Header is Header2 header2)
{
byte shift = (byte)(header2.PRGRAMEEPROMSize & 0x0F);
return shift > 0 ? 64 << shift : 0;
}
else
{
return 0;
}
}
}
/// <summary>
/// PRG-ROM size in bytes
/// </summary>
/// <remarks>Extended by NES 2.0</remarks>
public int PRGROMSize
{
get
@@ -333,21 +277,6 @@ namespace SabreTools.Serialization.Wrappers
/// <inheritdoc cref="Cart.PlayChoicePROM"/>
public byte[] PlayChoicePROM => Model.PlayChoicePROM;
/// <summary>
/// Submapper number
/// </summary>
public int SubmapperNumber
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
return header2.MapperMSBSubmapper >> 4;
}
}
/// <inheritdoc cref="Cart.Title"/>
public byte[] Title => Model.Title;
@@ -392,9 +321,198 @@ namespace SabreTools.Serialization.Wrappers
}
}
#endregion
#region NES 1.0
/// <summary>
/// Indicates if the board has bus conflicts
/// </summary>
/// <remarks>Defined only for NES 1.0</remarks>
public bool HasBusConflicts
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header1 header1)
return false;
#if NET20 || NET35
return (header1.Flag10 & Flag10.BoardHasBusConflicts) != 0;
#else
return header1.Flag10.HasFlag(Flag10.BoardHasBusConflicts);
#endif
}
}
/// <summary>
/// Indicates if PRG RAM at $6000-$7FFF is present
/// </summary>
/// <remarks>Defined only for NES 1.0</remarks>
public bool HasPRGRAM
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header1 header1)
return false;
#if NET20 || NET35
return (header1.Flag10 & Flag10.PRGRAMNotPresent) == 0;
#else
return !header1.Flag10.HasFlag(Flag10.PRGRAMNotPresent);
#endif
}
}
#endregion
#region NES 2.0
/// <summary>
/// CHR-NVRAM size in bytes
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public int CHRNVRAMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.CHRRAMSize >> 4);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// CHR-RAM size in bytes
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public int CHRRAMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.CHRRAMSize & 0x0F);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// CPU/PPU Timing
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public CPUPPUTiming CPUPPUTiming
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return CPUPPUTiming.RP2C02;
return header2.CPUPPUTiming;
}
}
/// <summary>
/// Default expansion device
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public DefaultExpansionDevice DefaultExpansionDevice
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return DefaultExpansionDevice.Unspecified;
return header2.DefaultExpansionDevice;
}
}
/// <summary>
/// Extended console type
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
/// <remarks>Only valid if <see cref="Flag7.ExtendedConsoleType"/> is set</remarks>
public ExtendedConsoleType ExtendedConsoleType
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return ExtendedConsoleType.RegularSystem;
#if NET20 || NET35
if ((Header.Flag7 & Flag7.ExtendedConsoleType) != 0)
#else
if (Header.Flag7.HasFlag(Flag7.ExtendedConsoleType))
#endif
return (ExtendedConsoleType)(header2.ExtendedSystemType & 0x0F);
// If flag is unset
return ExtendedConsoleType.RegularSystem;
}
}
/// <summary>
/// Number of miscellaneous ROMs present
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public int MiscellaneousROMs
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
return header2.MiscellaneousROMs;
}
}
/// <summary>
/// PRG-NVRAM/EEPROM size in bytes
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public int PRGRAMEEPROMSize
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
byte shift = (byte)(header2.PRGRAMEEPROMSize >> 4);
return shift > 0 ? 64 << shift : 0;
}
}
/// <summary>
/// Submapper number
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
public int SubmapperNumber
{
get
{
// Missing or invalid header
if (Header is null || Header is not Header2 header2)
return 0;
return header2.MapperMSBSubmapper >> 4;
}
}
/// <summary>
/// Vs. Hardware Type
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
/// <remarks>Only valid if <see cref="Flag7.VSUnisystem"/> is set</remarks>
public VsHardwareType VsHardwareType
{
@@ -419,6 +537,7 @@ namespace SabreTools.Serialization.Wrappers
/// <summary>
/// Vs. System Type
/// </summary>
/// <remarks>Defined only for NES 2.0</remarks>
/// <remarks>Only valid if <see cref="Flag7.VSUnisystem"/> is set</remarks>
public VsSystemType VsSystemType
{
@@ -442,6 +561,8 @@ namespace SabreTools.Serialization.Wrappers
#endregion
#endregion
#region Constructors
/// <inheritdoc/>