NAME

tkgifviewer - image viewer for animated GIFs

SYNOPSIS

tkgifviewer [options] file(s)

DESCRIPTION

tkgifviewer is an animated GIF viewer using the Tk library to open and manipulate images. The default mode is an image slideshow, showing one image at a time from those specified on the commandline. Keys and mouse control may be used to move through them. Other modes can be specified on the commandline, and are described below.

For user convenience tkgifviewer can open and display other image formats like PPM/PGM. If the tkImg package is installed, tkgifviewer additionally supports the image formats XBM, XPM, BMP, PNG, JPEG, TIFF, DTED, and RAW.

Filelists can be sorted in a number of ways. The default is the order the files were specified on the commandline, or the order they were read from the disk. You can specify sorting mode randomize.

MODES

Thumbnail mode forms an index print from the filelist. Image thumbnails are shown.

Fullscreen mode shows image in fullscreen view.

List mode doesn't display images. Outputs an 'ls'-style listing of the files in the filelist, including image info such as size, type, etc.

tkgifviewer can read options from the commandline.

OPTIONS

-h, --help display help output and exit

-v, --version output version information and exit

-q, --quiet Don't report non-fatal errors for failed loads.

-r, --randomize When viewing multiple files, randomize the file list before displaying.

-f, --filelist FILE This option is similar to the playlists used by music software. If FILE exists, it will be read for a list of files to load, in the order they appear. The format is a list of image filenames, absolute or relative to the current directory, one filename per line.

-F, --full-screen Make the window fullscreen.

-s, --show ATTRIBUTE Show specified attribute with tooltips. Allowed attributes are name, and filename.

-l, --list Don't display images. Analyse them and display an 'ls'-style listing. Useful in scripts hunt out images of a certain size/type etc.

-S, --sort TYPE The file list will be sorted according to TYPE. Allowed types are name, filename, and random.

-A, --action ACTION Specify a string as an action to perform on the image. In slideshow the action will be run when the enter key is pressed. The action will be executed by /bin/sh. Use format specifiers to refer to image info. See FORMAT SPECIFIERS for examples.

Eg. tkgifviewer -A "mv %f ~/images/%n" *

In slideshow mode, the next image will be shown after running the action.

-t, --thumbsize WIDTHxHEIGHT Enable thumbnail mode. Thumbnail mode creates an index print of thumbails. Each thumbnail has a maximal width and height given by the argument.

-d, --defer-animation Defer animation until all images are created. If this option is set the animation of all animated images will start synchronous.

-c, --disable-cache Disables caching of images in origial size. This option is available only in thumbnail mode. If you want to save memory you should use this option, but opening the image in origial size will be slower then. BOOLEAN is 0, 1, on, off, yes, or no.

-b, --background COLOR Specifies the background color of the viewer. The color will be given either in hexadecimal format (e.g. #RRGGBB) or as X11 color name.

-k, --highlightbackground COLOR Specifies the color to display in the highlight region.

-g, --use-gif-background If this option is set the original background color given in the GIF image will be used for the specific image.

-B, --borderwidth WIDTH Use this border width for each image frame. This option is available only in thumbnail mode. Per default the border width is 0.

FORMAT SPECIFIERS

%f image path/filename

%n image name

%w image width

%h image height

%u prints the current file number

%t prints the total number of files in the filelist

\n newline

Eg. tkgifviewer -A "mv %f ~/images/%n" *

GENERAL KEYS

In any mode the following keys may be used:

v, V, <F11> Toggle fullscreen.

Ctrl-Q, <ESCAPE> Quit the application.

SLIDESHOW KEYS

The default mode for viewing mulitple images is slideshow mode.

When viewing a slideshow, the following keys may be used:

p, P, <LEFT> Goto previous slide

n, N, <RIGHT>, <SPACE> Goto next slide

m, M Show popup menu.

w, W Size window to current image size.

<HOME> Goto first slide

<END> Goto last slide

<DELETE> Remove the currently viewed file from the filelist

<RETURN> Perform the action specified on commandline.

Ctrl-A Open dialog for performing the action specified on commandline.

Ctrl-C Open dialog for resetting the frame period changes.

Ctrl-D Open dialog for deleting current file.

Ctrl-F Open dialog for modifying the frame periods.

Ctrl-I Open information dialog.

Ctrl-L Open dialog for setting a link to current file.

Ctrl-M Open dialog for moving current file.

Ctrl-P Open dialog for setting the minimum frame period.

Ctrl-R Open dialog for renaming current file.

Ctrl-S Open dialog for saving the frame period changes.

Ctrl-Y Synchronize animation of original sized image with animation of thumbnail image.

Ctrl-1...Ctrl-5 Open dialog for performing the operation #1, #2, #3, #4, or #5 (#1 is last move/link operation, #2 is second last move/link operation, and so on).

GENERAL MOUSE ACTIONS

Mouse button 2 shows image info.

SLIDESHOW MOUSE ACTIONS

Mouse button 1 moves to the next image. Mouse button 3 activates the context-sensitive menu.

THUMBNAIL MOUSE ACTIONS

Mouse button 1 pans the window. Alternatively you may use the mouse wheel for scrolling, hold Shift button for fast scroll. Mouse button 3 activates the context-sensitive menu. Double click on an thumbnail image opens a window with selected image in original size. Double click on single image window scrolls the pane to the position of the origin image.

BUGS

None known.

LICENSE

Copyright (c) Gregor Cramer, 2011.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies of the Software and its documentation and acknowledgment shall be given in the documentation and software packages that this Software was used.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Email bugs and feature requests to

<http://sourceforge.net/p/tkgifviewer/tickets/new/>

This HTML page was made with roffit.