// READERS / WRITERS
/// <summary>
/// Reads a data block from a file binary stream.
/// </summary>
/// <param name="binaryReader">Binary reader to read the block from. Must point to the beginning of the block.</param>
/// <param name="index">Index within a sequence (starts at 0).</param>
public void Read(SRBinaryReader binaryReader, int index)
{
try
{
m_pos_x = binaryReader.ReadInt16();
m_pos_y = binaryReader.ReadInt16();
m_pos_z = binaryReader.ReadInt16();
pitch = binaryReader.ReadInt16();
bank = binaryReader.ReadInt16();
heading = binaryReader.ReadInt16();
int m_str_offset = binaryReader.ReadInt16();
SRTrace.WriteLine(" REFERENCE #{0}: {1},{2},{3},{4},{5},{6},{7}", index + 1, m_pos_x, m_pos_y, m_pos_z, pitch, bank, heading, m_str_offset);
name = vFileHeader.GetReferenceNameByReadOffset(m_str_offset);
}
catch (Exception e)
{
// Add context information for the error message
if (index >= 0)
e.Data[BlockName] = index + 1;
throw;
}
}
// READERS / WRITERS
/// <summary>
/// Reads a data block from a file binary stream.
/// </summary>
/// <param name="binaryReader">Binary reader to read the block from. Must point to the beginning of the block.</param>
/// <param name="size">Maximum number of bytes to read.</param>
public void Read(SRBinaryReader binaryReader)
{
binaryReader.Align(Alignment);
SRTrace.WriteLine("");
SRTrace.WriteLine("WORLD ZONE HEADER: [file offset 0x{0:X8}]", binaryReader.BaseStream.Position);
signature = new string(binaryReader.ReadChars(4));
SRTrace.WriteLine(" World Zone Signature: " + signature);
if (signature != "SR3Z")
throw new SRZoneFileException("Incorrect world zone signature.", binaryReader.BaseStream.Position - 4);
version = binaryReader.ReadUInt32();
SRTrace.WriteLine(" World Zone Version: {0}", version);
if (version != 29 && version != 32) // version 29 = SR3, 32 = SR4
throw new SRZoneFileException("Incorrect world zone version.");
int v_file_header_ptr = binaryReader.ReadInt32();
SRTrace.WriteLine(" V-File Header Pointer: 0x{0:X8}", v_file_header_ptr);
fileReferenceOffset = new SRPosition(binaryReader);
SRTrace.WriteLine(" File Reference Offset: {0}", fileReferenceOffset.ToString());
fileReferencesPtr = binaryReader.ReadUInt32();
SRTrace.WriteLine(" WZ File Reference Ptr: 0x{0:X8}", fileReferencesPtr);
int num_file_references = binaryReader.ReadInt16();
SRTrace.WriteLine(" Number of File Refs: {0}", num_file_references);
zoneType = binaryReader.ReadByte();
string typeName = (zoneType < WorldZoneTypeNames.Length) ? WorldZoneTypeNames[zoneType] : "unknown";
SRTrace.WriteLine(" Zone Type: {0} ({1})", zoneType, typeName);
int unused = binaryReader.ReadByte();
SRTrace.WriteLine(" Unused: {0}", unused);
if (unused != 0)
throw new SRZoneFileException("Expected unused field to be zero.");
int interiorTriggerPtr = binaryReader.ReadInt32();
SRTrace.WriteLine(" Interior Trigger Ptr: 0x{0:X8} (run-time)", interiorTriggerPtr);
if (interiorTriggerPtr != 0)
throw new SRZoneFileException("Expected interior trigger pointer to be zero.");
int numberOfTriggers = binaryReader.ReadInt16();
SRTrace.WriteLine(" Number of Triggers: {0,-10} (run-time)", numberOfTriggers);
if (numberOfTriggers != 0)
throw new SRZoneFileException("Expected number of triggers to be zero.");
int extraObjects = binaryReader.ReadInt16();
SRTrace.WriteLine(" Extra Objects: {0}", extraObjects);
if (extraObjects != 0)
throw new SRZoneFileException("Expected extra objects to be zero.");
binaryReader.BaseStream.Seek(24, SeekOrigin.Current);
SRTrace.WriteLine("");
SRTrace.WriteLine(" MESH FILE REFERENCES: [file offset 0x{0:X8}]", binaryReader.BaseStream.Position);
references = new List<SRZoneMeshFileReference>(num_file_references);
for (int i = 0; i < num_file_references; i++)
references.Add(new SRZoneMeshFileReference(binaryReader, i, vFileHeader));
}