ABOUT JP2A

    jp2a is a simple JPEG to ASCII viewer.


    COPYRIGHT

    jp2a is Copyright (c) 2006 Christian Stigen Larsen
    Distributed under the GNU General Public License v2.

    You can read the full license in the file COPYING.  jp2a also
    uses other libraries.  These licenses can be found in the file
    LICENSES.

    The latest version is available from http://jp2a.sf.net


    QUICK INSTALL

    ./configure
    make
    make test     # optional
    make install

    If configure doesn't find jpeglib.h and you know where
    it is, you specify with

    ./configure --with-jpeg-include=PATH --with-jpeg-lib=PATH

    If you want to be able to download images from the net, you
    must have libcurl installed (http://curl.haxx.se) and configure
    for example like this:

    ./configure --enable-curl

    This will look for `curl-config' in $PATH, but you can specify
    it directly with --with-curl-config=PATH if you need to.


    PRE-REQUISITES

    jp2a requires jpeglib.  If you don't have it, the source is
    available from http://www.ijg.org/

    If you want to be able to download images from the net, you
    also need libcurl, from http://curl.haxx.se


    BUILDING ON MAC OS X

    jp2a is now part of darwin ports, so the easiest installation is:

    sudo port install jp2a

    If you do not have darwinports installed, go to http://www.opendarwin.org
    and install it from there.

    To build yourself, do this:

    # USING FINK
    fink install libjpeg curl
    ./configure --with-jpeg-prefix=/sw --with-curl-config=/sw/bin

    # USING DARWIN PORTS
    sudo port install jpeg curl
    ./configure --with-jpeg-prefix=/opt/local --with-curl-config=/opt/local/bin


    BUILDING WITHOUT USING CONFIGURE

    You need (at least) jpeglib.h and libjpeg, then you do this:

    gcc -g -O2 \
	-DPACKAGE_BUGREPORT='"csl@sublevel3.org"' \
	-DPACKAGE_STRING='"jp2a 0.9.xx"' \
	-I/opt/local/include/ -L/opt/local/lib -l jpeg jp2a.c -o jp2a


    BUILDING ON WINDOWS (MS VISUAL STUDIO)
    
    Download a reasonable jpeglib version for Windows, e.g. from
    
    http://www.ece.sunysb.edu/~cvl/e358/f2001/jpeg-windows.html

    (Don't use Gnuwin32's version, it completely broke on my system).
    
    Fire up MS Visual Studio, you should select C++ compilation, because
    (at least with my MSVC version) the C compiler gave some strange
    warnings and errors, probably due to the fact that i use some C99
    code.
    
    Since config.h is not generated for MSVC, you need to add some
    preprocessor definitions:
   
    WIN32
    NDEBUG
    _CONSOLE
    PACKAGE_STRING=\"jp2a x.x.x-win32\"
    PACKAGE_BUGREPORT=\"csl@sublevel3.org\"
    HAVE_STRING_H
    HAVE_STDLIB_H
    FEAT_CURL
    HAVE_CURL_CURL_H
    CURL_STATICLIB
    FEAT_TERMLIB
    
    Add the jpeg.lib file provided by above URL in the search directory
    and in the linker input, and then everything should compile without
    any errors.  If you want CURL support, you can find a good win32
    version for development from

    http://my.guardpuppy.com/libcurl-7.15.1-msvc-win32-ssl-0.9.8a-zlib-1.2.3.zip

    (that is, go to http://curl.haxx.se, select DOWNLOAD and look for the
    MSVC SSL libcurl versions.)


    BUILDING ON WINDOWS (MINGW32)

    Using mingw32 is straight-forward if you have a working (non-MSVC)
    jpeglib.  On Mac OS X, you do something along these lines to
    cross-compile:

    ./configure --host=i386-mingw32
    make test

    I currently use MS Visual C++ to compile the Win32 binaries for jp2a,
    but I am going to swith to using mingw32.
    

$Id: README 415 2006-07-31 09:34:41Z csl $