loadjp2k is a bit of glue to let you load JPEG-2000 images, using the
JasPer library, into Allegro BITMAPs.  It is placed in the public domain.


Compiling
---------

You will need to download and install JasPer.  The homepage is at:

   http://www.ece.uvic.ca/~mdadams/jasper/

Once you have done that, if you are using mingw or some form of Unix
you can run `make' to build the test program.  You may have to
adjust the makefile a bit.

The test program has the following command line syntax:

   ./loadjp2k [-BPP] file1.jp2 file2.jp2 ...

where BPP is one of 8, 15, 16, 24 or 32.  32 is the default.

If you want to use loadjp2k in a project, just copy the files into
the project directory and integrate it into the build system.


Interface
---------

/* loadjp2k_init:
 *  Initialise the library.
 */
void loadjp2k_init(void)

/* loadjp2k_shutdown:
 *  Free resources associated with the library.
 */
void loadjp2k_shutdown(void)

/* load_jp2:
 *  Load a JPEG-2000 image file, following load_bitmap() semantics.
 *
 *  Actually, the underlying JasPer library understands a few other
 *  formats so this can actually succeed on other file formats.
 */
BITMAP *load_jp2(AL_CONST char *filename, PALETTE pal)


Contact
-------

tjaden@users.sourceforge.net
http://tjaden.strangesoft.net/