SourceFiles.org - Use the Source, Luke

Back to files

                            GImage View README
                                                                 for ver 0.2.21
                                                Last Modified : 2003/05/22(Thu)
                                                      Created : 2001/09/08(Sat)

** Contents **
0. What's this?

Introduction
Requirement
Download
Install
Usage
ChangeLog of README
License
Remarks

0. What's this?

GImageView is an image viewer which solves a hopless situation under displaying a lot of images.
It works on X Window System, frame buffer of linux, and Cygwin.

1. Introduction

GImageView has following features:

Simple, but usefull/flexible user interface: Thumbnail window has 3 paned view (directory tree view, thumbnail view and image preview), and its layout is fully castomizable by Drag and Drop. Images can be also displayed by separated image window.
Managing image files: It can copy, move and link image files by Drag and Drop.
Low waste memory.
Also usefull for command line usage: If you specify image files and direcotries from comamnd line, image files are opened by image window, and directories are opened by thumbnail window automatically.
Tabbed browsing: It can open two or more directories at same time by tabbed thumbnail window which looks like tabbed web browser. If you drop files to tab, you can copy, move and link files to the directory.
Supported following graphich formats:
JPEG PNG PNM GIF TIFF XBM XPM BMP PCX TGA XCF MAG SVG (librsvg is required) MNG (libmng is required) WMF (libwmf is required) ANI (Gtk+-2 is required) RAS (Gtk+-2 is required)
It can play animation such as animation GIF and MNG.
Supports movie files and sound files using Xine and MPlayer. Supported file types are depended on Xine and MPlayer:
- AVI (MS-MPEG4, DivX, MotionJPEG, Cinepack and so on...)
- MPEG1, MPEG2, MPEG4, MPEG1 audio layer3
- Quick Time
- Real Media
- Any other unknown types...
It can extract compressed file automatically. (File name extension is not registed by default. Please open common -> filter page of preference dialog and regist it manually).

gzip, bzip2

Supports archive files using external command:
tar, zip, lha, rar
Supports various thumbnail cache types
Nautilus, Konqueror, GQview, Electric Eyes (Picview), xvpics (Thumbnail Managing Standard which supported by latest Nautilus and Konqueror will be implemented at next versoin of GImageView)
Supports slideshow
Threre are 10 types of thumbnail view, and supports vatious sort types.
Finding duplicated images
It can find duplicated image files by file siez, md5sum and similarity, and display it on tree view.

2. Requirements

You need following environment/libraries to build GImaqeView:

