Image view: the current image fills the entire window. |
Gallery view: current thumbnail gallery (directory or other image grouping). |
World Map view: images with
geotags are dots on the map, which can be clicked. |
Favorites |
User-designed
graphic menu for quick access to frequent functions |
File Menu | File Management |
Sync
Gallery |
Replace thumbnail gallery
from the directory of the current image file |
New Window | Clone Fotoxx and open a new window slightly offset from the old one |
Open Image File | File open dialog - open an image file to view or edit |
Open Previous File | Go back to the last image file opened |
Recently
Seen Images |
Gallery of the most recent image files viewed or edited |
Newest
Images |
Gallery
of the most recently added new image files |
Open RAW File | Open
a camera RAW file and edit
with UFraw or Raw Therapee |
Save
to Disk |
Save modified image to disk file |
Rename Image File | Rename
image files, optionally
add sequence numbers |
New Blank Image | Create a new blank image file |
Trash Image File | Move the current
image file into the trash folder |
Delete Image File |
Delete the current image
file forever |
Print Image File | Select
printer / paper format /
orientation and print image |
Quit Fotoxx | Exit from Fotoxx. |
Tools Menu | Utilities and setup functions. |
Index Image Files | Rebuild
the image search index
and refresh thumbnails |
User Settings | A
collection of user preferences
and settings |
Keyboard Shortcuts | Assign keyboard shortcut keys to menu functions |
Manage Collections | Make
named image collections,
arrange the sequence, etc. |
Slide Show | Show
a series of images full
screen (no menu) |
Batch
Convert |
Rename
/ convert
/ resize / move /
upright images |
Batch Upright |
Upright images that are
rotated 90° (camera turned) |
Batch
RAW |
Convert
RAW image files to jpeg,
png, or tiff |
Brightness
Distribution |
Show
brightness distribution
graph of current image |
Grid Lines | Add
or remove grid lines for
image alignment (warp, rotate) |
Line Color |
Set color for overlay
lines (trim rectangle, select area outlines ...) |
Show RGB | Show
RGB values at current mouse position and prior clicked positions |
Dark
/ Bright
Pixels |
Highlight
the darkest
and / or brightest pixels, with adjustable thresholds |
Find
Duplicate
Images |
Search all image files
and report duplicates |
Monitor Color | Display a color palette for tuning your monitor |
Monitor Gamma | Adjust
monitor gamma for better
image viewing |
Change Language | Change
the GUI language |
Missing Translations |
List
missing translations to a popup window |
Menu and Launcher | Add
a system menu entry and
desktop launcher |
Burn Images to CD / DVD | Select
images and write them to
CD, DVD or BlueRay |
Resources | Dump resource usage data to the log file |
Metadata Menu | View and edit metadata (data stored within image files) |
View Metadata (short) | View most important image metadata |
View Metadata (long) | View all available image metadata |
View Captions and Comments | View captions and comments only in a small popup window |
Show Captions on Images | Show metadata captions and comments at the top of images |
Tags Overview | Explanation
of tags and how they
are used |
Edit Metadata | Add
or change image date,
rating, caption, comments, or tags (keywords) |
Edit Any Metadata | Add or change any metadata |
Delete Metadata | Delete specific metadata or all image metadata |
Batch Add / Remove Tags | Add
or remove multiple tags for multiple image files |
Geotags Overview | General
Information |
Download Geolocations | Download city locations and a world map for use in geotag functions |
Edit Geotags | Add geotag data (city, latitude, longitude) to image EXIF data |
Batch Add Geotags | Add the same geotag data to multiple image files |
Images by Location / Date | Find
images from selected
country / city / date range |
Images by Map Location | Click on a world map to get images at or near the selected location |
Search Images | Find
images with any desired metadata or (partial) directory and file names |
Area Menu | Selected areas within images where edits are confined |
Overview | Explanation of area selection and editing |
Select | Select
an area for subsequent
editing |
Show / Hide | Show or hide an area outline |
Enable / Disable | Enable or disable an area for subsequent editing |
Invert | Invert an area |
Unselect | Unselect an area |
Area Color |
Change color of select
area outlines |
Copy / Paste | Copy an area to memory and paste it somewhere else |
Open / Save | Save an area to a file and load it later to use in other images |
Edit Menu | Functions
that change or improve an image |
Trim / Rotate | Trim / crop image edges and / or rotate an image to level it |
Rotate 90° | Turn an image 90° left or right, to upright the image |
Auto-Trim | Auto-select trim margins to remove after rotate, unbend, or warp functions |
Resize | Scale an image up or down (pixel dimensions) |
Flip | Mirror
an image horizontally or
vertically |
Add Text | Write
text on top of an image |
Add
Lines |
Add lines and arrows on
an image |
Voodoo Enhance | Automatic
image enhancement |
Retouch
Combo |
Edit
brightness, contrast,
color, saturation, white balance |
Tone Mapping | Increase
local contrast to to
enhance details |
Brightness Distribution |
Flatten
or expand the brightness
distribution |
Brightness Ramp | Vary
brightness across the image
using horizontal and vertical curves |
Paint Edits | Apply
an edit function gradually
by "painting" with the mouse |
Leverage Edits |
Apply edit functions regulated by initial brightness or color |
Repair Menu | Functions to correct problems in an image |
Sharpen | Sharpen
a blurred image |
Blur | Blur
an image (e.g. smoothen
skin) |
Reduce Noise | Reduce
noise (speckles) in
low-light images |
Smart Erase | Remove power lines and other spoilers from an image |
Red Eyes | Remove
red eyes from flash
photos |
Paint / Clone | Paint
pixels or areas with color
or with other parts of the image |
Remove Dust | Remove
dust spots on images made
from scanned slides |
Anti-alias
Tool |
Reduce
jagged lines or edges in
low-resolution images |
Fix Color Fringes | Reduce
chromatic aberration |
Fix Stuck Pixels | Fix
stuck pixels (always bright
or dark) from camera sensor defects |
Shift Colors | Shift
RGB colors relative to
each-other |
Color Mode | Make
a black-white or color
negative, or positive from negative, or sepia |
Color Profile | Convert
an image profile, e.g. sRGB <> Adobe RGB |
Match Colors | Match
the colors in one image to
those in another image |
Revise RGB | Make
complex color corrections
that vary over the image |
CMYK |
Change
brightness, color,
contrast using CMYK colors |
Bend Menu | Funtions that bend or warp an image |
Unbend | Fix
perspective problems |
Fix Perspective |
Straighten
a photo made from an
offset angle |
Warp area | Distort
image within an area by
pulling with the mouse |
Warp curved | Distort
entire image by pulling
with the mouse |
Warp linear | Distort
entire image by pulling
with the mouse |
Warp affine | Distort entire image by pulling with the mouse |
Flatten Book Page | Flatten / straighten a photographed page from a book |
Effects Menu | Functions that make artful transformations |
Color Depth | Reduce color depth (posterize) |
Sketch |
Transform
a photo into a pencil sketch |
Line Drawing |
Transform a photo into a
colored line drawing |
Color Drawing |
Transform a photo into a
solid color drawing |
Graduated
Blur |
Blur
pixels according to
contrast |
Embossing | Transform a photo into a simulated embossing |
Tiles | Transform a photo into tiles (pixelate image) |
Dots | Transform a photo into an array of dots |
Painting | Transform a photo into a simulated painting |
Vignette | Change
brightness or color in a
radial pattern |
Texture |
Add
textured surfaces to
an image |
Pattern |
Add a background pattern
to an image |
Mosaic |
Transform an image into a mosaic using tiles made from all images |
Custom Kernel |
Apply a custom
convolution kernel to an image |
Make Waves |
Warp an image with a wavy
pattern |
Combine Menu | Functions that combine multiple images |
High Dynamic Range | Make a high dynamic range image from multiple images |
High Depth of Field | Make a high depth of field image from multiple images |
Stack / Paint | Combine multiple images to remove tourists and cars |
Stack / Noise | Combine multiple images to reduce noise |
Panorama | Join 2-4 overlapping images horizontally |
Vertical Panorama | Join
2-4 overlapping images
vertically |
Mashup |
Arrange
multiple images
and text on a layout |
Plugins Menu | Use other image
edit
programs as edit functions in Fotoxx |
Help Menu | User guide,
translations,
change log |
Image View popup menu |
|
Copy to Location |
Copy the image file to
another location (duplicate the file) |
Move to Location |
Move the image file to
another location (delete the original) |
Copy to Clipboard |
Copy the image file to
the clipboard (some apps support clipboard paste) |
Gallery View popup menu |
|
Popup Image |
Open a window with a
large image - resizable, movable, persistent until canceled |
Popup Image (add) |
Same as above, but a new
window is opened instead of re-using the previous one |
Others |
The copy and move menus
(see above) are also available |
Image
View |
Fixed shortcuts |
left / right arrow keys | Previous / next image |
+ or = / - keys | Zoom image bigger / smaller |
F / G / W keys | Change view mode: image File, Gallery, World map |
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 (no menu) and back |
|
|
Gallery
View |
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 |
|
|
Default Shortcuts | These can be changed using Tools > Keyboard Shortcuts |
F1 function key | display user guide for current function |
N | Rename Image File |
K | Keyboard Shortcuts - edit |
Alt+G | Grid Lines on / off |
T | Trim / Rotate Image |
V | Voodoo Enhance |
R | Retouch Combo |
U | Undo |
Shift+U | Redo |
P |
Open Previous File |
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 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 | Determines the initial
window
content when
Fotoxx is started. Recent Files: the most recently viewed or edited image files (gallery display). Newest Files: image files most recently added to the Fotoxx database (gallery). Previous Gallery: the directory of the last image viewed (gallery). Previous Image: show the last image viewed. Blank Window: start with no current image and the top image directory in the gallery. Directory Gallery: the given top image directory or sub-subdirectory underneath. Image File: the given image file. |
Menu Style | The menu style: icons
only or both text and icons. |
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. |
JPEG quality | The default quality value when saving an image as a jpeg file type. |
Zooms
for 2x |
Choose 1, 2, or 3 zooms for each 2x increase in image size. |
RAW command | The command used to
convert
camera RAW files to tiff-16. This can be changed if you need. See the man page for dcraw for more details. |
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. |
Select Files |
Select files to convert
from a gallery window (link). |
New Name |
Optional new name with #
characters to be replaced with
sequence numbers. |
base, adder |
Starting sequence number
and adder for each output file. |
New
Location |
Optional new directory
location for the converted files. |
new
file type |
File type for converted
images, or "no change". |
max.
width, height |
Output images will fit
within these dimensions (ratio is not changed). |
delete
originals |
Delete the input files
after successful conversion. |
copy metadata |
Copy all EXIF and IPTC
metadata to the output files. |
upright |
If an image is rotated
90°, upright it (direction known from EXIF). |
sharpen |
Sharpen output images
using the two supplied parameters |
RGB | 0 | 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128 | 256 |
EV | nan | -7 | -6 | -5 | -4 | -3 | -2 | -1 | 0 | 1 |
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 Metadata function |
Caption-Abstract | Edit Metadata function |
Geotags | Edit Geotags function, 3 search image functions |
Image
History |
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 or drag along
the
edge of an
image object to draw lines that follow the edge. |
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. Selection is 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 selected 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 search range |
right click | undo previous selection, repeat to unselect more |
right drag | unselect pixels inside mouse circle and those with matching colors within search range |
amplifier |
increases or decreases
the effect of the brightness edit curves |
brightness |
moves the entire curve up
or down |
contrast |
moves the curve lower and
upper
parts in opposite directions |
low color / high |
increases or decreases
color saturation |
warmer / cooler |
adjusts color temperature
(reddish <--> blueish) |
dark
areas / bright |
apply color changes to
darker / all / brighter image areas |
brightness distribution |
show a brightness
distribution graph in the curve edit window |
click for white balance |
enables the mouse to
click
on a black point or gray / white point |
Settings File |
dialog settings can be
saved in a file and loaded later for use with other images |
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. |
Brightness | Increase or
decrease overall image brightness |
+Red
- Cyan etc. |
Increase or
decrease the brightness of one RGB color and change complimentary colors in the opposite direction |
Contrast |
Increase or
decrease the overall image contrast |
Red, etc. |
Increase or
decrease the contrast of individual RGB colors |
Method
and
Example |
Advantages |
Disadvantages |
Directory
and File Names e.g. image files like this: /images/2012/Rome-12.jpg |
simple and easy
to use fast implementation: batch move and rename files with added sequence numbers gallery overview at each level of hierarchy easy to navigate up / down hierarchy levels |
no overview of
available search terms long file names required for multiple search categories (date, place, persons, events ...) risk of inconsistent naming and chaos |
Captions and Comments e.g. caption or comment like this: 2012 Italy Rome Forum |
simple and easy
to use flexible search using multiple categories moderately fast implementation: think + write time, per image |
no overview of
available search terms may end up with thousands of categories risk of inconsistent naming and chaos |
Tags (EXIF Keywords) e.g. tags like this: italy, rome, forum, elizabeth |
flexible search
using multiple categories moderately fast implementation: think time + one click per tag, per image (or batch add tags to a group of images) good overview of available tags to click (organized by persons, places, events ...) easy addition of new tags |
requires careful
planning of tags slow to find and click tags if 200+ tags hard to revise tag naming system (batch tag add / delete / replace available) |
Geotags
e.g. location data like this: Rome Italy 41.89 N 12.48 E |
cameras with GPS
store data automatically add locations in a few seconds per image (or batch add location to many images) search location by clicking on a world map search location and date-range by clicking on a report of available locations / dates |
useful only for
searching by location chaotic location naming by cameras (revise using search and batch update) |
Named Collections e.g. collection names like this: best scenery Italy 2012 |
make ad hoc
collections using any criteria images can be in multiple collections or multiple times within one collection |
time to locate
and add images to collection (find and click gallery thumbnails) images not searchable by other categories not standards compliant |
image
files |
Fotoxx was tested
with 156K image files and performace was fine (see benchmarks, below). 500K image files should be practical on a strong computer, but startup time may be 20+ seconds. |
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 | 20,000 different
cities / locations for geotagged images (compile time constant). |
tags | There are limits listed in the topic Tags Overview. |
xdg-utils | open text or html files with user's preferred application |
exiftool | (v. 8.60 or later) 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 |
canberra |
play sounds for slide show |
xgamma | used for the Monitor Gamma function (adjust monitor gamma) |
g++ | GNU C++ compiler and C libraries |
libgtk3.0-dev | Gnome GTK3 / GDK3 / Pixbuf / etc. function libraries |
libtiff5-dev | tiff library development files |
libpng12-dev | png library development files |
liblcms2-dev | Little CMS development files |
-v | output release version and exit |
/.../imagefile.jpg | initial image directory or image file to open |
-recent (or -r) | show a gallery of recently seen image files, most recent at the top |
-new (or -n) | show a gallery of the
newest image files (from Index Image 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 ...) |
-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 |
Free 1234 MB |
total free memory,
including the file cache (can be allocated) |
2345x1234x8 |
image width x height x depth (bits per color) |
3.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 |
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/* | user guide,
translation.po files, icons, default data, etc. |
/usr/share/doc/fotoxx | change log, man page,
README and
other documentation files. |
/collections | image collections from
Manage Collections function |
/custom_kernel | saved custom kernel data files |
/favorites | saved data for user-configuration of favorites menu |
/geotags | downloaded geotag locations and world map image file |
/image_index | text files containing searchable data for all image files |
/locales | saved translation (.po) files, possibly user-modified |
/mashup | saved mashup project files |
/patterns |
saved background patterns |
/retouch_combo | saved settings for the Retouch Combo function |
/saved_areas | "cutout" files saved from the Select Area > Save dialog |
/saved_curves | curve data saved from Retouch curve edit dialogs |
/slideshows | user preferences from
Slide Show function |
/thumbnails | thumbnail files (default location, user can change this) |
/write_text | image text overlays saved
from Add Text function |
bookmarks | bookmark names and image file locations |
KB-shortcuts | user-defined or modified keyboard shortcuts |
latest_release | contains the current or latest Fotoxx release version |
logfile | Fotoxx outputs that may be relevant for diagnosing problems |
mosaic_tiles |
binary file, compressed
tiles from the Mosaic function |
newest files | a list of the 200 most recently added image files |
pagesetup | saves page setup data for print function |
parameters | setup parameters that are saved across Fotoxx sessions |
plugins | saves the plugins menu contents |
printsettings | saves print settings data for print function |
recent_files | a list of the last 100 files opened by Fotoxx, saved when Fotoxx exits |
search_results | list of the last image files found with Search Images |
stuck-pixels |
data saved from the Fix
Stuck Pixels functin |
tags_defined | a list of all categories and tags currently used in all images |
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, 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 |
Benchmark Description |
Image
Files |
Time |
First
initialization,
find and
index all image files |
156,240 |
99 min. |
Subsequent startup
with
no new image files |
0 new, 156,240 old |
7 sec. |
Subsequent
startup, 343 new files to index |
343 new, 155,897 old |
20 sec. |
Find all images
with tag "Rosi" |
5502 found |
1 sec. |
Find all images
with "Rosi" in file name |
2856 found |
1 sec. |
Find all images
dated Jan 1 - Feb 28, 2013 |
420 found |
1 sec. |
Same time period,
with city = "Freising" |
168 found |
1 sec. |
Same time period,
with EXIF "make" = "panasonic" |
126 found |
7 sec. (1) |
Click on world
map, France / Esterel |
105 found |
1 sec. |
List all locations
having images |
368 locations |
2 sec. |
Click on location
Germany / Augsburg |
231 found |
1 sec. |