//! \file CommonStreams.cs //! \date Sun Mar 13 00:01:47 2016 //! \brief Commonly used stream implementations. // // Copyright (C) 2016 by morkt // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to // deal in the Software without restriction, including without limitation the // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or // sell copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS // IN THE SOFTWARE. // using System; using System.IO; namespace GameRes.Formats { /// /// Base class for various filter streams. /// public class ProxyStream : Stream { Stream m_stream; bool m_should_dispose; public ProxyStream (Stream input, bool leave_open = false) { m_stream = input; m_should_dispose = !leave_open; } public Stream BaseStream { get { return m_stream; } } public override bool CanRead { get { return m_stream.CanRead; } } public override bool CanSeek { get { return m_stream.CanSeek; } } public override bool CanWrite { get { return m_stream.CanWrite; } } public override long Length { get { return m_stream.Length; } } public override long Position { get { return m_stream.Position; } set { m_stream.Position = value; } } public override int Read (byte[] buffer, int offset, int count) { return m_stream.Read (buffer, offset, count); } public override void Flush() { m_stream.Flush(); } public override long Seek (long offset, SeekOrigin origin) { return m_stream.Seek (offset, origin); } public override void SetLength (long length) { m_stream.SetLength (length); } public override void Write (byte[] buffer, int offset, int count) { m_stream.Write (buffer, offset, count); } bool _proxy_disposed = false; protected override void Dispose (bool disposing) { if (!_proxy_disposed) { if (m_should_dispose && disposing) m_stream.Dispose(); _proxy_disposed = true; base.Dispose (disposing); } } } public class InputProxyStream : ProxyStream { public InputProxyStream (Stream input, bool leave_open = false) : base (input, leave_open) { } public override bool CanWrite { get { return false; } } public override void Write (byte[] buffer, int offset, int count) { throw new NotSupportedException ("Stream.Write method is not supported"); } public override void SetLength (long length) { throw new NotSupportedException ("Stream.SetLength method is not supported"); } } public class PrefixStream : InputProxyStream { byte[] m_header; long m_position = 0; public PrefixStream (byte[] header, Stream main, bool leave_open = false) : base (main, leave_open) { m_header = header; } public override long Length { get { return BaseStream.Length + m_header.Length; } } public override long Position { get { return m_position; } set { if (!BaseStream.CanSeek) throw new NotSupportedException ("Underlying stream does not support Stream.Position property"); m_position = Math.Max (value, 0); if (m_position > m_header.Length) { long stream_pos = BaseStream.Seek (m_position - m_header.Length, SeekOrigin.Begin); m_position = m_header.Length + stream_pos; } } } public override long Seek (long offset, SeekOrigin origin) { if (SeekOrigin.Begin == origin) Position = offset; else if (SeekOrigin.Current == origin) Position = m_position + offset; else Position = Length + offset; return m_position; } public override int Read (byte[] buffer, int offset, int count) { int read = 0; if (m_position < m_header.Length) { int header_count = Math.Min (count, m_header.Length - (int)m_position); Buffer.BlockCopy (m_header, (int)m_position, buffer, offset, header_count); m_position += header_count; read += header_count; offset += header_count; count -= header_count; } if (count > 0) { if (m_header.Length == m_position && BaseStream.CanSeek) BaseStream.Position = 0; int stream_read = BaseStream.Read (buffer, offset, count); m_position += stream_read; read += stream_read; } return read; } public override int ReadByte () { if (m_position < m_header.Length) return m_header[m_position++]; if (m_position == m_header.Length && BaseStream.CanSeek) BaseStream.Position = 0; int b = BaseStream.ReadByte(); if (-1 != b) m_position++; return b; } } /// /// Represents a region within existing stream. /// Underlying stream should allow seeking (CanSeek == true). /// public class StreamRegion : InputProxyStream { private long m_begin; private long m_end; public StreamRegion (Stream main, long offset, long length, bool leave_open = false) : base (main, leave_open) { m_begin = offset; m_end = Math.Min (offset + length, BaseStream.Length); BaseStream.Position = m_begin; } public StreamRegion (Stream main, long offset, bool leave_open = false) : this (main, offset, main.Length-offset, leave_open) { } public override bool CanSeek { get { return true; } } public override long Length { get { return m_end - m_begin; } } public override long Position { get { return BaseStream.Position - m_begin; } set { BaseStream.Position = Math.Max (m_begin + value, m_begin); } } public override long Seek (long offset, SeekOrigin origin) { if (SeekOrigin.Begin == origin) offset += m_begin; else if (SeekOrigin.Current == origin) offset += BaseStream.Position; else offset += m_end; offset = Math.Max (offset, m_begin); BaseStream.Position = offset; return offset - m_begin; } public override int Read (byte[] buffer, int offset, int count) { int read = 0; long available = m_end - BaseStream.Position; if (available > 0) { read = BaseStream.Read (buffer, offset, (int)Math.Min (count, available)); } return read; } public override int ReadByte () { if (BaseStream.Position < m_end) return BaseStream.ReadByte(); else return -1; } } public enum StreamOption { None, Fill, } /// /// Limits underlying stream to the first N bytes. /// public class LimitStream : InputProxyStream { bool m_can_seek; long m_position; long m_last; bool m_fill; public LimitStream (Stream input, long last, bool leave_open = false) : base (input, leave_open) { m_can_seek = input.CanSeek; m_position = 0; m_last = last; } public LimitStream (Stream input, long last, StreamOption option, bool leave_open = false) : this (input, last, leave_open) { if (StreamOption.Fill == option) { if (m_can_seek && input.Length < m_last) { input.Position = m_position; m_can_seek = false; } m_fill = true; } } public override bool CanSeek { get { return m_can_seek; } } public override long Length { get { return m_last; } } public override int Read (byte[] buffer, int offset, int count) { if (m_can_seek) m_position = Position; if (m_position >= m_last) return 0; count = (int)Math.Min (count, m_last - m_position); int read = BaseStream.Read (buffer, offset, count); if (m_fill) { while (read < count) { buffer[read++] = 0; } } m_position += read; return read; } public override int ReadByte () { if (m_can_seek) m_position = Position; if (m_position >= m_last) return -1; int b = BaseStream.ReadByte(); if (-1 != b) ++m_position; return b; } } /// /// Lazily evaluated wrapper around non-seekable stream. /// public class SeekableStream : Stream { Stream m_source; Stream m_buffer; bool m_should_dispose; bool m_source_depleted; long m_read_pos; public SeekableStream (Stream input, bool leave_open = false) { m_source = input; m_should_dispose = !leave_open; m_read_pos = 0; if (m_source.CanSeek) { m_buffer = m_source; m_source_depleted = true; } else { m_buffer = new MemoryStream(); m_source_depleted = false; } } #region IO.Stream Members public override bool CanRead { get { return m_buffer.CanRead; } } public override bool CanSeek { get { return true; } } public override bool CanWrite { get { return false; } } public override long Length { get { if (!m_source_depleted) { m_buffer.Seek (0, SeekOrigin.End); m_source.CopyTo (m_buffer); m_source_depleted = true; } return m_buffer.Length; } } public override long Position { get { return m_read_pos; } set { m_read_pos = value; } } public override int Read (byte[] buffer, int offset, int count) { int read, total_read = 0; if (m_source_depleted) { m_buffer.Position = m_read_pos; total_read = m_buffer.Read (buffer, offset, count); m_read_pos += total_read; return total_read; } if (m_read_pos < m_buffer.Length) { int available = (int)Math.Min (m_buffer.Length-m_read_pos, count); m_buffer.Position = m_read_pos; total_read = m_buffer.Read (buffer, offset, available); m_read_pos += total_read; count -= total_read; if (0 == count) return total_read; offset += total_read; } else if (count > 0) { m_buffer.Seek (0, SeekOrigin.End); while (m_read_pos > m_buffer.Length) { int available = (int)Math.Min (m_read_pos - m_buffer.Length, count); read = m_source.Read (buffer, offset, available); if (0 == read) { m_source_depleted = true; return 0; } m_buffer.Write (buffer, offset, read); } } read = m_source.Read (buffer, offset, count); m_read_pos += read; m_buffer.Write (buffer, offset, read); return total_read + read; } public override void Flush() { } public override long Seek (long offset, SeekOrigin origin) { if (SeekOrigin.Begin == origin) m_read_pos = offset; else if (SeekOrigin.Current == origin) m_read_pos += offset; else m_read_pos = Length + offset; return m_read_pos; } public override void SetLength (long length) { throw new NotSupportedException ("SeekableStream.SetLength method is not supported"); } public override void Write (byte[] buffer, int offset, int count) { throw new NotSupportedException ("SeekableStream.Write method is not supported"); } public override void WriteByte (byte value) { throw new NotSupportedException ("SeekableStream.WriteByte method is not supported"); } #endregion #region IDisposable Members bool _disposed = false; protected override void Dispose (bool disposing) { if (_disposed) return; if (disposing) { if (m_should_dispose) m_source.Dispose(); if (m_buffer != m_source) m_buffer.Dispose(); } _disposed = true; base.Dispose (disposing); } #endregion } /// /// Concatenation of the two input Streams. /// public class ConcatStream : InputProxyStream { Stream m_second; long m_position; Stream m_active; public ConcatStream (Stream first, Stream second) : base (first) { m_second = second; m_position = 0; m_active = first; } internal Stream First { get { return BaseStream; } } internal Stream Second { get { return m_second; } } public override bool CanSeek { get { return First.CanSeek && Second.CanSeek; } } public override long Length { get { return First.Length + Second.Length; } } public override long Position { get { return m_position; } set { m_position = value; } } public override int Read (byte[] buffer, int offset, int count) { if (First.CanSeek) { if (m_position >= First.Length) { m_active = Second; m_active.Position = m_position - First.Length; } else { m_active = First; m_active.Position = m_position; } } int total_read = 0; while (count > 0) { int read = m_active.Read (buffer, offset, count); if (0 == read) break; total_read += read; m_position += read; offset += read; count -= read; } if (count > 0 && m_active != Second) { m_active = Second; if (m_active.CanSeek) m_active.Position = 0; int read = m_active.Read (buffer, offset, count); m_position += read; total_read += read; } return total_read; } public override long Seek (long offset, SeekOrigin origin) { if (SeekOrigin.Begin == origin) Position = offset; else if (SeekOrigin.Current == origin) Position = m_position + offset; else Position = Length + offset; return m_position; } bool _disposed = false; protected override void Dispose (bool disposing) { if (!_disposed) { if (disposing) m_second.Dispose(); _disposed = true; base.Dispose (disposing); } } } public class XoredStream : ProxyStream { private byte m_key; public XoredStream (Stream stream, byte key, bool leave_open = false) : base (stream, leave_open) { m_key = key; } #region System.IO.Stream methods public override int Read (byte[] buffer, int offset, int count) { int read = BaseStream.Read (buffer, offset, count); for (int i = 0; i < read; ++i) { buffer[offset+i] ^= m_key; } return read; } public override int ReadByte () { int b = BaseStream.ReadByte(); if (-1 != b) { b ^= m_key; } return b; } byte[] write_buf; public override void Write (byte[] buffer, int offset, int count) { if (null == write_buf) write_buf = new byte[81920]; while (count > 0) { int chunk = Math.Min (write_buf.Length, count); for (int i = 0; i < chunk; ++i) { write_buf[i] = (byte)(buffer[offset+i] ^ m_key); } BaseStream.Write (write_buf, 0, chunk); offset += chunk; count -= chunk; } } public override void WriteByte (byte value) { BaseStream.WriteByte ((byte)(value ^ m_key)); } #endregion } }