Open source SFmpqapi And grpapi

07-17-2008, 01:35 AM

As mentioned in another topic, I decided to release the source code of my MPQ library. Probably not of interest here, I've also released the source of my GRP library. More info from my site:

Quote:

I have decided to release the source code to my SFmpq and Grp libraries licensed under the Simplified BSD License. The source code is contained in repositories created by a tool called Git, available at http://git-scm.com/ ( Windows version at http://code.google.com/p/msysgit/ ). Documentation is available on the Git web site if you would like know how to work with the repositories.

If you have Git installed, you may download the repositories for SFmpq with these commands:

Code:

git clone http://sfsrealm.hopto.org/projects/SFmpqapi.git
git clone http://sfsrealm.hopto.org/projects/SComp.git

And download the repository for grpapi with this:

Code:

git clone http://sfsrealm.hopto.org/projects/grpapi.git

To update an existing copy with the latest version of the source, from the directory of the source tree the command is as simple as:

Code:

git pull

If you just want to quickly get a copy of the latest source code, it may be available in zip file form from the directory at the link below. The repository directories are also at that location.

http://sfsrealm.hopto.org/projects/

The repositories can also be browsed with gitweb here: http://sfsrealm.hopto.org/projects/gitweb.cgi

SFmpqapi should still be able to compile on Linux with the proper configuration; maybe Mac OS X as well (likely needs some work for the latter of those, as I've never had access to such a system to try it). With a few modifications, grpapi should work as well. Of course, I don't have any sort of makefile or similar system set up for either, so there would be some extra work to compile those on a non-Windows system.

If anyone is going to try modifying the source code on their own and possibly contributing changes back, I would highly recommend learning to use Git to download the repositories and to track your own modifications to the code, which would make it easier to get them included in my own source tree. It is pretty much only useful for command-line only at the moment (except for some graphical viewers for some things), but there aren't really many commands that need to be known for basic usage.

There is one little issue currently with the Windows client that I know of, as far as using it to get the code for my projects. When using the git clone command, it may not always get the line endings type that you want, which may require deleting all but the .git folder in the source tree and then using the git reset --hard command. I'll probably later put this info up somewhere on my site as well.

There will likely be more source code that I make available in this manner at some point in the future.