An open API service indexing awesome lists of open source software.

https://github.com/zfogg/jp2a

Customizations to jp2a for @HackDuke.
https://github.com/zfogg/jp2a

Last synced: 2 months ago
JSON representation

Customizations to jp2a for @HackDuke.

Awesome Lists containing this project

README

          

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 check # 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 check

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

$Id: README 469 2006-10-10 09:30:21Z cslsublevel3org $