1 | Right-click the main window or
gallery window thumbnail: A popup menu appears with some commonly used menu functions. |
2 | keyboard shortcuts - these are
documented in a table below. You can also add your own shortcuts for the menu functions you choose (more). |
3 | Favorites menu - a toolbar button for a graphical popup menu. You can add text and/or icons that link to any menu functions you choose. You can physically arrange them in a layout window. You can leave this window open and access its functions with one click (more). |
File Menu | File Management |
New Window | Clone Fotoxx and open a new window slightly offset from the old one (more). |
Open Image File | File open dialog - open an image file to view or edit (more). |
Open Previous File | Go back to the last image file opened (more). |
Recently Seen Images |
Gallery of the most recent image files viewed or edited (more). |
Newly Added Images |
Gallery of the most recently added new image files (more). |
Open RAW File (ufraw) | Open a camera RAW file and edit with Ufraw (more). |
Save to Disk |
Save modified image to disk file (more). |
Rename Image File | Rename image files, optionally add sequence numbers (more). |
Create Blank Image | Create a new blank image file (more). |
Trash Image File | Move an image file into the trash bin (more). |
Print Image File | Select printer / paper format / orientation and print image (more). |
Quit Fotoxx | Exit from Fotoxx. |
Tools Menu | Utilities and setup functions. |
Synchronize Files | Rebuild the image search index and refresh thumbnails (more). |
User Settings | A collection of user preferences and settings (more). |
Keyboard Shortcuts | Assign keyboard shortcut keys to menu functions (more). |
Manage Collections | Make named image collections, arrange the sequence, etc. (more). |
Move Collections | Update collections when image top directory is changed (more). |
Slide Show | Show a series of images full screen (no menu or toolbar) (more). |
Batch Rename | Rename many image files using a base name and sequence number (more). |
Batch Convert/Resize/Move | Convert / resize / move images (for upload to the web, e-mail, etc.) (more). |
Batch Convert RAW Files | Convert RAW image files to jpeg, png, or tiff (more). |
Brightness Distribution | Show brightness distribution graph of current image (more). |
Grid Lines | Add or remove grid lines for image alignment (warp, rotate) (more). |
Show RGB | Show RGB values at position of mouse click (more) |
Monitor Color | Display a color palette for tuning your monitor (more). |
Monitor Gamma | Adjust monitor gamma for better image editing (more). |
Change Language | Change the GUI language (more). |
Missing Translations |
List missing translations to a popup window (more). |
Edit Translations | Revise a translation interactively while using Fotoxx (more). |
Menu and Launcher | Add a system menu entry and desktop launcher (more). |
Burn Images to CD/DVD | Select images and write them to CD, DVD or BlueRay (more). |
Resources | Dump resource usage data to the log file (more). |
Metadata Menu | View and edit metadata (data stored within image files) |
Tags Overview | Explanation of tags and how they are used (more). |
Edit Metadata | Add or change image date, rating, caption, comments, or tags (keywords) (more). |
Batch Add Tags | Add multiple tags to many images at once (more). |
Batch Delete Tag | Delete or replace one tag for many images at once (more). |
View Metadata (short) | View most important image data (more). |
View Metadata (long) | View all available image data (more). |
Edit Any Metadata | Add or change any metadata (more). |
Delete Metadata | Delete specific metadata or all image metadata (more). |
Geotags Overview | General Information (more). |
Download Geolocations | Download city locations and a world map for use in geotag functions (more). |
Edit Geotags | Add geotag data (city, latitude, longitude) to image EXIF data (more). |
Batch Add Geotags | Add the same geotag data to multiple image files (more). |
Images by Location/Date | Find images from selected country / city / date range (more). |
Images by Map Location | Click on a world map to get images at or near the selected location (more). |
Search Images | Find images with desired tags / geotags / ratings / dates / comments / captions (more). |
Area Menu | Selected areas within images where edits are confined |
Overview | Explanation of area selection and editing (more). |
Select | Select an area for subsequent editing (more). |
Show / Hide | Show or hide an area outline (more). |
Enable / Disable | Enable or disable an area for subsequent editing (more). |
Invert | Invert an area (more). |
Unselect | Unselect an area (more). |
Copy / Paste | Copy an area to memory and paste it somewhere else (more). |
Open / Save | Save an area to a file and load it later to use in other images (more). |
Image Menu | Functions that change image size, shape, content |
Rotate 90° |
Turn an image 90° left or right, to upright the image (more). |
Rotate | Rotate an image (level an image or turn in 90 degree steps) (more). |
Trim/Crop | Cut out a rectangular portion of an image (more). |
Auto-Trim | Auto-select trim margins to remove after rotate, unbend, or warp functions (more). |
Resize | Scale an image up or down (pixel dimensions) (more). |
Flip | Mirror an image horizontally or vertically (more). |
Add Text | Write text on top of an image (more). |
Retouch Menu | Functions to improve an image |
Voodoo Enhance | Automatic image enhancement (more). |
Brightness / Color | Edit brightness, contrast, color saturation, color balance (more). |
Gamma Curves | Edit brightness and color using the classic gamma curve (more). |
Tone Mapping | Increase local contrast to to enhance details (more). |
Flatten Brightness | Flatten the brightness distribution to enhance detail (more). |
Expand Brightness | Clip low / high brightness levels and expand the rest (more). |
Brightness Ramp | Horizontal / Vertical variation of brightness (more). |
Paint Edits | Apply an edit function gradually by "painting" with the mouse (more). |
Leverage Edits | Apply edit functions regulated by initial brightness or color (more). |
Repair Menu | Functions to correct problems in an image |
Sharpen | Sharpen a blurred image (more). |
Blur | Blur an image (e.g. smoothen skin) (more). |
Reduce Noise | Reduce noise (speckles) in low-light images (more). |
Smart Erase | Remove power lines and other spoilers from an image (more). |
Red Eyes | Remove red eyes from flash photos (more). |
Paint/Clone | Paint pixels or areas with color or with other parts of the image (more). |
Remove Dust | Remove dust spots on images made from scanned slides (more). |
Anti-alias Tool |
Reduce jagged lines or edges in
low-resolution images (more). |
Fix Color Fringes | Reduce chromatic aberration (more). |
Fix Stuck Pixels | Fix stuck pixels (always bright or dark) from defective camera sensor (more). |
Color Menu | Functions to improve or correct color |
White Balance | Remove false color from an image (more). |
Color Mode | Make a black-white or color negative, or positive from negative, or sepia coloring (more). |
Color Profile | Convert an image from sRGB to some other RGB color profile (more). |
Match Colors | Match the colors in one image to those in another image (more). |
Revise RGB | Make complex color corrections that vary over the image (more). |
CMYK Density | Change brightness, CMYK colors, or contrast using OD units (more |
Bend Menu | Funtions that bend or warp an image |
Unbend | Fix perspective problems (more). |
Keystone Correction | Straighten a photo made from an offset angle (more). |
Flatten Book Page | Flatten/straighten a photographed page from a book (more). |
Warp area | Distort image within an area by pulling with the mouse (more). |
Warp curved | Distort entire image by pulling with the mouse (more). |
Warp linear | Distort entire image by pulling with the mouse (more). |
Warp affine | Distort entire image by pulling with the mouse (more). |
Effects Menu | Functions that make artful transformations |
Color Depth | Reduce color depth (posterize) (more). |
Sketch |
Transform a photo into a pencil sketch (more). |
Drawing |
Transform a photo into a line drawing (more). |
Graduated Blur |
Blur pixels according to contrast (more). |
Embossing | Transform a photo into a simulated embossing (more). |
Tiles | Transform a photo into tiles (pixelate image) (more). |
Dots | Transform a photo into an array of dots (more). |
Painting | Transform a photo into a simulated painting (more). |
Shift Colors | Replace selected colors with different colors (more). |
Vignette | Change brightness or color in a radial pattern (more). |
Combine Menu | Functions that combine multiple images |
High Dynamic Range | Make a high dynamic range image from multiple images (more). |
High Depth of Field | Make a high depth of field image from multiple images (more). |
Stack / Paint | Combine multiple images to remove tourists and cars (more). |
Stack / Noise | Combine multiple images to reduce noise (more). |
Panorama | Join 2-4 overlapping images horizontally (more). |
Vertical Panorama | Join 2-4 overlapping images vertically (more). |
Mashup |
Arrange multiple images and text on a layout. (more). |
Plugins Menu | Other image edit programs can be used as edit functions in fotoxx (more). |
Help Menu | User guide, README, change log (more). |
Color | Change the color of the mouse cursor and selected image areas (more). |
Undo / Redo | Undo one edit / Redo one edit - up to 99 edits of the current image. |
Shift + Undo / Redo | Changes the buttons to [undo all] and [redo all]. |
Sync.G |
Set the gallery to the directory of the image in Tab F (navigation). |
Open | File open dialog - open an image file to view or edit (more). |
Prev / Next | Go to previous or next image in the current directory or search set. |
Save |
Save (modified) image to disk file (same, new version, new file) (more). |
Trash | Move an image file into the trash bin (more). |
Sync.G |
Set the gallery to the directory of the image in Tab F (navigation). |
Open | open another directory for a new image gallery window |
GoTo | open a list of bookmarks, select one and go there |
Zoom+ | use larger thumbnails |
Zoom- | use smaller thumbnails or no thumbnails (show file names only) |
First | go to the top of the gallery (the first image files) |
Last | go to the last page in the gallery |
Page up | go up (back) one page |
Page down | do down (forward) one page |
Row up | go up one row |
Row down | go down one row |
Sort | sort gallery files by name, mod date/time, photo date/time (EXIF) |
Menu | main | gallery | description |
Rename | x | x | rename the file without changing the directory (more) |
Copy to | x | x | copy the file to another directory (create a duplicate) |
Move to | x | x | move the file to another directory (remove from present directory) |
Delete | x | x | delete the file (cannot be reversed) |
Trash | x | x | move file to the trash folder (can be reversed) (more) |
x | x | print the file (more) | |
Trim | x | |
trim the file (crop) (remove unwanted margins) (more) |
Resize | x | |
change the image size (pixel dimensions) (more) |
Rotate 90° |
x | |
rotate the image +/- 90 degrees (more) |
Voodoo Enhance | x | |
fast automatic enhancement that may be OK (more) |
Brightness/Color | x | |
adjust brightness, contrast and color (more) |
Gamma Curves | x | |
adjust gamma curves for brightness or for separate RGB colors (more) |
Flatten Brightness | x | |
flatten the image brightness distribution (may enhance details) (more) |
Tone Mapping | x | |
tone map the image (enhance low-contrast details) (more) |
White Balance | x | |
rebalance colors by clicking on a white or gray image location (more) |
Red Eyes | x | |
remove red eyes from flash photos (more) |
Grid Lines | x | |
add or change grid lines (more) |
Select Area | x | |
select image areas for localized edits (more) |
Copy to Clipboard | x | x | copy image to clipboard for paste by other application |
Main Window (tab F) | Fixed shortcuts |
left / right arrow keys | Previous / next image |
+ or = / - keys | Zoom image bigger / smaller |
F / G / W keys | Open corresponding window tab F / G / W |
Z | Toggle: zoom image to 100% / fit image in window |
Escape key | Exit slide show mode, exit a dialog. |
Space Bar | Pause and resume slide show |
F1 function key | Show user guide for current or prior menu function |
F11 function key | Toggle main window to full-screen (with no menu/toolbar) and back |
|
|
Gallery window (tab G) | Fixed shortcuts |
Home / End keys | move to first / last page of image gallery |
Page Up / Down keys | move to previous / next page of image gallery |
up / down arrow keys | move up / down by one row of image gallery |
left / right arrow keys | move to previous / next page of image gallery |
+ or = / - keys | bigger / smaller thumbnail size |
|
|
Dialogs for User Input | Fixed shortcut |
F1 function key | display user guide for current function |
|
|
Default Shortcuts | These can be changed using Tools > Keyboard Shortcuts |
N | Rename Image File |
K | Keyboard Shortcuts - edit |
Alt+G | Grid Lines on/off |
T | Trim/Crop Image |
V | Voodoo Enhance |
B | Brightness/Contrast/Color |
Alt+U | Undo |
Alt+R | Redo |
left click | Zoom-in: magnify image, center at click position |
right click | Zoom-out: restore image to window size. If no zoom, popup menu with common menu functions. |
mouse wheel | Zoom in and out depending on wheel direction |
left drag on image | Pan/scroll zoomed image, same direction or magnified opposite direction (like scroll bars) |
menu text | text for the popup menu - optional if a menu icon is used |
menu func | the Fotoxx function to use - the exact menu name |
menu icon | menu icon - /directory.../filename.png - optional if a menu text is used |
icon size | if icon is used, its size from 24x24 to 64x64 pixels |
close window | checkbox: close the popup window when this menu is selected |
tiff-16 | tiff-8 | png-16 | png-8 | jpeg-100 | jpeg-90 | jpeg-80 | jpeg-70 |
70 MB | 35 MB | 23 MB | 17 MB | 8 MB | 3 MB | 2 MB | 1 MB |
Startup Display | The initial window content when
Fotoxx is started. Recent Files: the most recently viewed or edited image files. Newest Files: image files most recently added to the Fotoxx database. Previous Image Viewed: return to the last image viewed or edited. Blank Window: start with no image in tab F and the top image directory in tab G. Directory Gallery: a top image directory or any sub-subdirectory underneath. Image File: any valid image file. |
Menu Style | Classic: at the top of the window. Vertical: vertical on the left side of the window. The toolbar is under the menu. Vertical is more space efficient for the newer wide-screen monitors. |
Toolbar Style | The toolbar style for both windows, image (tab F) and gallery (tab G). |
Image Pan (zoomed image) |
Drag: image moves with the
dragged mouse. Scroll: image moves against the dragged mouse (like invisible scroll bars), Magnified: movement is magnified: multiple drags for large movement are not needed. |
Warn Overwrite | Whether attempts to replace the original image is warned or not. Saving to a new version is never warned. Saving to a new file name is always warned if the file already exists. |
Default JPEG quality |
The "quality" value used for [save] [replace] and [save] [new version]. Use [save] [new file] to use another value for a particular file. |
Zoom Ratio | The image size increase with each zoom. Choose 1, 2, or 3 zooms for each 2x increase in size. |
Interpolation |
The algorithm used to display an
image at sizes other than 1x. tiles: no interpolation - you can see the true image pixels if the size is big (4x) bilinear: "jagged edges" are removed without loss of detail. RECOMMENDED. hyperbolic: supposedly better than bilinear, but not much. VERY SLOW - not recommended. |
RAW command | The command used to convert camera RAW files to tiff-16. This can be changed if you need. |
RAW file types | The RAW file types recognized. If your camera uses something else, add it to the list and this may work. You can also shorten the list to those file types you actually use. |
RGB | 0 | 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128 | 256 |
EV | nan | -7 | -6 | -5 | -4 | -3 | -2 | -1 | 0 | 1 |
OD | nan | 2.41 | 2.11 | 1.81 | 1.51 | 1.20 | 0.90 | 0.60 | 0.30 | 0.0 |
Key Name | Fotoxx Usage |
Date/Time Original | Edit Metadata function - image date |
Keywords | Edit Metadata function - image tags |
Rating | Edit Metadata function - image stars |
User Comments | Edit Comments function |
Caption-Abstract | Edit Caption function |
Geotags | Edit Geotags function, 3 search image functions |
Edit Status | History of Fotoxx edits applied to the image |
any key | Edit Any Metadata, Delete Metadata |
Rectangle | Drag the mouse to enclose a rectangular area. |
Ellipse | Drag the mouse to enclose an elliptical area. |
Freehand Draw | Drag and click the mouse to draw lines that outline an enclosed space. |
Follow Edge | Click along the edge of an
object in the image to draw lines that follow the edge, or drag the mouse to draw freehand. |
Replace | Drag the mouse near an area edge-line to move the edge to the mouse. |
(controls for the methods below) |
"mouse radius" sets the
size of a selection circle around the mouse pointer. "match level" sets the color match (0-100%) required for pixel selection. |
Select area within mouse |
Left/right drag to
select/unselect all pixels within the mouse circle. Independent of color. |
Select one matching color within mouse |
Click on the image to
select a color. Left/right drag to select/unselect pixels inside the mouse circle that match the color within "match level". |
Select all matching colors within mouse |
Left/right drag to
select/unselect pixels surrounding the mouse that match the color of any pixels inside the mouse circle within "match level". |
left drag | select pixels inside mouse circle and those with matching colors within the search range |
right click | undo previous selection, repeat to unselect more |
right drag | unselect pixels inside mouse circle and those with matching colors within the search range |
Flatten Outliers 1 | The highest and lowest pixel values within a radius are moderated slightly. |
Flatten Outliers 2 | Pixels are compared to the mean
and sigma of pixels within a radius. Those outside one sigma are moved slightly back toward the mean. |
Median Brightness | Pixels are set to the median value of their neighbors within a radius. |
Top Hat | Detect outliers by comparison
with a band of pixels at a distance. The distance is increased in steps from 1 pixel to the radius limit. |
Wavelets | Image brightness (with noise) over distance is converted into a series of wave functions that nearly sum to brightness and represent an approximation with less noise. |
Method and Example |
Advantages |
Disadvantages |
Directory and File Names e.g. files like this: /.../images/2012/italy/rome-12.jpg |
|
|
Captions and Comments e.g. caption or comment like this: "2012 Italy Rome Forum" |
|
|
Tags (EXIF Keywords) e.g. tags like this: italy, rome, forum, elizabeth |
|
|
Geotags e.g. location data like this: Berlin Germany 52.52 N 13.42 E |
|
|
Named Collections e.g. names like this: best scenery Italy 2012 |
|
|
total images | Fotoxx
has been tested with 50K images with no noticable slowdown. 500K images should be practical on a strong computer. Image search functions may get slower beyond 100K images. |
image size | The max. supported width or height is 20K pixels (compile time constant). |
image edits | 99 edits for undo/redo and file version numbering (filename.v01 to filename.v99). |
geotag cities | 10,000 different cities/locations for geotagged images. |
tags | There are limits listed in the topic Tags Overview. |
xdg-utils | open text or html files with user's preferred application |
exiftool | read and write image metadata (tags, comments, etc.) |
dcraw | batch convert RAW image files to tiff, jpeg, or png |
ufraw | open a RAW image for editing using the ufraw GUI |
brasero | burn a CD or DVD with selected images |
xgamma | used for the Monitor Gamma function (adjust monitor gamma) |
addr2line |
adds line numbers to zappcrash dump - important debug information |
g++ | GNU C++ compiler and C libraries |
libgtk3.0-dev | Gnome GTK3/GDK3/Pixbuf/etc. function libraries |
libtiff4-dev | tiff library development files |
libpng12-dev | png library development files |
liblcms2-dev | Little CMS development files |
-v | output release version and and exit |
/.../imagefile.jpg | initial image directory or image file to open |
-recent (or -r) | show a gallery of recent files, most recent at the top |
- new (or -n) | show a gallery of recently added new files (from Synchronize Files) |
-prev (or -p) | show the last file viewed in the previous session |
-blank (or -b) | show a blank window |
-lang lc_RC | language code (+ opt. region code) to use for GUI (de, de_AT, fr ...) |
-translate (or -t) | start in online translation mode (to capture the initial menus) |
-nosync (or -nos) | omit auto file sync at startup (dangerous - see note below) |
-menu "menu name" | startup menu function - Fotoxx will start with this menu active. |
CPU 123% | current Fotoxx CPU load for all threads and processor cores |
1234x987x8 | image width x height x depth (bits per color) |
0.45MB | image file size (updated when a modified image is saved) |
56% | zoom status, image % size |
edits: 3 | 3 edits have been made and can be reversed with the [undo] button |
menu locked | an edit function is active; other edit functions are blocked |
area active | a select area is present and enabled - edits are confined within the area |
dialog open | a dialog for user input is open and waiting |
/usr/bin/fotoxx | the executable program file |
/usr/share/fotoxx/data | user guides and other help files in multiple languages |
/usr/share/fotoxx/locales | translation.po files in multiple languages |
/usr/share/fotoxx/icons | icons used in menus and toolbars |
/usr/share/doc/fotoxx | change log, man page, README and other doc files in multiple languages |
/write_text/ | image text overlays saved from Transform > Write Text |
/collections/ | image collections from Tools > Manage Collections |
/favorites | saved data for user-configuration of favorites menu |
/locales | saved translation (.po) files, possibly user-modified |
/mashup |
saved mashup project files |
/saved_areas/ | "cutout" files saved from the Select > Save dialog |
/saved_curves | curve data saved from Retouch curve edit dialogs |
/geotags | downloaded geotag locations and world map image file |
/search_index4 | text files containing searchable data for all image files |
/thumbnails | thumbnail files (default location, user can change this) |
bookmarks | bookmark names and image file locations |
logfile | Fotoxx outputs that may be relevant for diagnosing problems |
parameters | setup parameters that are saved across Fotoxx sessions |
KB-shortcuts | user-defined or modified keyboard shortcuts |
printfile.png | the last file printed with Fotoxx |
recent_files | a list of the last 100 files opened by Fotoxx, saved when Fotoxx exits |
search_results | a list of the last image files found with Metadata > Search Images |
tags_defined | a list of all categories and tags currently used in all images |
top_directory | one or more top image directories used by fotoxx |
zdialog_inputs | saved dialog data for dialogs that recall prior inputs |
zdialog_positions | saved dialog window positions (relative to main window) |
Metadata section and name | Usage | Index |
IPTC:Keywords | tags entered by user | yes |
IPTC:Rating | "star" rating entered by user | yes |
EXIF:ImageSize | pixel width and height,
1234x2345 |
yes |
EXIF:DateTimeOriginal | date/time photo was made, or entered by user | yes |
EXIF:ImageHistory | history of image edits (used by Fotoxx and others) | no |
EXIF:UserComment | comment text entered by user | yes |
IPTC:Caption-Abstract | caption or abstract text entered by user | yes |
EXIF:FocalLengthIn35mmFormat | camera focal length used for photo, in 35mm equivalent | no |
EXIF:City, Country | city and country from camera GPS, or entered by user | yes |
EXIF:GPSLatitude, GPSLongitude | earth coordinates from camera GPS, or entered by user | yes |
Synchronize Files from initial status: 21K image files, no index, no thumbnails | 13.1 minutes |
Synchronize Files at startup: no new files and 21K old files | < 1 second |
Synchronize Files at startup: 101 new files among 21K old files | 3 seconds |
Search Images by date range: find 805 from 21K with a date in 2012 | < 1 second |
Search Images by file name: find 432 from 21K with "spitzbergen" in file name | < 1 second |
Search Images by tags: find 172 from 21K having both tags "alaska" and "scenery" | < 1 second |
Search Metadata: find 292 of 21K with date in 2012 and "DMC-TZ3" in EXIF: model | 5 seconds |
Find files by world map location: find 404 from 21K files by clicking map location "Dallas" | < 1 second |