************************ QtVu 0.3.21 beta2 ************************
QtVu, pronounced CuteView, is an image viewer for The X Window System. It was developed using Linux, but I hope it'll run on other UNIX variants aswell. QtVu is heavily inspired by ACD System's excellent ACDSee.
QtVu was originally written by Marius Sundbakken. You can reach him at <marius@fix.no>
As of version 0.3.19 QtVu is maintained by Jan Borsodi. You can reach me at <jb@ez.no> or <amos@abn.hibu.no>.
All bugs reports, suggestions etc. can be mailed to Jan Borsodi. General thoughts can be mailed to Marius Sundbakken.
This version is a minor update.
The current source code will be discontinued, a new and better designed version of QtVu will be available at a later time. If you have any cool ideas for this program, want to rate this program or just want to help you can check the developer homepage at: https://sourceforge.net/project/?form_grp=448
- Requirements
- Troll Tech's Qt Library (2.0 or later) and the Qt Image IO extension library. Download at ftp://ftp.troll.no/qt/source/qt-2.00.tar.gz or follow the links on http://www.troll.no
Due to some never C++ keywords used in the source you might experience problems when compiling with a slightly "older" version of the egcs compiler, if you get a compiler error on a line with the keyword static_cast or dynamic_cast, it means you've got to upgrade you compiler, or you can change every line with the casts (if you know what you're doing that is).
If you want the development documents you will need Doxygen. Download at http://www.stack.nl/~dimitri/doxygen/download.html
Compiling the Qt Image IO extensions:
Make sure you've got the qt-2.00(or later) sources, follow the instructions as
stated in the qt documentation, cd into the "extensions/imageio/src" directory
and do "make".
The libs will then be located in the $QTDIR/lib directory, make sure you have
this in your "/etc/ld.so.conf" or in the "LD_LIBRARY_PATH" env variable.
- Compiling
- A simple "make" in the src directory should be sufficient, just remember to set the QTDIR enviroment variable correctly. QtVu has only been tested on the Linux platform. If you experience problems with the Makefile you should download tmake from http://www.troll.no. Install it and do a "tmake -o Makefile make.pro" in the src directory and then a "make".
- Install
- By now you should have the qtvu executeable, and the install executeable, to install it follow these procedures: "cd src" "su" and type in your superuser password "./install" which will install the program and icons, the icons can be installed in your homedirectory or systemwide at /usr/share/icons if you want icons for your personal user exit the superuser with "exit" and then run "./install --icons" again.
"./install --help" gives some more information.
If you want some developers documentation you can do:
"cd .."
"./makedoc"
(Requires Doxygen)
- Usage
- You can simply type "qtvu" and start browsing, or type "qtvu <filename>" to look at a picture.
When you start it you will have two dir listings and a thumbnail.
|Dirs|Hotlist| |____________________________
| | | | | | | TreeDirView | | | | | | | DirView | | | | _________________ | | | | | | | | Thumbnail | | | |FileList | Thumbnails| |
You can browse the directories by double clicking on the dir folders. A single click on a picture file will display it in the thumbnail, and a doubleclick will display the picture in full view. By clicking on the FileList and the Thumbnails buttons on the bottom you can change between an ordinary dirview and a thumbnailview. The cursors keys, enter and backspace should work in some of the dirviews. When you are viewing a picture in full view, click the folder icon on the toolbar to get back to browse mode, click on the left arrow button to see the previous picture and the right arrow button to see the next picture. You can quickly go to a favourite directory by using the HotList.
When in view mode press Escape or Return to return to list mode.
** Explanation of the ~/.QtVu/config file **
# The size of the main window
Size = <number>, <number>
# The size of the log window
LogSize = <number>, <number>
# Unused
Scroll = <number>, <number>
# Use hot list as current tab?
HotListFirst = <Yes|No>
# Opaque mode on splitters?
SmoothGUI = <Yes|No>
# The size of the main splitters
Splitter = <number>, <number>
# The size of the preview splitter
Divider = <number>, <number>
# Use faster directory listing?
FastDir = <Yes|No>
# Show pictures in full screen?
FullScreen = <Yes|No>
** Explanation of the ~/.QtVu/hotlist file **
The format of this file is simple,
you supply a name and a path like below:
<name> <path>
You can have as many entries as you like.
Known Bugs:
- Clicking on directories with no access will crash.
- If you enter the view mode with clicking the mouse you have to press Tab once to gain keyboard focus.
New features in QtVu 0.3.21 beta2
- Includes graphical installer.
New features in QtVu 0.3.21 beta
- Now uses Qt 2.00.
- You can now use a faster directory listing, this just checks the extension.
- Can view images in full screen(experimental)
- New configuration directory called ~/.QtVu/
- Hotlist is stored in config. dir.
- Icons are stored there too.
- Some new icons has been supplied.
- It remembers most of your state when you quit it, like window size, splitter sizes, which tabs is used etc..
- Bmp pictures are displayed with a color.
- You can change between four styles supplied by Qt2.0, they are not saved.
- Added a log window which can be turned on and off.
- Drag'n'drop has been removed, it was buggy anyway.
- Supports wheel mouse when viewing pictures.
- Some bug fixes.
New features in 0.3.19:
- Pixmap icons are properly installed and will hopefully be found by the program.
- Rewritten the thumbnailviewer, though not completely finished.
- Added a tiny configuration file, ~/.qtvurc, as for now only the window size is saved.
- Better GUI handling (still needs a lot of work though)