ANSI-C, POSIX
GLib-1.2 and GTK+-1.2 or later (http://www.gtk.org/). Also support GtK+-2.0 or later.
Imlib-1.9.x (ftp://ftp.gnome.org/pub/GNOME/stable/sources/imlib/) or gdk-pixbuf (ftp://ftp.gnome.org/pub/GNOME/unstable/sources/gdk-pixbuf/)
zlib and libpng

Following libraries and programs are optional:

GNU file
libjpeg
libmng-1.0.0 or later
librsvg-1.0.0 or later
libwmf-0.2.8 or later
bzip2-1.0.0 or later
xine-lib-0.9.8 or later (1.0-beta10 or later is recomanded)
MPlayer-0.90-rc2 or later (0.90 or later is remomanded)
GNU tar
zip
lha
rar

GImageView is confirmed on followin environment:

RedHat Linux 7.3, 8, 9
Mandrake Linux
Debian GNU/Linux potate, woody, sarge
Gentoo Linux 1.4-rc2
Plamo Linux 2.0 (Alpha3 Base), 3.0
Kondara MNU/Linux 1.2 and 2.0
Momonga Linux
Vine Linux (i386 & ppc) 2.1.5, 2.5. 2.6
FreeBSD 4.2-RELEASE
NetBSD
AIX

3. Download

You can get it from follwing place include old versions:

http://sourceforge.net/project/showfiles.php?group_id=39083

You can get also latest develop version from CVS:

$ export CVSROOT=:pserver:anonymous@cvs.gtkmmviewer.sourceforge.net:/cvsroot/gtkmmviewer $ cvs login
(Passward is emty, simply press Enter) $ cvs -z3 co gimageview

You can update it by following command:

$ cvs -z3 update

Develop version doesn't include configure script. Please execute "autogen.sh" script which placed top directory of source tree. You need autoconf, automake and libtool to make it.

In addition to it, please call your attention that CVS version is "latest" "develop" version. It may includes various bugs and sometimes it may losts your important data. Please use it at your own risk. If you found bugs, please report it to us.

4. Install

You can build it by following commands on all most all environment.

$ tar xvfz gimageview-x.y.z.tar.gz
$ ./configure
$ make
$ su
(Enter passward)
# make install

Please replace the version number suitably.

If you want to compile it against Imlib, please use "--disable-gdk-pixbuf" configure option:

$ ./configure --disable-gdk-pixbuf

If you want to compile against Gtk+2, please use "--with-gtk2"

$ ./configure --with-gtk2

To compile against linux-fb, please add "gtk+-linux-fb-2.0" argument to "--with-gtk2" option.

$ ./configure --with-gtk2="gtk+-linux-fb-2.0"

If you want to enable movie support, please add "--with-xine" or "--enable-mplayer" options. These options can be used at same time.

$ ./configure --with-xine --enable-mplayer

In addition to it, if you don't need debug information, you can strip it by following command.

# make install-strip

Development of GImageView is still in early stage, so format of preference file may be changed. Please backup your own ~/.gimv directory when update the GImageView.

5. Usage

You can show one or more image files by following command:

$ gimv [Image files...]

If you specify one or more directories with a "-d" option, you can show thumbnails of all images under the directory by thumbnail window.

$ gimv -d [Directory name]

If you specify both images and directories with a "-d" option, images are opened by image window, and thumbnails under directories are opened by thumbnail window.

$ gimv -d foo01.jpg ~/ ~/images images/foo02.jpg\

/usr/share/pixmaps/ bar.png ......

If you add a "-t" option, all images are opened by thumbnail window.

Followings are other options:

Usage: gimv [OPTION...] [Image files or directories...]

   -d, --directory          Scan directories at start up
   -R, --recursive          Scan directories recursively (use with "-d")
   -D, --scan-dot           Read dotfile when scan directory (use with "-d")
   -e, --ignore-ext         Ignore file name extention
   -s, --scale=SCALE        Specify image scale on image window(%)
   -b, --buffer=ON/OFF      Keeo original image on memory or not
   -M, --menubar            Show menu bar on image window
   -T, --toolbar            Show tool bar on image window
   -w, --thumbwin           Open thumbnail window at start up
   -i, --imageview          Open all images by image window
   -t, --thumbview          Open all images by thumbnail window
   -S, --slideshow          Open images by slide show
   -v, --version            Print version infomation
   -h, --help               Show this message

If you want to open a directory from GUI, please double click it on directory view, or specify it from file open dialog.

If you want to show compressed image files, please open common -> filter page of preference dialog and regist file name extention like "gz" or "bz2".

6. ChangeLog of README

2003/06/01(Thu) Takuro Ashie

Fixed typo (English Version)

2003/05/22(Thu) Takuro Ashie

Tranlated to English
Follow latest version (0.2.21).
Remove ChangeLog and TODO

2001/11/06(Tue) nyan2

for version 0.1.3
add CVS section in "get gimageview" chapter

2001/11/04(Sun) Takuro Ashie

Modified TODO
Added ChangeLog and minor fix.

2001/11/04(Sun) nyan2

for version 0.1.2

2001/10/18(Thu) nyan2

Minor change

2001/10/03(Wed) nyan2

for version 0.1.1

2001/09/12(Wed) - 2001/09/28(Fri) nyan2

for nightly
Follow modified features and bugfixes.

2001/09/10(Mon) nyan2

for 2001/10/10 nightly
Initial import

2001/09/08(Sat) nyan2

for 2001/09/08 nightly
Stated editing.

7. License

This program 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.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

8. Remarks

This document is modified by Nayn2 based on http://www.homa.ne.jp/~ashie/gimageview/.

[End Of File]