SabreTools.Serialization/SabreTools.Serialization/Extensions.PortableExecutable.cs

using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Xml.Serialization;
using SabreTools.IO.Extensions;
using SabreTools.Models.PortableExecutable;

namespace SabreTools.Serialization
{
    public static partial class Extensions
    {
        /// <summary>
        /// Convert a relative virtual address to a physical one
        /// </summary>
        /// <param name="rva">Relative virtual address to convert</param>
        /// <param name="sections">Array of sections to check against</param>
        /// <returns>Physical address, 0 on error</returns>
        public static uint ConvertVirtualAddress(this uint rva, SectionHeader[]? sections)
        {
            // If we have an invalid section table, we can't do anything
            if (sections == null || sections.Length == 0)
                return 0;

            // If the RVA is 0, we just return 0 because it's invalid
            if (rva == 0)
                return 0;

            // If the RVA matches a section start exactly, use that
            var matchingSection = Array.Find(sections, s => s.VirtualAddress == rva);
            if (matchingSection != null)
                return rva - matchingSection.VirtualAddress + matchingSection.PointerToRawData;

            // Loop through all of the sections
            for (int i = 0; i < sections.Length; i++)
            {
                // If the section "starts" at 0, just skip it
                var section = sections[i];
                if (section.PointerToRawData == 0)
                    continue;

                // If the virtual address is greater than the RVA
                if (rva < section.VirtualAddress)
                    continue;

                // Attempt to derive the physical address from the current section
                if (section.VirtualSize != 0 && rva <= section.VirtualAddress + section.VirtualSize)
                    return rva - section.VirtualAddress + section.PointerToRawData;
                else if (section.SizeOfRawData != 0 && rva <= section.VirtualAddress + section.SizeOfRawData)
                    return rva - section.VirtualAddress + section.PointerToRawData;
            }

            return 0;
        }

        /// <summary>
        /// Find the section a revlative virtual address lives in
        /// </summary>
        /// <param name="rva">Relative virtual address to convert</param>
        /// <param name="sections">Array of sections to check against</param>
        /// <returns>Section index, null on error</returns>
        public static int ContainingSectionIndex(this uint rva, SectionHeader[]? sections)
        {
            // If we have an invalid section table, we can't do anything
            if (sections == null || sections.Length == 0)
                return -1;

            // If the RVA is 0, we just return -1 because it's invalid
            if (rva == 0)
                return -1;

            // Loop through all of the sections
            for (int i = 0; i < sections.Length; i++)
            {
                // If the section "starts" at 0, just skip it
                var section = sections[i];
                if (section.PointerToRawData == 0)
                    continue;

                // If the virtual address is greater than the RVA
                if (rva < section.VirtualAddress)
                    continue;

                // Attempt to derive the physical address from the current section
                if (section.VirtualSize != 0 && rva <= section.VirtualAddress + section.VirtualSize)
                    return i;
                else if (section.SizeOfRawData != 0 && rva <= section.VirtualAddress + section.SizeOfRawData)
                    return i;
            }

            return -1;
        }

        #region Debug

