using System.IO; using System.Text; namespace BinaryObjectScanner.Wrappers { public class NCF : WrapperBase { #region Descriptive Properties /// public override string Description => "Half-Life No Cache File (NCF)"; #endregion #region Pass-Through Properties #region Header /// public uint Dummy0 => _file.Header.Dummy0; /// public uint MajorVersion => _file.Header.MajorVersion; /// public uint MinorVersion => _file.Header.MinorVersion; /// public uint CacheID => _file.Header.CacheID; /// public uint LastVersionPlayed => _file.Header.LastVersionPlayed; /// public uint Dummy1 => _file.Header.Dummy1; /// public uint Dummy2 => _file.Header.Dummy2; /// public uint FileSize => _file.Header.FileSize; /// public uint BlockSize => _file.Header.BlockSize; /// public uint BlockCount => _file.Header.BlockCount; /// public uint Dummy3 => _file.Header.Dummy3; #endregion #region Directory Header /// public uint DH_Dummy0 => _file.DirectoryHeader.Dummy0; /// public uint DH_CacheID => _file.DirectoryHeader.CacheID; /// public uint DH_LastVersionPlayed => _file.DirectoryHeader.LastVersionPlayed; /// public uint DH_ItemCount => _file.DirectoryHeader.ItemCount; /// public uint DH_FileCount => _file.DirectoryHeader.FileCount; /// public uint DH_ChecksumDataLength => _file.DirectoryHeader.ChecksumDataLength; /// public uint DH_DirectorySize => _file.DirectoryHeader.DirectorySize; /// public uint DH_NameSize => _file.DirectoryHeader.NameSize; /// public uint DH_Info1Count => _file.DirectoryHeader.Info1Count; /// public uint DH_CopyCount => _file.DirectoryHeader.CopyCount; /// public uint DH_LocalCount => _file.DirectoryHeader.LocalCount; /// public uint DH_Dummy1 => _file.DirectoryHeader.Dummy1; /// public uint DH_Dummy2 => _file.DirectoryHeader.Dummy2; /// public uint DH_Checksum => _file.DirectoryHeader.Checksum; #endregion #region Directory Entries /// public Models.NCF.DirectoryEntry[] DirectoryEntries => _file.DirectoryEntries; #endregion #region Directory Names /// public System.Collections.Generic.Dictionary DirectoryNames => _file.DirectoryNames; #endregion #region Directory Info 1 Entries /// public Models.NCF.DirectoryInfo1Entry[] DirectoryInfo1Entries => _file.DirectoryInfo1Entries; #endregion #region Directory Info 2 Entries /// public Models.NCF.DirectoryInfo2Entry[] DirectoryInfo2Entries => _file.DirectoryInfo2Entries; #endregion #region Directory Copy Entries /// public Models.NCF.DirectoryCopyEntry[] DirectoryCopyEntries => _file.DirectoryCopyEntries; #endregion #region Directory Local Entries /// public Models.NCF.DirectoryLocalEntry[] DirectoryLocalEntries => _file.DirectoryLocalEntries; #endregion #region Unknown Header /// public uint UH_Dummy0 => _file.UnknownHeader.Dummy0; /// public uint UH_Dummy1 => _file.UnknownHeader.Dummy1; #endregion #region Unknown Entries /// public Models.NCF.UnknownEntry[] UnknownEntries => _file.UnknownEntries; #endregion #region Checksum Header /// public uint CH_Dummy0 => _file.ChecksumHeader.Dummy0; /// public uint CH_ChecksumSize => _file.ChecksumHeader.ChecksumSize; #endregion #region Checksum Map Header /// public uint CMH_Dummy0 => _file.ChecksumMapHeader.Dummy0; /// public uint CMH_Dummy1 => _file.ChecksumMapHeader.Dummy1; /// public uint CMH_ItemCount => _file.ChecksumMapHeader.ItemCount; /// public uint CMH_ChecksumCount => _file.ChecksumMapHeader.ChecksumCount; #endregion #region Checksum Map Entries /// public Models.NCF.ChecksumMapEntry[] ChecksumMapEntries => _file.ChecksumMapEntries; #endregion #region Checksum Entries /// public Models.NCF.ChecksumEntry[] ChecksumEntries => _file.ChecksumEntries; #endregion #endregion #region Instance Variables /// /// Internal representation of the NCF /// private Models.NCF.File _file; #endregion #region Constructors /// /// Private constructor /// private NCF() { } /// /// Create an NCF from a byte array and offset /// /// Byte array representing the NCF /// Offset within the array to parse /// An NCF wrapper on success, null on failure public static NCF Create(byte[] data, int offset) { // If the data is invalid if (data == null) return null; // If the offset is out of bounds if (offset < 0 || offset >= data.Length) return null; // Create a memory stream and use that MemoryStream dataStream = new MemoryStream(data, offset, data.Length - offset); return Create(dataStream); } /// /// Create a NCF from a Stream /// /// Stream representing the NCF /// An NCF wrapper on success, null on failure public static NCF Create(Stream data) { // If the data is invalid if (data == null || data.Length == 0 || !data.CanSeek || !data.CanRead) return null; var file = Builders.NCF.ParseFile(data); if (file == null) return null; var wrapper = new NCF { _file = file, _dataSource = DataSource.Stream, _streamData = data, }; return wrapper; } #endregion #region Printing /// public override StringBuilder PrettyPrint() { StringBuilder builder = new StringBuilder(); builder.AppendLine("NCF Information:"); builder.AppendLine("-------------------------"); builder.AppendLine(); // Header PrintHeader(builder); // Directory and Directory Maps PrintDirectoryHeader(builder); PrintDirectoryEntries(builder); // TODO: Should we print out the entire string table? PrintDirectoryInfo1Entries(builder); PrintDirectoryInfo2Entries(builder); PrintDirectoryCopyEntries(builder); PrintDirectoryLocalEntries(builder); PrintUnknownHeader(builder); PrintUnknownEntries(builder); // Checksums and Checksum Maps PrintChecksumHeader(builder); PrintChecksumMapHeader(builder); PrintChecksumMapEntries(builder); PrintChecksumEntries(builder); return builder; } /// /// Print header information /// /// StringBuilder to append information to private void PrintHeader(StringBuilder builder) { builder.AppendLine(" Header Information:"); builder.AppendLine(" -------------------------"); builder.AppendLine($" Dummy 0: {Dummy0} (0x{Dummy0:X})"); builder.AppendLine($" Major version: {MajorVersion} (0x{MajorVersion:X})"); builder.AppendLine($" Minor version: {MinorVersion} (0x{MinorVersion:X})"); builder.AppendLine($" Cache ID: {CacheID} (0x{CacheID:X})"); builder.AppendLine($" Last version played: {LastVersionPlayed} (0x{LastVersionPlayed:X})"); builder.AppendLine($" Dummy 1: {Dummy1} (0x{Dummy1:X})"); builder.AppendLine($" Dummy 2: {Dummy2} (0x{Dummy2:X})"); builder.AppendLine($" File size: {FileSize} (0x{FileSize:X})"); builder.AppendLine($" Block size: {BlockSize} (0x{BlockSize:X})"); builder.AppendLine($" Block count: {BlockCount} (0x{BlockCount:X})"); builder.AppendLine($" Dummy 3: {Dummy3} (0x{Dummy3:X})"); builder.AppendLine(); } /// /// Print directory header information /// /// StringBuilder to append information to private void PrintDirectoryHeader(StringBuilder builder) { builder.AppendLine(" Directory Header Information:"); builder.AppendLine(" -------------------------"); builder.AppendLine($" Dummy 0: {DH_Dummy0} (0x{DH_Dummy0:X})"); builder.AppendLine($" Cache ID: {DH_CacheID} (0x{DH_CacheID:X})"); builder.AppendLine($" Last version played: {DH_LastVersionPlayed} (0x{DH_LastVersionPlayed:X})"); builder.AppendLine($" Item count: {DH_ItemCount} (0x{DH_ItemCount:X})"); builder.AppendLine($" File count: {DH_FileCount} (0x{DH_FileCount:X})"); builder.AppendLine($" Checksum data length: {DH_ChecksumDataLength} (0x{DH_ChecksumDataLength:X})"); builder.AppendLine($" Directory size: {DH_DirectorySize} (0x{DH_DirectorySize:X})"); builder.AppendLine($" Name size: {DH_NameSize} (0x{DH_NameSize:X})"); builder.AppendLine($" Info 1 count: {DH_Info1Count} (0x{DH_Info1Count:X})"); builder.AppendLine($" Copy count: {DH_CopyCount} (0x{DH_CopyCount:X})"); builder.AppendLine($" Local count: {DH_LocalCount} (0x{DH_LocalCount:X})"); builder.AppendLine($" Dummy 1: {DH_Dummy1} (0x{DH_Dummy1:X})"); builder.AppendLine($" Dummy 2: {DH_Dummy2} (0x{DH_Dummy2:X})"); builder.AppendLine($" Checksum: {DH_Checksum} (0x{DH_Checksum:X})"); builder.AppendLine(); } /// /// Print directory entries information /// /// StringBuilder to append information to private void PrintDirectoryEntries(StringBuilder builder) { builder.AppendLine(" Directory Entries Information:"); builder.AppendLine(" -------------------------"); if (DirectoryEntries == null || DirectoryEntries.Length == 0) { builder.AppendLine(" No directory entries"); } else { for (int i = 0; i < DirectoryEntries.Length; i++) { var directoryEntry = DirectoryEntries[i]; builder.AppendLine($" Directory Entry {i}"); builder.AppendLine($" Name offset: {directoryEntry.NameOffset} (0x{directoryEntry.NameOffset:X})"); builder.AppendLine($" Name: {directoryEntry.Name}"); builder.AppendLine($" Item size: {directoryEntry.ItemSize} (0x{directoryEntry.ItemSize:X})"); builder.AppendLine($" Checksum index: {directoryEntry.ChecksumIndex} (0x{directoryEntry.ChecksumIndex:X})"); builder.AppendLine($" Directory flags: {directoryEntry.DirectoryFlags} (0x{directoryEntry.DirectoryFlags:X})"); builder.AppendLine($" Parent index: {directoryEntry.ParentIndex} (0x{directoryEntry.ParentIndex:X})"); builder.AppendLine($" Next index: {directoryEntry.NextIndex} (0x{directoryEntry.NextIndex:X})"); builder.AppendLine($" First index: {directoryEntry.FirstIndex} (0x{directoryEntry.FirstIndex:X})"); } } builder.AppendLine(); } /// /// Print directory info 1 entries information /// /// StringBuilder to append information to private void PrintDirectoryInfo1Entries(StringBuilder builder) { builder.AppendLine(" Directory Info 1 Entries Information:"); builder.AppendLine(" -------------------------"); if (DirectoryInfo1Entries == null || DirectoryInfo1Entries.Length == 0) { builder.AppendLine(" No directory info 1 entries"); } else { for (int i = 0; i < DirectoryInfo1Entries.Length; i++) { var directoryInfoEntry = DirectoryInfo1Entries[i]; builder.AppendLine($" Directory Info 1 Entry {i}"); builder.AppendLine($" Dummy 0: {directoryInfoEntry.Dummy0} (0x{directoryInfoEntry.Dummy0:X})"); } } builder.AppendLine(); } /// /// Print directory info 2 entries information /// /// StringBuilder to append information to private void PrintDirectoryInfo2Entries(StringBuilder builder) { builder.AppendLine(" Directory Info 2 Entries Information:"); builder.AppendLine(" -------------------------"); if (DirectoryInfo2Entries == null || DirectoryInfo2Entries.Length == 0) { builder.AppendLine(" No directory info 2 entries"); } else { for (int i = 0; i < DirectoryInfo2Entries.Length; i++) { var directoryInfoEntry = DirectoryInfo2Entries[i]; builder.AppendLine($" Directory Info 2 Entry {i}"); builder.AppendLine($" Dummy 0: {directoryInfoEntry.Dummy0} (0x{directoryInfoEntry.Dummy0:X})"); } } builder.AppendLine(); } /// /// Print directory copy entries information /// /// StringBuilder to append information to private void PrintDirectoryCopyEntries(StringBuilder builder) { builder.AppendLine(" Directory Copy Entries Information:"); builder.AppendLine(value: " -------------------------"); if (DirectoryCopyEntries == null || DirectoryCopyEntries.Length == 0) { builder.AppendLine(" No directory copy entries"); } else { for (int i = 0; i < DirectoryCopyEntries.Length; i++) { var directoryCopyEntry = DirectoryCopyEntries[i]; builder.AppendLine($" Directory Copy Entry {i}"); builder.AppendLine($" Directory index: {directoryCopyEntry.DirectoryIndex} (0x{directoryCopyEntry.DirectoryIndex:X})"); } } builder.AppendLine(); } /// /// Print directory local entries information /// /// StringBuilder to append information to private void PrintDirectoryLocalEntries(StringBuilder builder) { builder.AppendLine(" Directory Local Entries Information:"); builder.AppendLine(value: " -------------------------"); if (DirectoryLocalEntries == null || DirectoryLocalEntries.Length == 0) { builder.AppendLine(" No directory local entries"); } else { for (int i = 0; i < DirectoryLocalEntries.Length; i++) { var directoryLocalEntry = DirectoryLocalEntries[i]; builder.AppendLine($" Directory Local Entry {i}"); builder.AppendLine($" Directory index: {directoryLocalEntry.DirectoryIndex} (0x{directoryLocalEntry.DirectoryIndex:X})"); } } builder.AppendLine(); } /// /// Print unknown header information /// /// StringBuilder to append information to private void PrintUnknownHeader(StringBuilder builder) { builder.AppendLine(" Unknown Header Information:"); builder.AppendLine(" -------------------------"); builder.AppendLine($" Dummy 0: {UH_Dummy0} (0x{UH_Dummy0:X})"); builder.AppendLine($" Dummy 1: {UH_Dummy1} (0x{UH_Dummy1:X})"); builder.AppendLine(); } /// /// Print unknown entries information /// /// StringBuilder to append information to private void PrintUnknownEntries(StringBuilder builder) { builder.AppendLine(" Unknown Entries Information:"); builder.AppendLine(value: " -------------------------"); if (UnknownEntries == null || UnknownEntries.Length == 0) { builder.AppendLine(" No unknown entries"); } else { for (int i = 0; i < UnknownEntries.Length; i++) { var unknownEntry = UnknownEntries[i]; builder.AppendLine($" Unknown Entry {i}"); builder.AppendLine($" Dummy 0: {unknownEntry.Dummy0} (0x{unknownEntry.Dummy0:X})"); } } builder.AppendLine(); } /// /// Print checksum header information /// /// StringBuilder to append information to private void PrintChecksumHeader(StringBuilder builder) { builder.AppendLine(" Checksum Header Information:"); builder.AppendLine(" -------------------------"); builder.AppendLine($" Dummy 0: {CH_Dummy0} (0x{CH_Dummy0:X})"); builder.AppendLine($" Checksum size: {CH_ChecksumSize} (0x{CH_ChecksumSize:X})"); builder.AppendLine(); } /// /// Print checksum map header information /// /// StringBuilder to append information to private void PrintChecksumMapHeader(StringBuilder builder) { builder.AppendLine(" Checksum Map Header Information:"); builder.AppendLine(" -------------------------"); builder.AppendLine($" Dummy 0: {CMH_Dummy0} (0x{CMH_Dummy0:X})"); builder.AppendLine($" Dummy 1: {CMH_Dummy1} (0x{CMH_Dummy1:X})"); builder.AppendLine($" Item count: {CMH_ItemCount} (0x{CMH_ItemCount:X})"); builder.AppendLine($" Checksum count: {CMH_ChecksumCount} (0x{CMH_ChecksumCount:X})"); builder.AppendLine(); } /// /// Print checksum map entries information /// /// StringBuilder to append information to private void PrintChecksumMapEntries(StringBuilder builder) { builder.AppendLine(" Checksum Map Entries Information:"); builder.AppendLine(value: " -------------------------"); if (ChecksumMapEntries == null || ChecksumMapEntries.Length == 0) { builder.AppendLine(" No checksum map entries"); } else { for (int i = 0; i < ChecksumMapEntries.Length; i++) { var checksumMapEntry = ChecksumMapEntries[i]; builder.AppendLine($" Checksum Map Entry {i}"); builder.AppendLine($" Checksum count: {checksumMapEntry.ChecksumCount} (0x{checksumMapEntry.ChecksumCount:X})"); builder.AppendLine($" First checksum index: {checksumMapEntry.FirstChecksumIndex} (0x{checksumMapEntry.FirstChecksumIndex:X})"); } } builder.AppendLine(); } /// /// Print checksum entries information /// /// StringBuilder to append information to private void PrintChecksumEntries(StringBuilder builder) { builder.AppendLine(" Checksum Entries Information:"); builder.AppendLine(value: " -------------------------"); if (ChecksumEntries == null || ChecksumEntries.Length == 0) { builder.AppendLine(" No checksum entries"); } else { for (int i = 0; i < ChecksumEntries.Length; i++) { var checksumEntry = ChecksumEntries[i]; builder.AppendLine($" Checksum Entry {i}"); builder.AppendLine($" Checksum: {checksumEntry.Checksum} (0x{checksumEntry.Checksum:X})"); } } builder.AppendLine(); } #if NET6_0_OR_GREATER /// public override string ExportJSON() => System.Text.Json.JsonSerializer.Serialize(_file, _jsonSerializerOptions); #endif #endregion } }