ppsspp/README.md

native
======

This is my library of stuff that I use when writing C++ programs, mostly for Android but it's all written to enable easy portability between Android, Linux, Windows and MacOSX.

It contains:
* JSON read/write (two libraries that should be made more similar)
* basic OpenGL utility code, like compressed texture loading
* 2D texture atlases and drawing code
* ETC1 texture loading support
* basic logging
* Really simple audio mixer with OGG sample support
* RIFF file read/write

The associated tools to create ZIM texture files and atlases do not yet live here but I might move them here eventually.

This library is not really meant to be a public library but I see no reason not to set it free.

Note that the included VS project is probably not very useful for you and you're likely better off making your own.

Don't complain about inconsistent naming etc - this consists of code that has been cobbled together from a variety of my projects through the years. Fashions come and go.


This library, for my convenience, incorporates code from a variety of public domain or similarly-licensed code. This is the list:

* glew (GL extension wrangler), MIT license. TODO: should just use a submodule.
* etcpack by Ericsson, in a cleaned up form. Has strange license but not very limiting - you can only use the code for making textures for hardware supporting ETC1, or something like that. Don't think it affects the rest of the code in any way.
* sha1, public domain implementation by Dominik Reichl
* vjson in a heavily modified form, originally by Ivan Vashchaev (TODO: break out into its own repo?)
* libzip with attribution "Copyright (C) 1999-2007 Dieter Baron and Thomas Klausner"
* stb_vorbis, public domain by Sean Barrett of RAD Tools

If you're not okay with the licenses above, don't use this code.

If you find this useful for your own projects, drop me a line at hrydgard@gmail.com . 

I hereby release all code here not under the licenses above under the MIT license.

Henrik Rydg<64>rd