***************************************************

     Simple Plugin-based Graphic Loader Enfle

    (C)Copyright 1998, 99 by Hiroshi Takekawa.

     Last Modified: Wed Oct  6 03:43:31 1999.

***************************************************

This software is based in part on the work of the Independent JPEG Group

The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated.
GIF(sm) is a Service Mark property of CompuServe Incorporated.


I'm not good at English. Please tell me if you don't understand, or
give me a fixed text...

1. Outline

Enfle aims to view many variously formated pictures easily. So far, it
can treat GIF, JPEG, PNG, MAG, BMP(partial), XPM(partial), PNM, DjVu,
and several special (minor) formats. It has been implemented plugin
mechanism so that each user can choose each format support linked in
main program or separated as plugin. Moreover, you can make you own
plugins to extend supported formats.

However, GIF plugin is not included by default because of patent
problem. DjVu plugin is not included by default because standard
libdjvu++ distribution doesn't create shared library (I've patched for
myself) and I don't understand its license enough.

 JPEG support requires IJG's libjpeg library. Checked with jpegsrc-6b.
 PNG support uses libpng library. Checked with libpng-1.0.3.
 XPM support requires libXpm, DjVu support requires libdjvu++.


2. Compilation

Just try:

% ./configure --enable-all-plugins && make

If you use Linux, perhaps it will be compiled easily.
Other plathome I didn't check.. please notice me if you success or not.

configure has some options. Try:

% ./configure --help

to show explanation.

Example:

% ./configure --enable-loader="png bmp xbm" --enable-loader-static="jpeg xpm pnm"

This configures to support:

JPEG, XPM, PNM (static linked)
PNG, BMP, XBM (compiled as plugin)

Plugin is compiled as shared object.  Plugins' filenames must be ended
with '.so', or '.so.?.?.?' (? is number). You can specify the
directory where plugins are, with -p option or ENFLE_PLUGIN_DIR
environment variable. With environment variable, you can specify
multiple directories split by ':'.


3. Usage

Enfle is very simple software. Specify all picture files, that's all.
If you specify directory, Enfle will append recursively.
Try -h option to show explanation of options.

-q: force to quantize
-m: specify magnify method at startup. 1(doubled) or 2(fit).
-c: show comment if any
-C: auto conversion, you can specify destination format, 'PNG' or 'JPEG'.
-i: specify start index of archive
-x: X threshold, if width is less than, that picture will not be shown
-y: Y threshold
-s: clear threshold (show all pictures)
-t: enable transparent. If you have enabled shape extension, enable it too.
    specify -t twice, enable transparent but disable shape extension.
-p: specify plugin scanning directory
-P: show long format plugin information
-PP: show longer format plugin information
-v: show version
-h: show help message


4. Key action

left click,n,space	next
N,Shift+space		next directory
right click,b		previous
<			top
middle click,q		quit
drag			scroll
window resize		magnify(fit to window)
f			fullscreen mode
d			delete actual file
w			wall paper
s			save as png
v			flip vertical
h			flip horizontal
m			x2 magnify toggle
M			fit magnify toggle
r			restore image
t(experimental)		create thumbnail like image

And Enfle will quit after all pictures shown.

If you have GIF support, you can:

[			animation speed down
]			animation speed up
\			restore animation speed


5. Contact

ˇˇPlease send comments, patches, to:

	Hiroshi Takekawa <takekawa@sr3.t.u-tokyo.ac.jp>
                         <sian@big.or.jp>
                         <sian@fennel.org>


6. Distribution

Enfle is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.