using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
namespace BinaryObjectScanner.Wrappers
{
public class GCF : WrapperBase
{
#region Descriptive Properties
///
public override string Description => "Half-Life Game Cache File (GCF)";
#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 Block Entry Header
///
public uint BEH_BlockCount => _file.BlockEntryHeader.BlockCount;
///
public uint BEH_BlocksUsed => _file.BlockEntryHeader.BlocksUsed;
///
public uint BEH_Dummy0 => _file.BlockEntryHeader.Dummy0;
///
public uint BEH_Dummy1 => _file.BlockEntryHeader.Dummy1;
///
public uint BEH_Dummy2 => _file.BlockEntryHeader.Dummy2;
///
public uint BEH_Dummy3 => _file.BlockEntryHeader.Dummy3;
///
public uint BEH_Dummy4 => _file.BlockEntryHeader.Dummy4;
///
public uint BEH_Checksum => _file.BlockEntryHeader.Checksum;
#endregion
#region Block Entries
///
public BinaryObjectScanner.Models.GCF.BlockEntry[] BlockEntries => _file.BlockEntries;
#endregion
#region Fragmentation Map Header
///
public uint FMH_BlockCount => _file.FragmentationMapHeader.BlockCount;
///
public uint FMH_FirstUnusedEntry => _file.FragmentationMapHeader.FirstUnusedEntry;
///
public uint FMH_Terminator => _file.FragmentationMapHeader.Terminator;
///
public uint FMH_Checksum => _file.FragmentationMapHeader.Checksum;
#endregion
#region Fragmentation Maps
///
public BinaryObjectScanner.Models.GCF.FragmentationMap[] FragmentationMaps => _file.FragmentationMaps;
#endregion
#region Block Entry Map Header
///
public uint? BEMH_BlockCount => _file.BlockEntryMapHeader?.BlockCount;
///
public uint? BEMH_FirstBlockEntryIndex => _file.BlockEntryMapHeader?.FirstBlockEntryIndex;
///
public uint? BEMH_LastBlockEntryIndex => _file.BlockEntryMapHeader?.LastBlockEntryIndex;
///
public uint? BEMH_Dummy0 => _file.BlockEntryMapHeader?.Dummy0;
///
public uint? BEMH_Checksum => _file.BlockEntryMapHeader?.Checksum;
#endregion
#region Block Entry Maps
///
public BinaryObjectScanner.Models.GCF.BlockEntryMap[] BlockEntryMaps => _file.BlockEntryMaps;
#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_Dummy1 => _file.DirectoryHeader.Dummy1;
///
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_Dummy2 => _file.DirectoryHeader.Dummy2;
///
public uint DH_Dummy3 => _file.DirectoryHeader.Dummy3;
///
public uint DH_Checksum => _file.DirectoryHeader.Checksum;
#endregion
#region Directory Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryEntry[] DirectoryEntries => _file.DirectoryEntries;
#endregion
#region Directory Names
///
public System.Collections.Generic.Dictionary DirectoryNames => _file.DirectoryNames;
#endregion
#region Directory Info 1 Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryInfo1Entry[] DirectoryInfo1Entries => _file.DirectoryInfo1Entries;
#endregion
#region Directory Info 2 Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryInfo2Entry[] DirectoryInfo2Entries => _file.DirectoryInfo2Entries;
#endregion
#region Directory Copy Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryCopyEntry[] DirectoryCopyEntries => _file.DirectoryCopyEntries;
#endregion
#region Directory Local Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryLocalEntry[] DirectoryLocalEntries => _file.DirectoryLocalEntries;
#endregion
#region Directory Map Header
///
public uint? DMH_Dummy0 => _file.DirectoryMapHeader?.Dummy0;
///
public uint? DMH_Dummy1 => _file.DirectoryMapHeader?.Dummy1;
#endregion
#region Directory Map Entries
///
public BinaryObjectScanner.Models.GCF.DirectoryMapEntry[] DirectoryMapEntries => _file.DirectoryMapEntries;
#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 BinaryObjectScanner.Models.GCF.ChecksumMapEntry[] ChecksumMapEntries => _file.ChecksumMapEntries;
#endregion
#region Checksum Entries
///
public BinaryObjectScanner.Models.GCF.ChecksumEntry[] ChecksumEntries => _file.ChecksumEntries;
#endregion
#region Data Block Header
///
public uint DBH_LastVersionPlayed => _file.DataBlockHeader.LastVersionPlayed;
///
public uint DBH_BlockCount => _file.DataBlockHeader.BlockCount;
///
public uint DBH_BlockSize => _file.DataBlockHeader.BlockSize;
///
public uint DBH_FirstBlockOffset => _file.DataBlockHeader.FirstBlockOffset;
///
public uint DBH_BlocksUsed => _file.DataBlockHeader.BlocksUsed;
///
public uint DBH_Checksum => _file.DataBlockHeader.Checksum;
#endregion
#endregion
#region Extension Properties
///
/// Set of all files and their information
///
public FileInfo[] Files
{
get
{
// Use the cached value if we have it
if (_files != null)
return _files;
// Otherwise, scan and build the files
var files = new List();
for (int i = 0; i < DirectoryEntries.Length; i++)
{
// Get the directory entry
var directoryEntry = DirectoryEntries[i];
var directoryMapEntry = DirectoryMapEntries[i];
// If we have a directory, skip for now
if (!directoryEntry.DirectoryFlags.HasFlag(BinaryObjectScanner.Models.GCF.HL_GCF_FLAG.HL_GCF_FLAG_FILE))
continue;
// Otherwise, start building the file info
var fileInfo = new FileInfo()
{
Size = directoryEntry.ItemSize,
Encrypted = directoryEntry.DirectoryFlags.HasFlag(BinaryObjectScanner.Models.GCF.HL_GCF_FLAG.HL_GCF_FLAG_ENCRYPTED),
};
var pathParts = new List { directoryEntry.Name };
var blockEntries = new List();
// Traverse the parent tree
uint index = directoryEntry.ParentIndex;
while (index != 0xFFFFFFFF)
{
var parentDirectoryEntry = DirectoryEntries[index];
pathParts.Add(parentDirectoryEntry.Name);
index = parentDirectoryEntry.ParentIndex;
}
// Traverse the block entries
index = directoryMapEntry.FirstBlockIndex;
while (index != DBH_BlockCount)
{
var nextBlock = BlockEntries[index];
blockEntries.Add(nextBlock);
index = nextBlock.NextBlockEntryIndex;
}
// Reverse the path parts because of traversal
pathParts.Reverse();
// Build the remaining file info
fileInfo.Path = Path.Combine(pathParts.ToArray());
fileInfo.BlockEntries = blockEntries.ToArray();
// Add the file info and continue
files.Add(fileInfo);
}
// Set and return the file infos
_files = files.ToArray();
return _files;
}
}
///
/// Set of all data block offsets
///
public long[] DataBlockOffsets
{
get
{
// Use the cached value if we have it
if (_dataBlockOffsets != null)
return _dataBlockOffsets;
// Otherwise, build the data block set
_dataBlockOffsets = new long[DBH_BlockCount];
for (int i = 0; i < DBH_BlockCount; i++)
{
long dataBlockOffset = DBH_FirstBlockOffset + (i * DBH_BlockSize);
_dataBlockOffsets[i] = dataBlockOffset;
}
// Return the set of data blocks
return _dataBlockOffsets;
}
}
#endregion
#region Instance Variables
///
/// Internal representation of the GCF
///
private BinaryObjectScanner.Models.GCF.File _file;
///
/// Set of all files and their information
///
private FileInfo[] _files = null;
///
/// Set of all data block offsets
///
private long[] _dataBlockOffsets = null;
#endregion
#region Constructors
///
/// Private constructor
///
private GCF() { }
///
/// Create an GCF from a byte array and offset
///
/// Byte array representing the GCF
/// Offset within the array to parse
/// An GCF wrapper on success, null on failure
public static GCF 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 GCF from a Stream
///
/// Stream representing the GCF
/// An GCF wrapper on success, null on failure
public static GCF Create(Stream data)
{
// If the data is invalid
if (data == null || data.Length == 0 || !data.CanSeek || !data.CanRead)
return null;
var file = Builders.GCF.ParseFile(data);
if (file == null)
return null;
var wrapper = new GCF
{
_file = file,
_dataSource = DataSource.Stream,
_streamData = data,
};
return wrapper;
}
#endregion
#region Printing
///
public override StringBuilder PrettyPrint()
{
StringBuilder builder = new StringBuilder();
builder.AppendLine("GCF Information:");
builder.AppendLine("-------------------------");
builder.AppendLine();
// Header
PrintHeader(builder);
// Block Entries
PrintBlockEntryHeader(builder);
PrintBlockEntries(builder);
// Fragmentation Maps
PrintFragmentationMapHeader(builder);
PrintFragmentationMaps(builder);
// Block Entry Maps
PrintBlockEntryMapHeader(builder);
PrintBlockEntryMaps(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);
PrintDirectoryMapHeader(builder);
PrintDirectoryMapEntries(builder);
// Checksums and Checksum Maps
PrintChecksumHeader(builder);
PrintChecksumMapHeader(builder);
PrintChecksumMapEntries(builder);
PrintChecksumEntries(builder);
// Data Blocks
PrintDataBlockHeader(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 block entry header information
///
/// StringBuilder to append information to
private void PrintBlockEntryHeader(StringBuilder builder)
{
builder.AppendLine(" Block Entry Header Information:");
builder.AppendLine(" -------------------------");
builder.AppendLine($" Block count: {BEH_BlockCount} (0x{BEH_BlockCount:X})");
builder.AppendLine($" Blocks used: {BEH_BlocksUsed} (0x{BEH_BlocksUsed:X})");
builder.AppendLine($" Dummy 0: {BEH_Dummy0} (0x{BEH_Dummy0:X})");
builder.AppendLine($" Dummy 1: {BEH_Dummy1} (0x{BEH_Dummy1:X})");
builder.AppendLine($" Dummy 2: {BEH_Dummy2} (0x{BEH_Dummy2:X})");
builder.AppendLine($" Dummy 3: {BEH_Dummy3} (0x{BEH_Dummy3:X})");
builder.AppendLine($" Dummy 4: {BEH_Dummy4} (0x{BEH_Dummy4:X})");
builder.AppendLine($" Checksum: {BEH_Checksum} (0x{BEH_Checksum:X})");
builder.AppendLine();
}
///
/// Print block entries information
///
/// StringBuilder to append information to
private void PrintBlockEntries(StringBuilder builder)
{
builder.AppendLine(" Block Entries Information:");
builder.AppendLine(" -------------------------");
if (BlockEntries == null || BlockEntries.Length == 0)
{
builder.AppendLine(" No block entries");
}
else
{
for (int i = 0; i < BlockEntries.Length; i++)
{
var blockEntry = BlockEntries[i];
builder.AppendLine($" Block Entry {i}");
builder.AppendLine($" Entry flags: {blockEntry.EntryFlags} (0x{blockEntry.EntryFlags:X})");
builder.AppendLine($" File data offset: {blockEntry.FileDataOffset} (0x{blockEntry.FileDataOffset:X})");
builder.AppendLine($" File data size: {blockEntry.FileDataSize} (0x{blockEntry.FileDataSize:X})");
builder.AppendLine($" First data block index: {blockEntry.FirstDataBlockIndex} (0x{blockEntry.FirstDataBlockIndex:X})");
builder.AppendLine($" Next block entry index: {blockEntry.NextBlockEntryIndex} (0x{blockEntry.NextBlockEntryIndex:X})");
builder.AppendLine($" Previous block entry index: {blockEntry.PreviousBlockEntryIndex} (0x{blockEntry.PreviousBlockEntryIndex:X})");
builder.AppendLine($" Directory index: {blockEntry.DirectoryIndex} (0x{blockEntry.DirectoryIndex:X})");
}
}
builder.AppendLine();
}
///
/// Print fragmentation map header information
///
/// StringBuilder to append information to
private void PrintFragmentationMapHeader(StringBuilder builder)
{
builder.AppendLine(" Fragmentation Map Header Information:");
builder.AppendLine(" -------------------------");
builder.AppendLine($" Block count: {FMH_BlockCount} (0x{FMH_BlockCount:X})");
builder.AppendLine($" First unused entry: {FMH_FirstUnusedEntry} (0x{FMH_FirstUnusedEntry:X})");
builder.AppendLine($" Terminator: {FMH_Terminator} (0x{FMH_Terminator:X})");
builder.AppendLine($" Checksum: {FMH_Checksum} (0x{FMH_Checksum:X})");
builder.AppendLine();
}
///
/// Print fragmentation maps information
///
/// StringBuilder to append information to
private void PrintFragmentationMaps(StringBuilder builder)
{
builder.AppendLine(" Fragmentation Maps Information:");
builder.AppendLine(" -------------------------");
if (FragmentationMaps == null || FragmentationMaps.Length == 0)
{
builder.AppendLine(" No fragmentation maps");
}
else
{
for (int i = 0; i < FragmentationMaps.Length; i++)
{
var fragmentationMap = FragmentationMaps[i];
builder.AppendLine($" Fragmentation Map {i}");
builder.AppendLine($" Next data block index: {fragmentationMap.NextDataBlockIndex} (0x{fragmentationMap.NextDataBlockIndex:X})");
}
}
builder.AppendLine();
}
///
/// Print block entry map header information
///
/// StringBuilder to append information to
private void PrintBlockEntryMapHeader(StringBuilder builder)
{
builder.AppendLine(" Block Entry Map Header Information:");
builder.AppendLine(" -------------------------");
if (_file.BlockEntryMapHeader == null)
{
builder.AppendLine($" No block entry map header");
}
else
{
builder.AppendLine($" Block count: {BEMH_BlockCount} (0x{BEMH_BlockCount:X})");
builder.AppendLine($" First block entry index: {BEMH_FirstBlockEntryIndex} (0x{BEMH_FirstBlockEntryIndex:X})");
builder.AppendLine($" Last block entry index: {BEMH_LastBlockEntryIndex} (0x{BEMH_LastBlockEntryIndex:X})");
builder.AppendLine($" Dummy 0: {BEMH_Dummy0} (0x{BEMH_Dummy0:X})");
builder.AppendLine($" Checksum: {BEMH_Checksum} (0x{BEMH_Checksum:X})");
}
builder.AppendLine();
}
///
/// Print block entry maps information
///
/// StringBuilder to append information to
private void PrintBlockEntryMaps(StringBuilder builder)
{
builder.AppendLine(" Block Entry Maps Information:");
builder.AppendLine(" -------------------------");
if (BlockEntryMaps == null || BlockEntryMaps.Length == 0)
{
builder.AppendLine(" No block entry maps");
}
else
{
for (int i = 0; i < BlockEntryMaps.Length; i++)
{
var blockEntryMap = BlockEntryMaps[i];
builder.AppendLine($" Block Entry Map {i}");
builder.AppendLine($" Previous data block index: {blockEntryMap.PreviousBlockEntryIndex} (0x{blockEntryMap.PreviousBlockEntryIndex:X})");
builder.AppendLine($" Next data block index: {blockEntryMap.NextBlockEntryIndex} (0x{blockEntryMap.NextBlockEntryIndex: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($" Dummy 1: {DH_Dummy1} (0x{DH_Dummy1: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 2: {DH_Dummy2} (0x{DH_Dummy2:X})");
builder.AppendLine($" Dummy 3: {DH_Dummy3} (0x{DH_Dummy3: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 ?? "[NULL]"}");
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 directory map header information
///
/// StringBuilder to append information to
private void PrintDirectoryMapHeader(StringBuilder builder)
{
builder.AppendLine(" Directory Map Header Information:");
builder.AppendLine(" -------------------------");
if (_file.DirectoryMapHeader == null)
{
builder.AppendLine($" No directory map header");
}
else
{
builder.AppendLine($" Dummy 0: {DMH_Dummy0} (0x{DMH_Dummy0:X})");
builder.AppendLine($" Dummy 1: {DMH_Dummy1} (0x{DMH_Dummy1:X})");
}
builder.AppendLine();
}
///
/// Print directory map entries information
///
/// StringBuilder to append information to
private void PrintDirectoryMapEntries(StringBuilder builder)
{
builder.AppendLine(" Directory Map Entries Information:");
builder.AppendLine(value: " -------------------------");
if (DirectoryMapEntries == null || DirectoryMapEntries.Length == 0)
{
builder.AppendLine(" No directory map entries");
}
else
{
for (int i = 0; i < DirectoryMapEntries.Length; i++)
{
var directoryMapEntry = DirectoryMapEntries[i];
builder.AppendLine($" Directory Map Entry {i}");
builder.AppendLine($" First block index: {directoryMapEntry.FirstBlockIndex} (0x{directoryMapEntry.FirstBlockIndex: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();
}
///
/// Print data block header information
///
/// StringBuilder to append information to
private void PrintDataBlockHeader(StringBuilder builder)
{
builder.AppendLine(" Data Block Header Information:");
builder.AppendLine(" -------------------------");
builder.AppendLine($" Last version played: {DBH_LastVersionPlayed} (0x{DBH_LastVersionPlayed:X})");
builder.AppendLine($" Block count: {DBH_BlockCount} (0x{DBH_BlockCount:X})");
builder.AppendLine($" Block size: {DBH_BlockSize} (0x{DBH_BlockSize:X})");
builder.AppendLine($" First block offset: {DBH_FirstBlockOffset} (0x{DBH_FirstBlockOffset:X})");
builder.AppendLine($" Blocks used: {DBH_BlocksUsed} (0x{DBH_BlocksUsed:X})");
builder.AppendLine($" Checksum: {DBH_Checksum} (0x{DBH_Checksum:X})");
builder.AppendLine();
}
#if NET6_0_OR_GREATER
///
public override string ExportJSON() => System.Text.Json.JsonSerializer.Serialize(_file, _jsonSerializerOptions);
#endif
#endregion
#region Extraction
///
/// Extract all files from the GCF to an output directory
///
/// Output directory to write to
/// True if all files extracted, false otherwise
public bool ExtractAll(string outputDirectory)
{
// If we have no files
if (Files == null || Files.Length == 0)
return false;
// Loop through and extract all files to the output
bool allExtracted = true;
for (int i = 0; i < Files.Length; i++)
{
allExtracted &= ExtractFile(i, outputDirectory);
}
return allExtracted;
}
///
/// Extract a file from the GCF to an output directory by index
///
/// File index to extract
/// Output directory to write to
/// True if the file extracted, false otherwise
public bool ExtractFile(int index, string outputDirectory)
{
// If we have no files
if (Files == null || Files.Length == 0)
return false;
// If the files index is invalid
if (index < 0 || index >= Files.Length)
return false;
// Get the file
var file = Files[index];
if (file.Size == 0)
return false;
// If the file is encrypted -- TODO: Revisit later
if (file.Encrypted)
return false;
// Get all data block offsets needed for extraction
var dataBlockOffsets = new List();
for (int i = 0; i < file.BlockEntries.Length; i++)
{
var blockEntry = file.BlockEntries[i];
uint dataBlockIndex = blockEntry.FirstDataBlockIndex;
long blockEntrySize = blockEntry.FileDataSize;
while (blockEntrySize > 0)
{
long dataBlockOffset = DataBlockOffsets[dataBlockIndex++];
dataBlockOffsets.Add(dataBlockOffset);
blockEntrySize -= DBH_BlockSize;
}
}
// Create the filename
string filename = file.Path;
// If we have an invalid output directory
if (string.IsNullOrWhiteSpace(outputDirectory))
return false;
// Create the full output path
filename = Path.Combine(outputDirectory, filename);
// Ensure the output directory is created
Directory.CreateDirectory(Path.GetDirectoryName(filename));
// Try to write the data
try
{
// Open the output file for writing
using (Stream fs = File.OpenWrite(filename))
{
// Now read the data sequentially and write out while we have data left
long fileSize = file.Size;
for (int i = 0; i < dataBlockOffsets.Count; i++)
{
int readSize = (int)Math.Min(DBH_BlockSize, fileSize);
byte[] data = ReadFromDataSource((int)dataBlockOffsets[i], readSize);
fs.Write(data, 0, data.Length);
}
}
}
catch
{
return false;
}
return true;
}
#endregion
#region Helper Classes
///
/// Class to contain all necessary file information
///
public sealed class FileInfo
{
///
/// Full item path
///
public string Path;
///
/// File size
///
public uint Size;
///
/// Indicates if the block is encrypted
///
public bool Encrypted;
///
/// Array of block entries
///
public BinaryObjectScanner.Models.GCF.BlockEntry[] BlockEntries;
}
#endregion
}
}