mirror of
https://github.com/crskycode/GARbro.git
synced 2024-11-30 17:05:37 +08:00
318 lines
11 KiB
C#
318 lines
11 KiB
C#
//! \file GameRes.cs
|
||
//! \date Mon Jun 30 20:12:13 2014
|
||
//! \brief game resources browser.
|
||
//
|
||
// Copyright (C) 2014-2015 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;
|
||
using System.Collections.Generic;
|
||
using GameRes.Strings;
|
||
|
||
namespace GameRes
|
||
{
|
||
/// <summary>
|
||
/// Basic filesystem entry.
|
||
/// </summary>
|
||
public class Entry
|
||
{
|
||
public virtual string Name { get; set; }
|
||
public virtual string Type { get; set; }
|
||
public long Offset { get; set; }
|
||
public uint Size { get; set; }
|
||
|
||
public Entry ()
|
||
{
|
||
Type = "";
|
||
Offset = -1;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Check whether entry lies within specified file bound.
|
||
/// </summary>
|
||
public bool CheckPlacement (long max_offset)
|
||
{
|
||
return Offset < max_offset && Size <= max_offset && Offset <= max_offset - Size;
|
||
}
|
||
}
|
||
|
||
public class PackedEntry : Entry
|
||
{
|
||
public uint UnpackedSize { get; set; }
|
||
public bool IsPacked { get; set; }
|
||
}
|
||
|
||
public abstract class IResource
|
||
{
|
||
/// <summary>Short tag sticked to resource (usually filename extension)</summary>
|
||
public abstract string Tag { get; }
|
||
|
||
/// <summary>Resource description (its source/inventor)</summary>
|
||
public abstract string Description { get; }
|
||
|
||
/// <summary>Resource type (image/archive/script)</summary>
|
||
public abstract string Type { get; }
|
||
|
||
/// <summary>First 4 bytes of the resource file as little-endian 32-bit integer,
|
||
/// or zero if it could vary.</summary>
|
||
public abstract uint Signature { get; }
|
||
|
||
/// <summary>Signatures peculiar to the resource (the one above is also included here).</summary>
|
||
public IEnumerable<uint> Signatures { get; protected set; }
|
||
|
||
/// <summary>Filename extensions peculiar to the resource.</summary>
|
||
public IEnumerable<string> Extensions { get; protected set; }
|
||
|
||
/// <summary>Resource settings suitable for serialization.</summary>
|
||
public virtual ResourceScheme Scheme { get; set; }
|
||
|
||
/// <summary>
|
||
/// Create empty Entry that corresponds to implemented resource.
|
||
/// </summary>
|
||
public EntryType Create<EntryType> () where EntryType : Entry, new()
|
||
{
|
||
return new EntryType { Type = this.Type };
|
||
}
|
||
|
||
protected IResource ()
|
||
{
|
||
Extensions = new string[] { Tag.ToLowerInvariant() };
|
||
Signatures = new uint[] { this.Signature };
|
||
}
|
||
|
||
public virtual ResourceOptions GetDefaultOptions ()
|
||
{
|
||
return null;
|
||
}
|
||
|
||
public virtual ResourceOptions GetOptions (object widget)
|
||
{
|
||
return GetDefaultOptions();
|
||
}
|
||
|
||
public virtual object GetCreationWidget ()
|
||
{
|
||
return null;
|
||
}
|
||
|
||
public virtual object GetAccessWidget ()
|
||
{
|
||
return null;
|
||
}
|
||
|
||
protected OptType GetOptions<OptType> (ResourceOptions res_options) where OptType : ResourceOptions
|
||
{
|
||
var options = res_options as OptType;
|
||
if (null == options)
|
||
options = this.GetDefaultOptions() as OptType;
|
||
return options;
|
||
}
|
||
|
||
protected OptType Query<OptType> (string notice) where OptType : ResourceOptions
|
||
{
|
||
var args = new ParametersRequestEventArgs { Notice = notice };
|
||
FormatCatalog.Instance.InvokeParametersRequest (this, args);
|
||
if (!args.InputResult)
|
||
throw new OperationCanceledException();
|
||
|
||
return GetOptions<OptType> (args.Options);
|
||
}
|
||
}
|
||
|
||
public class ResourceOptions
|
||
{
|
||
}
|
||
|
||
[Serializable]
|
||
public class ResourceScheme
|
||
{
|
||
}
|
||
|
||
public enum ArchiveOperation
|
||
{
|
||
Abort,
|
||
Skip,
|
||
Continue,
|
||
}
|
||
|
||
public delegate ArchiveOperation EntryCallback (int num, Entry entry, string description);
|
||
|
||
public abstract class ArchiveFormat : IResource
|
||
{
|
||
public override string Type { get { return "archive"; } }
|
||
|
||
public virtual bool CanCreate { get { return false; } }
|
||
|
||
public abstract bool IsHierarchic { get; }
|
||
|
||
public abstract ArcFile TryOpen (ArcView view);
|
||
|
||
/// <summary>
|
||
/// Extract file referenced by <paramref name="entry"/> into current directory.
|
||
/// </summary>
|
||
public void Extract (ArcFile file, Entry entry)
|
||
{
|
||
using (var input = OpenEntry (file, entry))
|
||
using (var output = CreateFile (entry.Name))
|
||
input.CopyTo (output);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Open file referenced by <paramref name="entry"/> as Stream.
|
||
/// </summary>
|
||
public virtual Stream OpenEntry (ArcFile arc, Entry entry)
|
||
{
|
||
return arc.File.CreateStream (entry.Offset, entry.Size);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Create file corresponding to <paramref name="entry"/> in current directory and open it
|
||
/// for writing. Overwrites existing file, if any.
|
||
/// </summary>
|
||
static public Stream CreateFile (string filename)
|
||
{
|
||
filename = CreatePath (filename);
|
||
if (File.Exists (filename))
|
||
{
|
||
// query somehow whether to overwrite existing file or not.
|
||
}
|
||
return File.Create (filename);
|
||
}
|
||
|
||
static public string CreatePath (string filename)
|
||
{
|
||
string dir = Path.GetDirectoryName (filename);
|
||
if (!string.IsNullOrEmpty (dir)) // check for malformed filenames
|
||
{
|
||
string root = Path.GetPathRoot (dir);
|
||
if (!string.IsNullOrEmpty (root))
|
||
{
|
||
dir = dir.Substring (root.Length); // strip root
|
||
}
|
||
string cwd = Directory.GetCurrentDirectory() + Path.DirectorySeparatorChar;
|
||
dir = Path.GetFullPath (dir);
|
||
filename = Path.GetFileName (filename);
|
||
// check whether filename would reside within current directory
|
||
if (dir.StartsWith (cwd, StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
// path looks legit, create it
|
||
Directory.CreateDirectory (dir);
|
||
filename = Path.Combine (dir, filename);
|
||
}
|
||
}
|
||
return filename;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Create resource within stream <paramref name="file"/> containing entries from the
|
||
/// supplied <paramref name="list"/> and applying necessary <paramref name="options"/>.
|
||
/// </summary>
|
||
public virtual void Create (Stream file, IEnumerable<Entry> list, ResourceOptions options = null,
|
||
EntryCallback callback = null)
|
||
{
|
||
throw new NotImplementedException ("ArchiveFormat.Create is not implemented");
|
||
}
|
||
|
||
public static bool IsSaneCount (int count)
|
||
{
|
||
return count > 0 && count < 0x20000;
|
||
}
|
||
}
|
||
|
||
public delegate void ParametersRequestEventHandler (object sender, ParametersRequestEventArgs e);
|
||
|
||
public class ParametersRequestEventArgs : EventArgs
|
||
{
|
||
/// <summary>
|
||
/// String describing request nature (encryption key etc).
|
||
/// </summary>
|
||
public string Notice { get; set; }
|
||
|
||
/// <summary>
|
||
/// Return value from ShowDialog()
|
||
/// </summary>
|
||
public bool InputResult { get; set; }
|
||
|
||
/// <summary>
|
||
/// Archive-specific options set by InputWidget.
|
||
/// </summary>
|
||
public ResourceOptions Options { get; set; }
|
||
}
|
||
|
||
public class OverwriteEventArgs : EventArgs
|
||
{
|
||
public string Filename { get; set; }
|
||
public bool Overwrite { get; set; }
|
||
}
|
||
|
||
public class InvalidFormatException : FileFormatException
|
||
{
|
||
public InvalidFormatException() : base(garStrings.MsgInvalidFormat) { }
|
||
public InvalidFormatException (string msg) : base (msg) { }
|
||
}
|
||
|
||
public class UnknownEncryptionScheme : Exception
|
||
{
|
||
public UnknownEncryptionScheme() : base(garStrings.MsgUnknownEncryption) { }
|
||
public UnknownEncryptionScheme (string msg) : base (msg) { }
|
||
}
|
||
|
||
public class InvalidEncryptionScheme : Exception
|
||
{
|
||
public InvalidEncryptionScheme() : base(garStrings.MsgInvalidEncryption) { }
|
||
public InvalidEncryptionScheme (string msg) : base (msg) { }
|
||
}
|
||
|
||
public class FileSizeException : Exception
|
||
{
|
||
public FileSizeException () : base (garStrings.MsgFileTooLarge) { }
|
||
public FileSizeException (string msg) : base (msg) { }
|
||
}
|
||
|
||
public class InvalidFileName : Exception
|
||
{
|
||
public string FileName { get; set; }
|
||
|
||
public InvalidFileName (string filename)
|
||
: this (filename, garStrings.MsgInvalidFileName)
|
||
{
|
||
}
|
||
|
||
public InvalidFileName (string filename, string message)
|
||
: base (message)
|
||
{
|
||
FileName = filename;
|
||
}
|
||
|
||
public InvalidFileName (string filename, Exception X)
|
||
: this (filename, garStrings.MsgInvalidFileName, X)
|
||
{
|
||
}
|
||
|
||
public InvalidFileName (string filename, string message, Exception X)
|
||
: base (message, X)
|
||
{
|
||
FileName = filename;
|
||
}
|
||
}
|
||
}
|