X-Git-Url: http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=blobdiff_plain;f=README;h=9e123937586cf2fe5e387d7186f41c3fe563b241;hp=7ce524bd57c691b7f9b9c8bfab291a9797235067;hb=a40d8f1e7f4bace37758d6f0bc4f598652b77b69;hpb=932432f09417b4fe1ec05bfb92dfe946f7fd32ea diff --git a/README b/README index 7ce524bd..9e123937 100644 --- a/README +++ b/README @@ -1,7 +1,7 @@ ################################################################### -## Geeqie 1.0alpha2 ## +## Geeqie 1.1 ## ## ## -## Copyright (C) 2008 The Geeqie Team ## +## Copyright (C) 2008 - 2012 The Geeqie Team ## ## Copyright (C) 1999 - 2006 John Ellis. ## ## ## ## Use at your own risk! ## @@ -17,9 +17,9 @@ possible to contact gqview author and the only maintainer. Geeqie projects goal is to move the development forward and also integrate the existing patches. -Geeqie is currently in alpha state. Everybody is encouraged -to try the new features, however for stable software look at -the original project. +Geeqie is currently considered stable. +Please report any crash or odd behavior to the bugtracker: +https://sourceforge.net/tracker/?group_id=222125&atid=1054680 For more info see: http://geeqie.sourceforge.net @@ -48,145 +48,31 @@ geeqie-devel@lists.sourceforge.net ======== Requirements Required libraries: - GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk + GTK+ 2.20: ftp://ftp.gtk.org/pub/gtk Optional libraries: lcms, for color management support: http://www.littlecms.com (disable with configure option: '--without-lcms') exiv2, for enhanced exif support: http://www.exiv2.org/ (disable with configure option: '--without-exiv2') + - due to fast development, newer versions work significantly better + FIXME: minimal version ? lirc, for remote control support: http://www.lirc.org/ (disable with configure option: '--disable-lirc') - + libchamplain - experimental map support, dissabled by default + http://projects.gnome.org/libchamplain/ + WARNING: this library has a lot of dependencise + ======== Notes and changes for this release [section:release_notes] - Changes: - - + Add support for color profiles (requires lcms, see Notes). - + Add ability to delete a folder and it's contents (with restrictions). - - Add support for jpegs embedded in pentax and olympus raw files. - - Add icons for image state, enabled with I keyboard shortcut. - - For pan view calendar only show months that contain an image. - - Make scrolling with overlays (full screen info display) a bit smoother. - - Make sort menus display choices as radio group instead of checkbox. - - Use white background for transparent images when printing. - * Escape filename characters "`$\ before passing them to the system shell - when running an editor command. - * Fix occasional crash in icon view when removing files. - * Always use aligned memory access in EXIF parser, fixes crash - with BUS error on sparc. - * Fix progress bar warning when removing files while loading thumbnails. - * Fix image count in full screen information overlay when in slideshow. - * Fix memory leak when unable to start a slideshow. - - Notes: - - For translation status list, see further below. - - Version in parentheses indicates first appearance of feature or change. - -!!! FIXME Geeqie changes !!! - - Below are GQView releases: - (2.1.5) Add support for color profiles when lcms is installed. To - disable color profiles and use of lcms, run configure - with '--without-lcms'. - - (2.1.1) Add support for viewing jpeg images and EXIF embedded within - raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef). - Note that not all cameras that support a raw format will necessarily - save a usable jpeg in the raw file (for example some Nikon cameras only - store a tiny thumbnail within the raw .nef file). - - (1.5.6) The "shared thumbnail cache" is a proposal to unify the method - of storing thumbnails, so that they are compatible between different - applications. Using this option will allow GQview to share it's - thumbnails with, and use thumbnails from, other applications. Current - releases of GNOME (through nautilus and gthumb) and the gimp use this - new thumbnailing system. The latest draft of the thumbnail standard - is located on freedesktop.org in the standards section, and links to: - - http://triq.net/~jens/thumbnail-spec/index.html - - The shared thumbnail standard and GQview's classic mechanism can - not be used at the same time, enabling the "use shared thumbnail cache" - option will disable the use of classic thumbnails and use the new - shared thumbnails. - - (1.5.6) Collections contained in $HOME/.gqview/collections are now - updated when moving or renaming files, even if the collection is not - open at the time. - - (1.5.6) The new option to the keep the full screen window above other - windows is only available when using at least GTK+ 2.4.0 - - (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG. - The GNOME Human Interface Guidelines live at: - http://developer.gnome.org/projects/gup/hig/ - To restore the old button order you must be using GTK 2.6 and set - the "gtk-alternative-button-order" key to TRUE in the gtkrc file: - $HOME/.gtkrc-2.0 - by changing or adding this line: - gtk-alternative-button-order = 1 - - (1.5.5) The dithering option is now a hidden option, to change it - please refer to section 10.7 of the manual (help -> contents). - - (1.5.0) Keywords and comments can now be entered for a file. Two places - allow keyword and comment entry. The first is via the new image details - sidebar accessed with (Ctrl-K), and the second is a details tab in the - properties dialog. If multiple files are selected, two buttons are - available: One allows adding the keywords to the selected files, the - other replaces existing keywords with the new keywords. - - Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and - mirrors the existing filesystem tree. Metadata filenames have a suffix - of .meta appended. If 'cache into .thumbnails' is enabled, metadata is - stored locally to the original file in a hidden subfolder ".metadata". - If write permissions do not allow local saving of metadata, GQview falls - back to the default $(HOME)/.gqview/metadata location. - - (1.5.0) Search dialog (F3 key) types: - Path searches files in the entered folder. - Comments searches all file metadata stored in ~/.gqview/metadata. - Results searches the current list of results, allowing refinement. - - (1.3.6) Drag and drop has been significantly improved, with a few - changes. Button 1 will now initiate a drag, button 2 will still work - for this, the difference is button 2 will not change the selection. - - (1.3.6) A middle button click will now toggle selection of clicked item. - - (1.3.5) UTF-8 and filenames: GQview works fine if your filenames - correctly match the preferred locale encoding (LANG environment - variable), and prints errors on the console when they do not. - - (1.3.3) Safe delete does not include undo, you will need to go to the - trash folder and retrieve the file(s) manually. The files can be viewed - by clicking the view button near the safe delete option in the preferences - window. Files moved to the trash folder are prefixed with a 6 digit - number. Lower numbers are older, and deleted (permanently) first when the - trash size limit is reached. - - (1.3.2) New in 1.3.2 are sidebars for EXIF data display and a sort - manager. EXIF (ctrl + E) should be self explanatory. The Sort manager is a - directory list that allows copying or moving the displayed image to that - destination with one click of the button - very helpful when visually - sorting many images into subdirectories. To edit, reorder, or remove items - in the sort list, use the right click menu. The keyboard can also be used - by moving the focus to the desired button, then pressing menu/ctrl+f10 key - to display the popup menu, or shift+up/shift+down keys to change the - button location in the list. Items can also be added to the list by - dragging a directory onto the list. +See http://geeqie.wiki.sourceforge.net/new_features + Code hackers: If you plan on making any major changes to the code that will be offered for inclusion to the main source, please contact us first - so that we - can avoid duplication of effort. A good example is porting any part of - GQview that uses deprecated widgets to GTK2 widgets, there are already - several such patches floating around. This is especially true if the - change is listed in the TODO! + can avoid duplication of effort. The Geeqie Team Known bugs: @@ -199,17 +85,6 @@ geeqie-devel@lists.sourceforge.net General install: make install Removal: make uninstall -!!! FIXME !!! - - To build an RPM binary: - - on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'. - on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'. - on other rpm distros, it depends on which version of rpm is used, if - the option fails with the rpm command, try rpmbuild. - - Where the resulting package is placed is distribution specific, for - example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/ - ======== Description / Features Geeqie is a graphics file viewer. Basic features: @@ -226,9 +101,17 @@ geeqie-devel@lists.sourceforge.net - Comparison of images to find duplicates by name, size, date, dimensions, or image content similarity. - EXIF support. + + Geeqie 1.1: + - support for stereoscopic images + - input: side-by-side (JPS) and MPO format + - output: single image, anaglyph, SBS, mirror, SBS half size (3DTV) ======== Documentation (brief) [section:documentation] +This sections lists default hotkeys. Most of the hotkeys can be redefined +in the Preferences dialog. + Keyboard commands: [PageDown], [Keypad PageDown] next image [PageUp], [Keypad PageUp] previous image @@ -255,10 +138,11 @@ geeqie-devel@lists.sourceforge.net [Ctrl] - R rename file [Ctrl] - D, [Delete] delete file [Ctrl] - W close window - [Ctrl] - Q exit GQview + [Ctrl] - Q exit Geeqie Edit menu related: - [Ctrl] - 1 .. 0 run external editor + 1 .. 6 toggle mark + [Ctrl] - 1..6 select mark [Ctrl] - A select all files [Ctrl] - [Shift] - A unselect all files [Ctrl] - P display image properties window @@ -277,8 +161,6 @@ geeqie-devel@lists.sourceforge.net X, [Keypad *] zoom to fit within window W zoom to fit width of window H zoom to fit height of window - 1, 2, 3, 4 zoom to Nx (3 = 3x) - 9, 8, 7 zoom to -2, -3, -4, respectively T toggle thumbnails in list view [Ctrl] - L display files as list view [Ctrl] - I display files as icon view @@ -286,8 +168,8 @@ geeqie-devel@lists.sourceforge.net R refresh list L (Un)float file selection area [ctrl] - H (Un)hide file selection area - [Ctrl] - K toggle Keywords sidebar - [Ctrl] - E toggle EXIF sidebar + [Ctrl] - K toggle sidebar with EXIF or keywords + [Ctrl] - E show EXIF window [Ctrl] - S toggle sort manager sidebar F, V toggle full screen S toggle slide show @@ -322,7 +204,6 @@ geeqie-devel@lists.sourceforge.net [Enter], [Keypad Enter] view image with focus in main window V view image with focus in new window - [Ctrl] - 1 .. 0 open selected image(s) in editor S save collection [Ctrl] - S save collection as... @@ -388,27 +269,9 @@ geeqie-devel@lists.sourceforge.net ======== Editor command macros [section:editors] - Any one of the following filename markers may be used: - - %f Replaced with list of selected files, may occur once. - %p Command is run once for each selected file, may occur multiple times. - - Use of the following to display output window for the command: - - %v Display result of command in output window, must occur as first two - characters in the command, or immediately after the "%w" macro. - %V Like v above, but when used with %p, only displays output window for - multiple files. The output of a single file is suppressed. - - Additional macros: +Editors are configured via standard desktop files, see +https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig - %w Prevent full screen from deactivating when command is executed, - must occur as the first two characters. - - %% This will be replaced by one '%'. This is the way to escape '%'. - - %d This only makes sense for external commands like copy or move as this - is replaced by the destination. ======== Overlay Info [section:overlay] @@ -442,6 +305,8 @@ Overlay info format string syntax is: %tag[:max_length][:extra]% formatted.Flash Flash formatted.Resolution Resolution formatted.ColorProfile Color profile + formatted.GPSPosition GPS position + formatted.GPSAltitude GPS altitude You can limit the length of displayed data using :number notation: %formatted.Camera:20% will truncate the displayed data to 20 characters @@ -456,7 +321,7 @@ Overlay info format string syntax is: %tag[:max_length][:extra]% "1/200 - 80 mm" if there's no ISO information in the Exif data. If a line is empty, it is removed. - This allows to add lines that totally disappear when no data is available. + This allows one to add lines that totally disappear when no data is available. Extra string uses special character '*' to mark the position of the data. If no '*' is present, then extra string is just appended to data. @@ -468,29 +333,10 @@ Overlay info format string syntax is: %tag[:max_length][:extra]% "%name:*\n%" -> name is displayed in italics ended with a newline "%size:\n%" -> size is displayed with a newline at end "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100" - "Collection *\n" -> display collection name in bold prefixed by + "%collection: Collection *\n%" -> display collection name in bold prefixed by "Collection " and a newline is appended -======== Additional comments: - - Hidden options: - These options are not adjustable in the preferences window, to change - them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option - becomes 'hidden' when it is removed from the user's visibility, and - only remains so that those few users that really want it will not complain - about it's removal :) - - lazy_image_sync: false - Set true to enable the old behavior of lazy image updates when changing - directories. (viewed image will remain until a new file is selected) - - display_dialogs_under_mouse: false - Set true to force dialogs to display under the current mouse position, - note that this goes against the preference set for the window manager. - - - ======== Credits [section:credits] @@ -553,6 +399,7 @@ Overlay info format string syntax is: %tag[:max_length][:extra]% Thomas Klausner Danny Milosavljevic Ronny Steiner + Klaus Ethgen for German translation Matej Erman @@ -669,54 +516,10 @@ Overlay info format string syntax is: %tag[:max_length][:extra]% Kjell Morgenstern for random slide show speedup patch + Klaus Ethgen + for GPS integration, Search enhancement and other patches + And... Thanks to the users for finding Geeqie useful. -======== Translation status: - - Please send po files/patches in gzipped form to ensure data integrity. - -Translations statistics -Date: Fri, 05 Sep 2008 00:30:54 +0200 - -Note: completion % in the chart below may not be quite correct - when fuzzy translations exist but do not appear in the source. - For exact results, run make update-po with up to date POTFILES.in. - comp % = trans / (trans + fuzzy + untrans) - -Language Comp(%) Trans Fuzzy Untrans Total -fr 100.00 996 0 0 996 -be 82.43 821 77 98 996 -ru 71.99 717 128 151 996 -eu 62.05 618 185 193 996 -eo 61.95 617 186 193 996 -vi 61.85 616 192 188 996 -it 61.65 614 187 195 996 -pt_BR 61.65 614 187 195 996 -zh_TW 60.84 606 183 207 996 -sk 60.34 601 192 203 996 -fi 58.23 580 211 205 996 -nl 58.23 580 214 202 996 -sv 58.03 578 207 211 996 -bg 57.93 577 208 211 996 -ca 57.93 577 208 211 996 -cs 57.93 577 208 211 996 -de 57.93 577 208 211 996 -es 57.93 577 208 211 996 -ja 57.93 577 208 211 996 -pl 55.32 551 180 265 996 -ar 38.86 387 332 277 996 -ro 34.34 342 352 302 996 -hu 32.93 328 342 326 996 -id 17.17 171 412 413 996 -et 16.77 167 411 418 996 -uk 14.86 148 413 435 996 -nb 13.76 137 418 441 996 -zh_CN.GB2312 13.76 137 419 440 996 -th 12.95 129 413 454 996 -sl 12.55 125 422 449 996 -da 11.85 118 406 472 996 -ko 11.04 110 65 821 996 -tr 4.92 49 395 552 996 -