        /// <summary>
        /// Parse a byte array into a NB10ProgramDatabase
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled NB10ProgramDatabase on success, null on error</returns>
        public static NB10ProgramDatabase? ParseNB10ProgramDatabase(this byte[] data, ref int offset)
        {
            var obj = new NB10ProgramDatabase();

            obj.Signature = data.ReadUInt32LittleEndian(ref offset);
            if (obj.Signature != 0x3031424E)
                return null;

            obj.Offset = data.ReadUInt32LittleEndian(ref offset);
            obj.Timestamp = data.ReadUInt32LittleEndian(ref offset);
            obj.Age = data.ReadUInt32LittleEndian(ref offset);
            obj.PdbFileName = data.ReadNullTerminatedAnsiString(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a RSDSProgramDatabase
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled RSDSProgramDatabase on success, null on error</returns>
        public static RSDSProgramDatabase? ParseRSDSProgramDatabase(this byte[] data, ref int offset)
        {
            var obj = new RSDSProgramDatabase();

            obj.Signature = data.ReadUInt32LittleEndian(ref offset);
            if (obj.Signature != 0x53445352)
                return null;

            obj.GUID = data.ReadGuid(ref offset);
            obj.Age = data.ReadUInt32LittleEndian(ref offset);
            obj.PathAndFileName = data.ReadNullTerminatedUTF8String(ref offset);

            return obj;
        }

        #endregion

        #region Overlay

        /// <summary>
        /// Parse a byte array into a SecuROMAddD
        /// </summary>
        /// <param name="data">Data to parse into overlay data</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled SecuROMAddD on success, null on error</returns>
        public static SecuROMAddD? ParseSecuROMAddD(this byte[] data, ref int offset)
        {
            // Read in the table
            var obj = new SecuROMAddD();

            obj.Signature = data.ReadUInt32LittleEndian(ref offset);
            if (obj.Signature != 0x44646441)
                return null;

            int originalOffset = offset;

            obj.EntryCount = data.ReadUInt32LittleEndian(ref offset);
            obj.Version = data.ReadNullTerminatedAnsiString(ref offset);
            if (string.IsNullOrEmpty(obj.Version))
                offset = originalOffset + 0x10;

            var buildBytes = data.ReadBytes(ref offset, 4);
            var buildChars = Array.ConvertAll(buildBytes, b => (char)b);
            obj.Build = buildChars;

            // Distinguish between v1 and v2
            int bytesToRead = 112; // v2
            if (string.IsNullOrEmpty(obj.Version)
                || obj.Version!.StartsWith("3")
                || obj.Version.StartsWith("4.47"))
            {
                bytesToRead = 44;
            }

            obj.Unknown14h = data.ReadBytes(ref offset, bytesToRead);

            obj.Entries = new SecuROMAddDEntry[obj.EntryCount];
            for (int i = 0; i < obj.EntryCount; i++)
            {
                obj.Entries[i] = ParseSecuROMAddDEntry(data, ref offset);
            }

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a SecuROMAddDEntry
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>Filled SecuROMAddDEntry on success, null on error</returns>
        public static SecuROMAddDEntry ParseSecuROMAddDEntry(this byte[] data, ref int offset)
        {
            var obj = new SecuROMAddDEntry();

            obj.PhysicalOffset = data.ReadUInt32LittleEndian(ref offset);
            obj.Length = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown08h = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown0Ch = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown10h = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown14h = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown18h = data.ReadUInt32LittleEndian(ref offset);
            obj.Unknown1Ch = data.ReadUInt32LittleEndian(ref offset);
            obj.FileName = data.ReadNullTerminatedAnsiString(ref offset);
            obj.Unknown2Ch = data.ReadUInt32LittleEndian(ref offset);

            return obj;
        }

        #endregion

        // TODO: Implement other resource types from https://learn.microsoft.com/en-us/windows/win32/menurc/resource-file-formats
        #region Resources

        /// <summary>
        /// Read resource data as an accelerator table resource
        /// </summary>
        /// <param name="entry">Resource data entry to parse into an accelerator table resource</param>
        /// <returns>A filled accelerator table resource on success, null on error</returns>
        public static AcceleratorTableEntry[]? AsAcceleratorTableResource(this ResourceDataEntry? entry)
        {
            // If we have data that's invalid for this resource type, we can't do anything
            if (entry?.Data == null || entry.Data.Length % 8 != 0)
                return null;

            // Get the number of entries
            int count = entry.Data.Length / 8;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var table = new AcceleratorTableEntry[count];

            // Read in the table
            for (int i = 0; i < count; i++)
            {
                table[i] = ParseAcceleratorTableEntry(entry.Data, ref offset);
            }

            return table;
        }

        /// <summary>
        /// Read resource data as a side-by-side assembly manifest
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a side-by-side assembly manifest</param>
        /// <returns>A filled side-by-side assembly manifest on success, null on error</returns>
        public static AssemblyManifest? AsAssemblyManifest(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            try
            {
                var serializer = new XmlSerializer(typeof(AssemblyManifest));
                return serializer.Deserialize(new MemoryStream(entry.Data)) as AssemblyManifest;
            }
            catch
            {
                return null;
            }
        }

        /// <summary>
        /// Read resource data as a dialog box
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a dialog box</param>
        /// <returns>A filled dialog box on success, null on error</returns>
        public static DialogBoxResource? AsDialogBox(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var dialogBoxResource = new DialogBoxResource();

            // Try to read the signature for an extended dialog box template
            int signatureOffset = sizeof(ushort);
            int possibleSignature = entry.Data.ReadUInt16LittleEndian(ref signatureOffset);
            if (possibleSignature == 0xFFFF)
            {
                #region Extended dialog template

                var dialogTemplateExtended = new DialogTemplateExtended();

                dialogTemplateExtended.Version = entry.Data.ReadUInt16LittleEndian(ref offset);
                dialogTemplateExtended.Signature = entry.Data.ReadUInt16LittleEndian(ref offset);
                dialogTemplateExtended.HelpID = entry.Data.ReadUInt32LittleEndian(ref offset);
                dialogTemplateExtended.ExtendedStyle = (ExtendedWindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                dialogTemplateExtended.Style = (WindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                dialogTemplateExtended.DialogItems = entry.Data.ReadUInt16LittleEndian(ref offset);
                dialogTemplateExtended.PositionX = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplateExtended.PositionY = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplateExtended.WidthX = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplateExtended.HeightY = entry.Data.ReadInt16LittleEndian(ref offset);

                #region Menu resource

                int currentOffset = offset;
                ushort menuResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (menuResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Flag if there's an ordinal at the end
                    bool menuResourceHasOrdinal = menuResourceIdentifier == 0xFFFF;
                    if (menuResourceHasOrdinal)
                        offset += sizeof(ushort);

                    // Read the menu resource as a string
                    dialogTemplateExtended.MenuResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);

                    // Read the ordinal if we have the flag set
                    if (menuResourceHasOrdinal)
                        dialogTemplateExtended.MenuResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                }

                #endregion

                #region Class resource

                currentOffset = offset;
                ushort classResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (classResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Flag if there's an ordinal at the end
                    bool classResourcehasOrdinal = classResourceIdentifier == 0xFFFF;
                    if (classResourcehasOrdinal)
                        offset += sizeof(ushort);

                    // Read the class resource as a string
                    dialogTemplateExtended.ClassResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);

                    // Read the ordinal if we have the flag set
                    if (classResourcehasOrdinal)
                        dialogTemplateExtended.ClassResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                }

                #endregion

                #region Title resource

                currentOffset = offset;
                ushort titleResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (titleResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Read the title resource as a string
                    dialogTemplateExtended.TitleResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);
                }

                #endregion

                #region Point size and typeface

                // Only if DS_SETFONT is set are the values here used
#if NET20 || NET35
                if ((dialogTemplateExtended.Style & WindowStyles.DS_SETFONT) != 0)
#else
                if (dialogTemplateExtended.Style.HasFlag(WindowStyles.DS_SETFONT))
#endif
                {
                    dialogTemplateExtended.PointSize = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dialogTemplateExtended.Weight = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dialogTemplateExtended.Italic = entry.Data.ReadByte(ref offset);
                    dialogTemplateExtended.CharSet = entry.Data.ReadByte(ref offset);
                    dialogTemplateExtended.Typeface = entry.Data.ReadNullTerminatedUnicodeString(ref offset);
                }

                // Align to the DWORD boundary if we're not at the end
                entry.Data.AlignToBoundary(ref offset, 4);

                #endregion

                dialogBoxResource.ExtendedDialogTemplate = dialogTemplateExtended;

                #endregion

                #region Extended dialog item templates

                var dialogItemExtendedTemplates = new List<DialogItemTemplateExtended>();

                for (int i = 0; i < dialogTemplateExtended.DialogItems; i++)
                {
                    var dialogItemTemplate = new DialogItemTemplateExtended();

                    dialogItemTemplate.HelpID = entry.Data.ReadUInt32LittleEndian(ref offset);
                    dialogItemTemplate.ExtendedStyle = (ExtendedWindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                    dialogItemTemplate.Style = (WindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                    dialogItemTemplate.PositionX = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.PositionY = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.WidthX = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.HeightY = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.ID = entry.Data.ReadUInt32LittleEndian(ref offset);

                    #region Class resource

                    currentOffset = offset;
                    ushort itemClassResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                    offset = currentOffset;

                    // 0xFFFF means ordinal only
                    if (itemClassResourceIdentifier == 0xFFFF)
                    {
                        // Increment the pointer
                        _ = entry.Data.ReadUInt16LittleEndian(ref offset);

                        // Read the ordinal
                        dialogItemTemplate.ClassResourceOrdinal = (DialogItemTemplateOrdinal)entry.Data.ReadUInt16LittleEndian(ref offset);
                    }
                    else
                    {
                        // Flag if there's an ordinal at the end
                        bool classResourcehasOrdinal = itemClassResourceIdentifier == 0xFFFF;
                        if (classResourcehasOrdinal)
                            offset += sizeof(ushort);

                        // Read the class resource as a string
                        dialogItemTemplate.ClassResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                        // Align to the WORD boundary if we're not at the end
                        entry.Data.AlignToBoundary(ref offset, 2);
                    }

                    #endregion

                    #region Title resource

                    currentOffset = offset;
                    ushort itemTitleResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                    offset = currentOffset;

                    // 0xFFFF means ordinal only
                    if (itemTitleResourceIdentifier == 0xFFFF)
                    {
                        // Increment the pointer
                        _ = entry.Data.ReadUInt16LittleEndian(ref offset);

                        // Read the ordinal
                        dialogItemTemplate.TitleResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                    }
                    else
                    {
                        // Read the title resource as a string
                        dialogItemTemplate.TitleResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                        // Align to the WORD boundary if we're not at the end
                        entry.Data.AlignToBoundary(ref offset, 2);
                    }

                    #endregion

                    #region Creation data

                    dialogItemTemplate.CreationDataSize = entry.Data.ReadUInt16LittleEndian(ref offset);
                    if (dialogItemTemplate.CreationDataSize != 0)
                        dialogItemTemplate.CreationData = entry.Data.ReadBytes(ref offset, dialogItemTemplate.CreationDataSize);

                    #endregion

                    // Align to the DWORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 4);

                    dialogItemExtendedTemplates.Add(dialogItemTemplate);

                    // If we have an invalid item count
                    if (offset >= entry.Data.Length)
                        break;
                }

                dialogBoxResource.ExtendedDialogItemTemplates = [.. dialogItemExtendedTemplates];

                #endregion
            }
            else
            {
                #region Dialog template

                var dialogTemplate = new DialogTemplate();

                dialogTemplate.Style = (WindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                dialogTemplate.ExtendedStyle = (ExtendedWindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                dialogTemplate.ItemCount = entry.Data.ReadUInt16LittleEndian(ref offset);
                dialogTemplate.PositionX = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplate.PositionY = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplate.WidthX = entry.Data.ReadInt16LittleEndian(ref offset);
                dialogTemplate.HeightY = entry.Data.ReadInt16LittleEndian(ref offset);

                #region Menu resource

                int currentOffset = offset;
                ushort menuResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (menuResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Flag if there's an ordinal at the end
                    bool menuResourceHasOrdinal = menuResourceIdentifier == 0xFFFF;
                    if (menuResourceHasOrdinal)
                        offset += sizeof(ushort);

                    // Read the menu resource as a string
                    dialogTemplate.MenuResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);

                    // Read the ordinal if we have the flag set
                    if (menuResourceHasOrdinal)
                        dialogTemplate.MenuResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                }

                #endregion

                #region Class resource

                currentOffset = offset;
                ushort classResourceIdentifier;
                if (offset >= entry.Data.Length)
                    classResourceIdentifier = 0x0000;
                else
                    classResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (classResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Flag if there's an ordinal at the end
                    bool classResourcehasOrdinal = classResourceIdentifier == 0xFFFF;
                    if (classResourcehasOrdinal)
                        offset += sizeof(ushort);

                    // Read the class resource as a string
                    dialogTemplate.ClassResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);

                    // Read the ordinal if we have the flag set
                    if (classResourcehasOrdinal)
                        dialogTemplate.ClassResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                }

                #endregion

                #region Title resource

                currentOffset = offset;
                ushort titleResourceIdentifier;
                if (offset >= entry.Data.Length)
                    titleResourceIdentifier = 0x0000;
                else
                    titleResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                offset = currentOffset;

                // 0x0000 means no elements
                if (titleResourceIdentifier == 0x0000)
                {
                    // Increment the pointer if it was empty
                    offset += sizeof(ushort);
                }
                else
                {
                    // Read the title resource as a string
                    dialogTemplate.TitleResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the WORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 2);
                }

                #endregion

                #region Point size and typeface

                // Only if DS_SETFONT is set are the values here used
#if NET20 || NET35
                if ((dialogTemplate.Style & WindowStyles.DS_SETFONT) != 0)
#else
                if (dialogTemplate.Style.HasFlag(WindowStyles.DS_SETFONT))
#endif
                {
                    dialogTemplate.PointSizeValue = entry.Data.ReadUInt16LittleEndian(ref offset);

                    // Read the font name as a string
                    dialogTemplate.Typeface = entry.Data.ReadNullTerminatedUnicodeString(ref offset);
                }

                // Align to the DWORD boundary if we're not at the end
                entry.Data.AlignToBoundary(ref offset, 4);

                #endregion

                dialogBoxResource.DialogTemplate = dialogTemplate;

                #endregion

                #region Dialog item templates

                var dialogItemTemplates = new List<DialogItemTemplate>();

                for (int i = 0; i < dialogTemplate.ItemCount; i++)
                {
                    var dialogItemTemplate = new DialogItemTemplate();

                    dialogItemTemplate.Style = (WindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                    dialogItemTemplate.ExtendedStyle = (ExtendedWindowStyles)entry.Data.ReadUInt32LittleEndian(ref offset);
                    dialogItemTemplate.PositionX = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.PositionY = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.WidthX = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.HeightY = entry.Data.ReadInt16LittleEndian(ref offset);
                    dialogItemTemplate.ID = entry.Data.ReadUInt16LittleEndian(ref offset);

                    #region Class resource

                    currentOffset = offset;
                    ushort itemClassResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                    offset = currentOffset;

                    // 0xFFFF means ordinal only
                    if (itemClassResourceIdentifier == 0xFFFF)
                    {
                        // Increment the pointer
                        _ = entry.Data.ReadUInt16LittleEndian(ref offset);

                        // Read the ordinal
                        dialogItemTemplate.ClassResourceOrdinal = (DialogItemTemplateOrdinal)entry.Data.ReadUInt16LittleEndian(ref offset);
                    }
                    else
                    {
                        // Flag if there's an ordinal at the end
                        bool classResourcehasOrdinal = itemClassResourceIdentifier == 0xFFFF;
                        if (classResourcehasOrdinal)
                            offset += sizeof(ushort);

                        // Read the class resource as a string
                        dialogItemTemplate.ClassResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                        // Align to the WORD boundary if we're not at the end
                        entry.Data.AlignToBoundary(ref offset, 2);
                    }

                    #endregion

                    #region Title resource

                    currentOffset = offset;
                    ushort itemTitleResourceIdentifier = entry.Data.ReadUInt16LittleEndian(ref offset);
                    offset = currentOffset;

                    // 0xFFFF means ordinal only
                    if (itemTitleResourceIdentifier == 0xFFFF)
                    {
                        // Increment the pointer
                        _ = entry.Data.ReadUInt16LittleEndian(ref offset);

                        // Read the ordinal
                        dialogItemTemplate.TitleResourceOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);
                    }
                    else
                    {
                        // Read the title resource as a string
                        dialogItemTemplate.TitleResource = entry.Data.ReadNullTerminatedUnicodeString(ref offset);

                        // Align to the WORD boundary if we're not at the end
                        entry.Data.AlignToBoundary(ref offset, 2);
                    }

                    #endregion

                    #region Creation data

                    dialogItemTemplate.CreationDataSize = entry.Data.ReadUInt16LittleEndian(ref offset);
                    if (dialogItemTemplate.CreationDataSize != 0)
                        dialogItemTemplate.CreationData = entry.Data.ReadBytes(ref offset, dialogItemTemplate.CreationDataSize);

                    #endregion

                    // Align to the DWORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 4);

                    dialogItemTemplates.Add(dialogItemTemplate);

                    // If we have an invalid item count
                    if (offset >= entry.Data.Length)
                        break;
                }

                dialogBoxResource.DialogItemTemplates = [.. dialogItemTemplates];

                #endregion
            }

            return dialogBoxResource;
        }

        /// <summary>
        /// Read resource data as a font group
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a font group</param>
        /// <returns>A filled font group on success, null on error</returns>
        public static FontGroupHeader? AsFontGroup(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var fontGroupHeader = new FontGroupHeader();

            fontGroupHeader.NumberOfFonts = entry.Data.ReadUInt16LittleEndian(ref offset);
            if (fontGroupHeader.NumberOfFonts > 0)
            {
                fontGroupHeader.DE = new DirEntry[fontGroupHeader.NumberOfFonts];
                for (int i = 0; i < fontGroupHeader.NumberOfFonts; i++)
                {
                    var dirEntry = new DirEntry();

                    dirEntry.FontOrdinal = entry.Data.ReadUInt16LittleEndian(ref offset);

                    dirEntry.Entry = new FontDirEntry();
                    dirEntry.Entry.Version = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.Size = entry.Data.ReadUInt32LittleEndian(ref offset);
                    dirEntry.Entry.Copyright = entry.Data.ReadBytes(ref offset, 60);
                    dirEntry.Entry.Type = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.Points = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.VertRes = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.HorizRes = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.Ascent = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.InternalLeading = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.ExternalLeading = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.Italic = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.Underline = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.StrikeOut = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.Weight = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.CharSet = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.PixWidth = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.PixHeight = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.PitchAndFamily = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.AvgWidth = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.MaxWidth = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.FirstChar = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.LastChar = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.DefaultChar = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.BreakChar = entry.Data.ReadByte(ref offset);
                    dirEntry.Entry.WidthBytes = entry.Data.ReadUInt16LittleEndian(ref offset);
                    dirEntry.Entry.Device = entry.Data.ReadUInt32LittleEndian(ref offset);
                    dirEntry.Entry.Face = entry.Data.ReadUInt32LittleEndian(ref offset);
                    dirEntry.Entry.Reserved = entry.Data.ReadUInt32LittleEndian(ref offset);

                    // TODO: Determine how to read these two? Immediately after?
                    dirEntry.Entry.DeviceName = entry.Data.ReadNullTerminatedAnsiString(ref offset);
                    dirEntry.Entry.FaceName = entry.Data.ReadNullTerminatedAnsiString(ref offset);

                    fontGroupHeader.DE[i] = dirEntry;
                }
            }

            // TODO: Implement entry parsing
            return fontGroupHeader;
        }

        /// <summary>
        /// Read resource data as a menu
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a menu</param>
        /// <returns>A filled menu on success, null on error</returns>
        public static MenuResource? AsMenu(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var menuResource = new MenuResource();

            // Try to read the version for an extended header
            int versionOffset = 0;
            int possibleVersion = entry.Data.ReadUInt16LittleEndian(ref versionOffset);
            if (possibleVersion == 0x0001)
            {
                #region Extended menu header

                var menuHeaderExtended = ParseMenuHeaderExtended(entry.Data, ref offset);
                menuResource.MenuHeader = menuHeaderExtended;

                #endregion

                #region Extended dialog item templates

                var extendedMenuItems = new List<MenuItemExtended>();

                if (offset != 0)
                {
                    offset = menuHeaderExtended.Offset;

                    while (offset < entry.Data.Length)
                    {
                        var extendedMenuItem = ParseMenuItemExtended(entry.Data, ref offset);
                        extendedMenuItems.Add(extendedMenuItem);

                        // Align to the DWORD boundary if we're not at the end
                        entry.Data.AlignToBoundary(ref offset, 4);
                    }
                }

                menuResource.MenuItems = [.. extendedMenuItems];

                #endregion
            }
            else
            {
                #region Menu header

                menuResource.MenuHeader = ParseNormalMenuHeader(entry.Data, ref offset);

                #endregion

                #region Menu items

                var menuItems = new List<MenuItem>();

                while (offset < entry.Data.Length)
                {
                    // Determine if this is a popup
                    int flagsOffset = offset;
                    var initialFlags = (MenuFlags)entry.Data.ReadUInt16LittleEndian(ref flagsOffset);

                    MenuItem? menuItem;
#if NET20 || NET35
                    if ((initialFlags & MenuFlags.MF_POPUP) != 0)
#else
                    if (initialFlags.HasFlag(MenuFlags.MF_POPUP))
#endif
                        menuItem = ParsePopupMenuItem(entry.Data, ref offset);
                    else
                        menuItem = ParseNormalMenuItem(entry.Data, ref offset);

                    // Align to the DWORD boundary if we're not at the end
                    entry.Data.AlignToBoundary(ref offset, 4);

                    if (menuItem == null)
                        return null;

                    menuItems.Add(menuItem);
                }

                menuResource.MenuItems = [.. menuItems];

                #endregion
            }

            return menuResource;
        }

        /// <summary>
        /// Read resource data as a message table resource
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a message table resource</param>
        /// <returns>A filled message table resource on success, null on error</returns>
        public static MessageResourceData? AsMessageResourceData(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var messageResourceData = new MessageResourceData();

            // Message resource blocks
            messageResourceData.NumberOfBlocks = entry.Data.ReadUInt32LittleEndian(ref offset);
            if (messageResourceData.NumberOfBlocks > 0)
            {
                var messageResourceBlocks = new List<MessageResourceBlock>();

                for (int i = 0; i < messageResourceData.NumberOfBlocks; i++)
                {
                    var messageResourceBlock = ParseMessageResourceBlock(entry.Data, ref offset);
                    messageResourceBlocks.Add(messageResourceBlock);
                }

                messageResourceData.Blocks = [.. messageResourceBlocks];
            }

            // Message resource entries
            if (messageResourceData.Blocks != null && messageResourceData.Blocks.Length != 0)
            {
                var messageResourceEntries = new Dictionary<uint, MessageResourceEntry?>();

                for (int i = 0; i < messageResourceData.Blocks.Length; i++)
                {
                    var messageResourceBlock = messageResourceData.Blocks[i];
                    if (messageResourceBlock == null)
                        continue;

                    offset = (int)messageResourceBlock.OffsetToEntries;

                    for (uint j = messageResourceBlock.LowId; j <= messageResourceBlock.HighId; j++)
                    {
                        var messageResourceEntry = new MessageResourceEntry();

                        messageResourceEntry.Length = entry.Data.ReadUInt16LittleEndian(ref offset);
                        messageResourceEntry.Flags = entry.Data.ReadUInt16LittleEndian(ref offset);

                        Encoding textEncoding = messageResourceEntry.Flags == 0x0001 ? Encoding.Unicode : Encoding.ASCII;
                        byte[]? textArray = entry.Data.ReadBytes(ref offset, messageResourceEntry.Length - 4);
                        if (textArray != null)
                            messageResourceEntry.Text = textEncoding.GetString(textArray);

                        messageResourceEntries[j] = messageResourceEntry;
                    }
                }

                messageResourceData.Entries = messageResourceEntries;
            }

            return messageResourceData;
        }

        /// <summary>
        ///  Read byte data as a string file info resource
        /// </summary>
        /// <param name="data">Data to parse into a string file info</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled string file info resource on success, null on error</returns>
        public static StringFileInfo? AsStringFileInfo(byte[] data, ref int offset)
        {
            var stringFileInfo = new StringFileInfo();

            // Cache the initial offset
            int currentOffset = offset;

            stringFileInfo.Length = data.ReadUInt16LittleEndian(ref offset);
            stringFileInfo.ValueLength = data.ReadUInt16LittleEndian(ref offset);
            stringFileInfo.ResourceType = (VersionResourceType)data.ReadUInt16LittleEndian(ref offset);
            stringFileInfo.Key = data.ReadNullTerminatedUnicodeString(ref offset);
            if (stringFileInfo.Key != "StringFileInfo")
            {
                offset -= 6 + ((stringFileInfo.Key?.Length ?? 0 + 1) * 2);
                return null;
            }

            // Align to the DWORD boundary if we're not at the end
            data.AlignToBoundary(ref offset, 4);

            var stringFileInfoChildren = new List<StringTable>();
            while ((offset - currentOffset) < stringFileInfo.Length)
            {
                var stringTable = new StringTable();

                stringTable.Length = data.ReadUInt16LittleEndian(ref offset);
                stringTable.ValueLength = data.ReadUInt16LittleEndian(ref offset);
                stringTable.ResourceType = (VersionResourceType)data.ReadUInt16LittleEndian(ref offset);
                stringTable.Key = data.ReadNullTerminatedUnicodeString(ref offset);

                // Align to the DWORD boundary if we're not at the end
                data.AlignToBoundary(ref offset, 4);

                var stringTableChildren = new List<StringData>();
                while ((offset - currentOffset) < stringTable.Length)
                {
                    var stringData = new StringData();

                    int dataStartOffset = offset;
                    stringData.Length = data.ReadUInt16LittleEndian(ref offset);
                    stringData.ValueLength = data.ReadUInt16LittleEndian(ref offset);
                    stringData.ResourceType = (VersionResourceType)data.ReadUInt16LittleEndian(ref offset);
                    stringData.Key = data.ReadNullTerminatedUnicodeString(ref offset);

                    // Align to the DWORD boundary if we're not at the end
                    data.AlignToBoundary(ref offset, 4);

                    if (stringData.ValueLength > 0)
                    {
                        int bytesReadable = Math.Min(stringData.ValueLength * sizeof(ushort), stringData.Length - (offset - dataStartOffset));
                        byte[] valueBytes = data.ReadBytes(ref offset, bytesReadable);
                        stringData.Value = Encoding.Unicode.GetString(valueBytes);
                    }

                    // Align to the DWORD boundary if we're not at the end
                    data.AlignToBoundary(ref offset, 4);

                    stringTableChildren.Add(stringData);
                    if (stringData.Length == 0 && stringData.ValueLength == 0)
                        break;
                }

                stringTable.Children = [.. stringTableChildren];

                stringFileInfoChildren.Add(stringTable);
            }

            stringFileInfo.Children = [.. stringFileInfoChildren];

            return stringFileInfo;
        }

        /// <summary>
        /// Read resource data as a string table resource
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a string table resource</param>
        /// <returns>A filled string table resource on success, null on error</returns>
        public static Dictionary<int, string?>? AsStringTable(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterators
            int offset = 0, stringIndex = 0;

            // Create the output table
            var stringTable = new Dictionary<int, string?>();

            // Loop through and add 
            while (offset < entry.Data.Length)
            {
                string? stringValue = entry.Data.ReadPrefixedUnicodeString(ref offset);
                if (stringValue != null)
                {
                    stringValue = stringValue.Replace("\n", "\\n").Replace("\r", newValue: "\\r");
                    stringTable[stringIndex++] = stringValue;
                }
            }

            return stringTable;
        }

        /// <summary>
        ///  Read byte data as a var file info resource
        /// </summary>
        /// <param name="data">Data to parse into a var file info</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled var file info resource on success, null on error</returns>
        public static VarFileInfo? AsVarFileInfo(byte[] data, ref int offset)
        {
            var varFileInfo = new VarFileInfo();

            // Cache the initial offset
            int initialOffset = offset;

            varFileInfo.Length = data.ReadUInt16LittleEndian(ref offset);
            varFileInfo.ValueLength = data.ReadUInt16LittleEndian(ref offset);
            varFileInfo.ResourceType = (VersionResourceType)data.ReadUInt16LittleEndian(ref offset);
            varFileInfo.Key = data.ReadNullTerminatedUnicodeString(ref offset);
            if (varFileInfo.Key != "VarFileInfo")
                return null;

            // Align to the DWORD boundary if we're not at the end
            data.AlignToBoundary(ref offset, 4);

            var varFileInfoChildren = new List<VarData>();
            while ((offset - initialOffset) < varFileInfo.Length)
            {
                var varData = new VarData();

                varData.Length = data.ReadUInt16LittleEndian(ref offset);
                varData.ValueLength = data.ReadUInt16LittleEndian(ref offset);
                varData.ResourceType = (VersionResourceType)data.ReadUInt16LittleEndian(ref offset);
                varData.Key = data.ReadNullTerminatedUnicodeString(ref offset);
                if (varData.Key != "Translation")
                {
                    offset -= 6 + ((varData.Key?.Length ?? 0 + 1) * 2);
                    return null;
                }

                // Align to the DWORD boundary if we're not at the end
                data.AlignToBoundary(ref offset, 4);

                // Cache the current offset
                int currentOffset = offset;

                var varDataValue = new List<uint>();
                while ((offset - currentOffset) < varData.ValueLength)
                {
                    uint languageAndCodeIdentifierPair = data.ReadUInt32LittleEndian(ref offset);
                    varDataValue.Add(languageAndCodeIdentifierPair);
                }

                varData.Value = [.. varDataValue];

                varFileInfoChildren.Add(varData);
            }

            varFileInfo.Children = [.. varFileInfoChildren];

            return varFileInfo;
        }

        /// <summary>
        /// Read resource data as a version info resource
        /// </summary>
        /// <param name="entry">Resource data entry to parse into a version info resource</param>
        /// <returns>A filled version info resource on success, null on error</returns>
        public static VersionInfo? AsVersionInfo(this ResourceDataEntry? entry)
        {
            // If we have an invalid entry, just skip
            if (entry?.Data == null)
                return null;

            // Initialize the iterator
            int offset = 0;

            // Create the output object
            var versionInfo = new VersionInfo();

            versionInfo.Length = entry.Data.ReadUInt16LittleEndian(ref offset);
            versionInfo.ValueLength = entry.Data.ReadUInt16LittleEndian(ref offset);
            versionInfo.ResourceType = (VersionResourceType)entry.Data.ReadUInt16LittleEndian(ref offset);
            versionInfo.Key = entry.Data.ReadNullTerminatedUnicodeString(ref offset);
            if (versionInfo.Key != "VS_VERSION_INFO")
                return null;

            while (offset < entry.Data.Length && (offset % 4) != 0)
                versionInfo.Padding1 = entry.Data.ReadUInt16LittleEndian(ref offset);

            // Read fixed file info
            if (versionInfo.ValueLength > 0 && offset + versionInfo.ValueLength <= entry.Data.Length)
            {
                var fixedFileInfo = ParseFixedFileInfo(entry.Data, ref offset);
                if (fixedFileInfo?.Signature != 0xFEEF04BD)
                    return null;

                versionInfo.Value = fixedFileInfo;
            }

            while (offset < entry.Data.Length && (offset % 4) != 0)
                versionInfo.Padding2 = entry.Data.ReadUInt16LittleEndian(ref offset);

            // TODO: Make the following block a private helper method

            // Determine if we have a StringFileInfo or VarFileInfo next
            if (offset < versionInfo.Length)
            {
                // Cache the current offset for reading
                int currentOffset = offset;

                offset += 6;
                string? nextKey = entry.Data.ReadNullTerminatedUnicodeString(ref offset);
                offset = currentOffset;

                if (nextKey == "StringFileInfo")
                {
                    var stringFileInfo = AsStringFileInfo(entry.Data, ref offset);
                    versionInfo.StringFileInfo = stringFileInfo;
                }
                else if (nextKey == "VarFileInfo")
                {
                    var varFileInfo = AsVarFileInfo(entry.Data, ref offset);
                    versionInfo.VarFileInfo = varFileInfo;
                }
            }

            // And again
            if (offset < versionInfo.Length)
            {
                // Cache the current offset for reading
                int currentOffset = offset;

                offset += 6;
                string? nextKey = entry.Data.ReadNullTerminatedUnicodeString(ref offset);
                offset = currentOffset;

                if (nextKey == "StringFileInfo")
                {
                    var stringFileInfo = AsStringFileInfo(entry.Data, ref offset);
                    versionInfo.StringFileInfo = stringFileInfo;
                }
                else if (nextKey == "VarFileInfo")
                {
                    var varFileInfo = AsVarFileInfo(entry.Data, ref offset);
                    versionInfo.VarFileInfo = varFileInfo;
                }
            }

            return versionInfo;
        }

        /// <summary>
        /// Parse a byte array into a AcceleratorTableEntry
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled AcceleratorTableEntry on success, null on error</returns>
        public static AcceleratorTableEntry ParseAcceleratorTableEntry(this byte[] data, ref int offset)
        {
            var obj = new AcceleratorTableEntry();

            obj.Flags = (AcceleratorTableFlags)data.ReadUInt16LittleEndian(ref offset);
            obj.Ansi = data.ReadUInt16LittleEndian(ref offset);
            obj.Id = data.ReadUInt16LittleEndian(ref offset);
            obj.Padding = data.ReadUInt16LittleEndian(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a FixedFileInfo
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled FixedFileInfo on success, null on error</returns>
        public static FixedFileInfo ParseFixedFileInfo(this byte[] data, ref int offset)
        {
            var obj = new FixedFileInfo();

            obj.Signature = data.ReadUInt32LittleEndian(ref offset);
            obj.StrucVersion = data.ReadUInt32LittleEndian(ref offset);
            obj.FileVersionMS = data.ReadUInt32LittleEndian(ref offset);
            obj.FileVersionLS = data.ReadUInt32LittleEndian(ref offset);
            obj.ProductVersionMS = data.ReadUInt32LittleEndian(ref offset);
            obj.ProductVersionLS = data.ReadUInt32LittleEndian(ref offset);
            obj.FileFlagsMask = data.ReadUInt32LittleEndian(ref offset);
            obj.FileFlags = (FixedFileInfoFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.FileOS = (FixedFileInfoOS)data.ReadUInt32LittleEndian(ref offset);
            obj.FileType = (FixedFileInfoFileType)data.ReadUInt32LittleEndian(ref offset);
            obj.FileSubtype = (FixedFileInfoFileSubtype)data.ReadUInt32LittleEndian(ref offset);
            obj.FileDateMS = data.ReadUInt32LittleEndian(ref offset);
            obj.FileDateLS = data.ReadUInt32LittleEndian(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a MenuHeaderExtended
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled MenuHeaderExtended on success, null on error</returns>
        public static MenuHeaderExtended ParseMenuHeaderExtended(this byte[] data, ref int offset)
        {
            var obj = new MenuHeaderExtended();

            obj.Version = data.ReadUInt16LittleEndian(ref offset);
            obj.Offset = data.ReadUInt16LittleEndian(ref offset);
            obj.HelpID = data.ReadUInt32LittleEndian(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a MenuItemExtended
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled MenuItemExtended on success, null on error</returns>
        public static MenuItemExtended ParseMenuItemExtended(this byte[] data, ref int offset)
        {
            var obj = new MenuItemExtended();

            obj.ItemType = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.State = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.ID = data.ReadUInt32LittleEndian(ref offset);
            obj.Flags = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.MenuText = data.ReadNullTerminatedUnicodeString(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a MessageResourceBlock
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled MessageResourceBlock on success, null on error</returns>
        public static MessageResourceBlock ParseMessageResourceBlock(this byte[] data, ref int offset)
        {
            var obj = new MessageResourceBlock();

            obj.LowId = data.ReadUInt32LittleEndian(ref offset);
            obj.HighId = data.ReadUInt32LittleEndian(ref offset);
            obj.OffsetToEntries = data.ReadUInt32LittleEndian(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a NormalMenuHeader
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled NormalMenuHeader on success, null on error</returns>
        public static NormalMenuHeader ParseNormalMenuHeader(this byte[] data, ref int offset)
        {
            var obj = new NormalMenuHeader();

            obj.Version = data.ReadUInt16LittleEndian(ref offset);
            obj.HeaderSize = data.ReadUInt16LittleEndian(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a NormalMenuItem
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled NormalMenuItem on success, null on error</returns>
        public static NormalMenuItem ParseNormalMenuItem(this byte[] data, ref int offset)
        {
            var obj = new NormalMenuItem();

            obj.NormalResInfo = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.NormalMenuText = data.ReadNullTerminatedUnicodeString(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a PopupMenuItem
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled PopupMenuItem on success, null on error</returns>
        public static PopupMenuItem ParsePopupMenuItem(this byte[] data, ref int offset)
        {
            var obj = new PopupMenuItem();

            obj.PopupItemType = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.PopupState = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.PopupID = data.ReadUInt32LittleEndian(ref offset);
            obj.PopupResInfo = (MenuFlags)data.ReadUInt32LittleEndian(ref offset);
            obj.PopupMenuText = data.ReadNullTerminatedUnicodeString(ref offset);

            return obj;
        }

        /// <summary>
        /// Parse a byte array into a ResourceHeader
        /// </summary>
        /// <param name="data">Data to parse</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <returns>A filled ResourceHeader on success, null on error</returns>
        public static ResourceHeader ParseResourceHeader(this byte[] data, ref int offset)
        {
            // Read in the table
            var obj = new ResourceHeader();

            obj.DataSize = data.ReadUInt32LittleEndian(ref offset);
            obj.HeaderSize = data.ReadUInt32LittleEndian(ref offset);
            obj.ResourceType = (ResourceType)data.ReadUInt32LittleEndian(ref offset); // TODO: Could be a string too
            obj.Name = data.ReadUInt32LittleEndian(ref offset); // TODO: Could be a string too
            obj.DataVersion = data.ReadUInt32LittleEndian(ref offset);
            obj.MemoryFlags = (MemoryFlags)data.ReadUInt16LittleEndian(ref offset);
            obj.LanguageId = data.ReadUInt16LittleEndian(ref offset);
            obj.Version = data.ReadUInt32LittleEndian(ref offset);
            obj.Characteristics = data.ReadUInt32LittleEndian(ref offset);

            return obj;
        }

        #endregion

        #region Helpers

        /// <summary>
        /// Align the array position to a byte-size boundary
        /// </summary>
        /// <param name="input">Input array to try aligning</param>
        /// <param name="offset">Offset into the byte array</param>
        /// <param name="alignment">Number of bytes to align on</param>
        /// <returns>True if the array could be aligned, false otherwise</returns>
        private static bool AlignToBoundary(this byte[]? input, ref int offset, byte alignment)
        {
            // If the array is invalid
            if (input == null || input.Length == 0)
                return false;

            // If already at the end of the array
            if (offset >= input.Length)
                return false;

            // Align the stream position
            while (offset % alignment != 0 && offset < input.Length)
            {
                _ = input.ReadByteValue(ref offset);
            }

            // Return if the alignment completed
            return offset % alignment == 0;
        }

        #endregion
    }
}