MoonTools.NETPhysFS/README.md

1.3 KiB

SharpPhysFS

PhysicsFS wrapper for .NET

This library is a wrapper around the PhysFS library designed to work with .NET languages. As such, it employs standard .NET behaviors such as Exceptions and IEnumerables to represent native objects. It also provides access to the underlying low-level methods and a Stream subclass for easy use of the APIs.

The documentation for the methods is copied from the original doxygen and only slightly adapted.

Platform support

The library is designed to work regardless of the underlying OS, so it should run on Windows, Linux and OSX equally well. I haven't tested the OSX port though, and I only superficially tried it on Linux.

If anyone feels so inclined, he/she could contribute by testing it and reporting the results. This would be greatly appreciated.

Installation

You can use this library by compiling it as described in the wiki or by adding it as a reference using NuGet:

Install-Package SharpPhysFS

You should also include compiled shared library of physfs alongside your binary files to be loaded.

Usage

using(var pfs = new PhysFS("")) // This ensures correct initialization and deinitialization
using(var reader = new StreamReader(pfs.OpenRead("/helloworld.txt")))
{
  var contents = reader.ReadToEnd();
}