Fotoxx User Guide v.17.01 | best
window size ==> |
General |
|
Fotoxx Overview | description, prerequisites, license, downloads, capabilities |
Fotoxx
Usage |
initialization, navigation, menus, general procedures |
Index of Menu
Functions |
menu functions organized alphabetically for
quick
lookup |
Recent Changes | recent functional and user guide changes |
File View
Menus |
menus visible in File View
mode |
Favorites
Menu |
a user-configurable popup
menu |
File Menu | open, save, rename, trash, delete, print |
File
Save
Menu |
save file as new version, new
file
name, or replace original |
Prev/Next
Button |
index to the previous or next
image file in current gallery |
Metadata Menu | edit tags, geotags, ratings, captions ... search images |
Area Menu | select image areas for separate editing, copy, paste ... |
Edit Menu | trim/crop, rotate, retouch, color, tone mapping, add text ... |
Repair Menu | sharpen, blur, denoise, red-eye, paint, clone ... |
Warp Menu | warp/warp, straighten, fix perspective, flatten book page |
Effects Menu | make drawing, painting, embossing, cartoon, add arty effects |
Combine Menu | HDR, HDF, stack, panorama, mashup (montage) |
Batch Menu | batch tools for file conversion, metadata updates, RAW import ... |
Tools Menu | image index, user settings, batch functions, utilities |
Help Menu | quick start, user guide, translations guide, change log ... |
Gallery View
Menus |
menus visible in Gallery View
mode |
Favorites Menu | a user-configurable popup menu |
Gallery Menu | sync, export, Flickr, directories, albums, slide show |
Bookmarks
Button |
jump to bookmarked gallery
position, edit bookmarks |
Gallery Zoom Buttons |
increase or decrease
thumbnail
size |
Gallery Sort Button |
sort gallery by file name or
date,
ascending or descending |
Gallery Scroll Buttons |
scroll up or down in pages,
got to
gallery top or end |
Batch
Menu |
batch tools for file
conversion,
metadata updates, RAW import ... |
Tools Menu | image index, user settings, batch functions, utilities |
Help Menu | duplicate of the help menu
listed
above |
Map View
Menus |
|
World
Map
Menus |
menus visible in World Map
View
mode |
Net Map Menus |
menus visible in Net Map View mode |
Other
Topics |
|
Organizing Images | optimize image organization for searching and viewing |
Translations |
instructions for translating
the
user interface and user manual |
Technical Notes | technical methods and limitations |
![]() |
Image File View (key F): the current image file fills the entire window |
![]() |
Gallery View (key G): thumbnail gallery (directory or other image grouping) |
![]() |
World Map View (key W): local maps with clickable markers to display corresponding images |
![]() |
Net Map View (key M): internet maps with clickable markers to display corresponding images |
![]() |
current view = image file view |
![]() |
change to gallery view |
![]() |
change to world map view |
![]() |
change to Net Map view |
![]() |
|
![]() |
favorites - custom popup menu |
![]() |
open, rename, print, delete, trash ... |
![]() |
save, save as new version or new file |
![]() |
open previous or next image file (left or right mouse click) |
![]() |
edit tags, captions, ratings, geotags ... search images |
![]() |
select areas for separate edit, copy, paste |
![]() |
trim, rotate, resize, brightness, color, contrast, add text ... |
![]() |
sharpen, denoise, red eyes, fix color, paint/clone |
![]() |
fix perspective, warp, warp image ... |
![]() |
special effects, arty transforms |
![]() |
HDR, HDF, stack, panorama, mashup (montage) |
![]() |
undo or redo edit steps (left or right mouse button) |
![]() |
batch utilities - move/convert images and RAW files |
![]() |
index images, user settings, edit KB shortcuts, magnify ... |
![]() |
help, user guide, change log, edit translations ... |
![]() |
change to image file view |
![]() |
current view = gallery view |
![]() |
change to world map view |
![]() |
change to Net Map view |
![]() |
|
![]() |
favorites - custom popup menu |
![]() |
sync gallery, export, Flickr upload, albums, slide
show |
![]() |
edit bookmarks, go to a bookmark |
![]() |
larger thumbnails |
![]() |
smaller thumbnails |
![]() |
sort gallery images by file name or date |
![]() |
go up to gallery top |
![]() |
go down to gallery end |
![]() |
go up one page |
![]() |
go down one page |
![]() |
slow motion gallery scroll |
![]() |
batch utilities - move/convert images and RAW files |
![]() |
index images, user settings, edit KB shortcuts, magnify ... |
![]() |
help, user guide, change log, edit translations ... |
![]() |
change to image file view |
![]() |
change to gallery view |
![]() |
current view = world map |
![]() |
change to Net Map view |
![]() |
|
![]() |
choose from available maps (Europe, USA, Germany ...) |
![]() |
set map markers, all images or current
gallery
only |
![]() |
change to image file view |
![]() |
change to gallery view |
![]() |
change to world map view |
![]() |
current view = Net Map |
![]() |
|
![]() |
choose internet map source |
![]() |
set map markers, all images or current gallery only |
File View popup
menu |
right click on current image in File View mode to get the following menu |
View
Metadata |
Show short form
metadata
report |
Edit
Metadata |
Edit key metadata
items:
photo date/time, rating, tags, captions, comments,
geotags |
Edit Any
Metadata |
Edit any metadata
item |
Rename |
Change the file
name |
Copy/Move to
Location |
Copy or move the image
file
to another location |
Copy to Desktop |
Copy the image file to the desktop
(monitor
background) |
Copy to Image
Cache |
Add the image file to
the
file cache for later pasting into an album |
Copy to
Clipboard |
Copy the image file to
the
clipboard (for other apps to paste) |
Upright |
Upright the image that
is
turned 90 degrees |
Trim/Rotate |
Trim (crop) the image,
level the image or turn 90 degrees |
Resize |
Resize (rescale) the
image
width and height |
Voodoo 1 and
Voodoo
2 |
Limited automatic
image
enhancement, two varieties |
Retouch
Combo |
Adjust brightness,
color,
contrast, saturation, black point, white balance |
Edit
Brightness |
Adjust the brightness
distribution (flatten, broaden, change black and white
points) |
Zonal
Flatten |
Enhance contrast and
brighten shadows, especially image areas with low
contrast |
Tone
Mapping |
Enhance contrast and
apparent brightness range by increasing brightness
gradients |
Select
Area |
Select an image object
or
area for separate editing |
Show on Net
Map |
Go to Net Map view,
zoom-in
to image location (if earth coordinates present) |
Delete/Trash
... |
Delete the image file
or
move it to the wastebasket |
Gallery View popup
menu |
right click on
thumbnail
image to get the following menu |
Popup
Image |
Show image in a larger
window - resizable, movable, persistent until
canceled. Zoom in/out using the mouse wheel. When zoomed small it disappears. Shift + left mouse click on a thumbnail: shortcut for Popup Image. |
View
Metadata |
Show short form metadata report |
Edit Metadata | Edit key metadata items: photo date/time, rating, tags, captions, comments, geotags |
Edit Any Metadata | Edit any metadata item |
Rename |
Change the file name |
Copy/Move to
Location |
Copy or move the image file to another location |
Copy to Desktop |
Copy the image file to the desktop (monitor background) |
Copy to Image
Cache |
Add the image file to the file cache for later pasting into an album |
Copy to
Clipboard |
Copy the image file to the clipboard (for other apps to paste) |
Upright | Upright the image that is turned 90 degrees |
Show on Net Map | Go to Net Map view, zoom-in to image location (if earth coordinates present) |
Delete/Trash | Delete the image file or move it to the wastebasket |
General |
|
F / G / W / M keys | Change view mode:
image
File, Gallery, World map, Net Map |
F1 function key | Display user guide for current or prior function |
F10 function key | Toggle main window to
full-screen and back. Menu and top panel remain. |
F11 function
key |
Same as F10, but
without
menu and top panel. Useful for image viewing. |
Image
File
View |
|
left / right arrow keys | Previous / next image
(link) |
+ or = / - keys | Zoom image bigger /
smaller
(zoom amount adjustable in User Settings) |
Z | Toggle: zoom image to 100% / fit image in window |
S |
Sync Gallery: set
gallery
from current image file |
X | Magnify Image |
P | Open Previous File (or
toggle between last two files) |
U | Undo current edit, or undo one edit step in the current image |
Shift+U | Redo current edit, or redo one edit step in the current image |
N | Rename Image File |
K | View and edit keyboard
shortcuts |
Alt+G | Grid Lines on / off
(toggle) |
T | Trim/Rotate Image |
R | Retouch Combo |
Escape key | Exit a dialog, exit
Slide
Show mode |
Space Bar | Pause / resume a
running
slide show |
Gallery
View |
|
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 |
H |
toggle the display of
hidden files and directories |
Image File View |
|
left click | Zoom-in: magnify image, center at click position |
right click | If image is zoomed: restore to window size. If not, popup menu with common functions. |
mouse wheel | Zoom image in or out depending on wheel direction |
left drag on image | Pan / scroll zoomed image, same direction or magnified opposite direction (like scroll bars) |
mouse + Ctrl
key |
Mouse acts on main
window
instead of an active dialog, e.g. Select Area. |
Gallery View |
|
left click
thumbnail |
Change to F-view, show
full-size image |
right click
thumbnail |
Show popup menu with
common
functions |
middle click
thumbnail |
Pop up a larger image
which
can be zoomed in or out using the mouse wheel |
scroll mouse
wheel |
Scroll the gallery
page up
or down |
World Map View |
|
left
click |
If map zoomed small to
fit
window, zoom map large at clicked location |
right
click |
Zoom map small to fit
window |
left
drag |
If map is zoomed
large,
drag map with the mouse |
left click on
marker |
Change to Gallery
View,
show all images with geotags at corresponding
location |
mouse
wheel |
Can be used for
zooming as
described above |
Net Map View |
|
mouse
wheel |
Zoom the map in (2x)
or out
(0.5x) |
left click on
marker |
Change to Gallery View, show all images with geotags at corresponding location |
left
drag |
Drag map with the
mouse |
file or
directory
path |
initial image file or directory (gallery) to open | |
-album "album
name" |
-a |
initial album
(gallery) to
open |
-ver | -v |
output release version and exit |
-recent |
-r |
show a gallery of recently seen image files, most recent at the top |
-new |
-n |
show a gallery of the
newest image files (from Index Image Files) |
-prev | -p |
show the last file viewed in the previous session |
-blank |
-b |
show a blank window |
-lang
lc_RC |
-l |
language code (+ opt. region code) to use for GUI (de, de_AT) |
-menu "func name" | -m |
startup menu function - Fotoxx will start with this function active. |
-index
N |
disable image indexing
for
faster startup (see below) |
|
-home
/.../fotoxx_home |
use an alternate
location
for user data (instead of
/home/<user>/.fotoxx) |
|
-cycledesktop
... |
use Fotoxx to rotate
desktop background image (see cycle
desktop) |
CPU 123% | current Fotoxx CPU load for all threads and processor cores |
2345x1234x8 |
image width x height x depth (bits per color) |
3.45M | 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 |
blocked |
some menu functions
are
blocked until the current function is completed |
area active | a select area is present and enabled - edits are confined within the area |
dialog open | a dialog is waiting
for
user input (if not visible, look behind other
windows) |
busy [::::
] |
some long running
functions
show this simple progress bar |
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 an icon is used, its size can be 24x24 to 64x64 pixels |
close window | checkbox: option to 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 |
112 MB | 38 MB | 78 MB | 21 MB | 8 MB | 2 MB | 1 MB | 0.7 MB |
Key Name | Fotoxx
data
input method |
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
-
comments |
Caption-Abstract | Edit
Metadata
function - caption |
Geotags | Edit Metadata function
-
location, geocoordinates |
Image
History |
Fotoxx edit functions
add
to this list |
any key | Edit Any Metadata, Delete Metadata |
Summary: + Enter (or change) a location name (possibly abbreviated) in the dialog. + Use [Find] to find the location and auto-fill country, latitude, longitude. + If there are multiple matches, choose from the list. + If there are too many matches, add more letters or supply the country and try again. + If there are zero matches (not found), try the [Web] button (country is required). + If still not found, add more letters to the location. + If still not found, use one of the above web services and input the data manually. + Use [apply] to update the image file and make the location available for future use. + If there are multiple geocoordinates for a given location and country, click on a map marker to select, or click elsewhere to add a new geocoordinate for this location. |
match method |
match value(s) |
matches |
one or more metadata
text
values to be selected, separated by commas |
contains |
as above, but any
metadata
containing these text values will be selected |
number = |
a single numeric value
-
equal metadata values will be selected |
number
=> |
a single numeric value
-
equal or greater metadata values will be selected |
number
<= |
a single numeric value
-
less or equal metadata values will be selected |
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. |
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". |
Controls for
mouse selection methods |
"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. |
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 |
Clear |
Clear the text and
metadata
fields to blank. |
Replace |
Image with added text
replaces (overwrites) the current image file |
+Version |
Image with added text
is
saved as a new file version |
Next |
Open the next
sequential
image file and place the same text at the same
position. |
Apply |
Complete the edit and
start
over. A new text string can now be added to the
image. |
Done |
Complete the edit and
exit
the dialog. The edited image file must be explicitly
saved. |
Cancel |
Abandon the edit.
Previous
use of [Apply] is not reversed. |
Menu Name |
command line |
Gimp |
gimp
%s |
auto-gamma |
mogrify
-auto-gamma
%s |
Gthumb |
gthumb
%s |
Flatten |
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 | Pixels are set to the median value of their neighbors within a radius. |
Top Hat | Detect outliers by
comparison with surrounding pixels at a distance. The distance is increased in steps from 1 pixel to the radius limit. Outlyers are flattened slightly. |
Wavelets | RGB brightness (with
noise)
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 color and change complimentary color in the opposite direction |
Contrast |
Increase or
decrease
the overall image contrast |
Red,
etc. |
Increase or
decrease
the contrast of individual RGB colors |
Select
Files |
Select files to
convert
from a gallery window (link). |
New Name |
Optional new name with
optional inserted text (photo date, sequence
number) |
Sequence
Numbers |
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
degrees, upright it (if status known from EXIF). |
sharpen |
Sharpen output images
using
the two supplied parameters |
Overlay
Image |
Add an overlay image
at a
selected position in the output images. See below. |
Make constant
size |
Make the visual
overlay
size independent of image dimensions. See Below |
$oldname |
The original file name
is
inserted here |
$s... |
A running sequence
number
is inserted here. See below. |
$yyyy $mm
$dd |
The photo date (year,
month, day) is inserted at these positions |
Retouch Combo | Brightness/Contrast/Color adjustments |
Adjust Brightness Dist. | Reshape the brightness distribution |
Zonal Flatten | Enhance dark areas with low contrast |
Tone Mapping | Enhance local contrast where weak |
Resize | Specify width/height or ratio (e.g. 1/2) |
Voodoo1 | Automatic enhance |
Voodoo2 | Automatic enhance |
Sharpen |
Sharpen fuzzy
edges |
Blur | Blur image |
Denoise |
Reduce image
noise |
Shift Colors | Tune colors |
Adjust RGB/CMY | Tune colors |
Brightness
Gradient |
Add a brightness/color gradient across the image |
Color Mode | Change B&W/color or positive/negative |
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 image directory. Image File: the given image file. |
Browse |
Opens a dialog to
browse
for the starting directory or image file (last 2 options
above). |
Menu Style | The menu style: icons
only
or both text and icons. |
Window background |
The background color
for
the main window containint the current image. This is the color outside image margins when image width and height do not fit the window. |
Dialog
font |
The font name and size
to
use in all menus and dialogs (Bold, Italic, etc. are
ignored). |
Image Pan/Scroll (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. |
Zooms for 2x |
Choose 1, 2, or 3 zooms for each 2x increase in image size. |
JPEG quality | The default quality value when saving an image as a jpeg file type. |
Thumbnail
size |
The pixel size for
gallery
thumbnail width/height: 128 | 256 | 512 (default 256). 512
is a bit
slower but better for a large monitor or one with a high
DPI
resolution, or when viewing large galleries. If this is
changed,
you need to delete your thumbnail files so that the file
index
process will rebuild them with the new size (next Fotoxx
startup). |
Curve node capture distance |
The minimum node
separation
for edit curves. Also the mouse capture threshold when a
node is
clicked or dragged. The default is 5% of scale, allowing
up to 20
nodes in a curve. If you use a touchpad instead of a
mouse, set
this value higher to compensate for lower positioning
accuracy.
Flexibility for extreme curve bending will be
less. |
Map marker
size |
The size of the
markers
(red dots) marking image locations on maps. |
last file version |
Show only the last
version
of image files, for both file view and gallery view (if a
directory). |
shift image
right |
If the window is wider
than
the image, shift the image right to maximize left margin
for
dialogs. |
image index
level (2 parameters) |
0 / 1 / 2 = no image
index
/ old index only / old + updates for new image files See below for a complete explanation. |
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 |
![]() ![]() |
Manage Albums Dialog![]() New: Start a new album or replace an existing one. The dialog shown immediately below is started. Choose: Choose an album to view or edit. The gallery window will show the album current images. Use the thumbnail popup menu (below) to add or remove images. Add: Add images to the image cache using the standard dialog for selecting images from gallery windows (link). Select image files in any order from any gallery. Selected images are added to the image cache. Add cached images to the album using the popup menu (below). Remove: The standard dialog for selecting images is started. Choose images from the current album gallery to be removed. The images are left in the image cache in case you want to insert them into another gallery or a different place in the same gallery. Clear: Discard all images in the image cache. Delete: Select an album to delete. Image files are not deleted. New Album dialog ![]() Specify an album name, or use the [browse] button to select an existing album to be replaced. Select one of the three options. Option 1 creates the album with no images. Option 2 fills the album from cached images, if any. Option 3 creates the album from the current gallery. This may be a directory, the output of an image search, or an album. |
Copy to Image
Cache |
Add the clicked image to the image cache. |
Cut to Image
Cache |
Remove the image from the album and add it to the image cache. |
Copy to
Clipboard |
Copy the image to the
clipboard (for other apps to paste). |
Paste
Image
Cache Here (keep) |
Insert all cached images at the clicked position. Click roughly between two thumbnails where the images will be inserted. |
Paste
Image
Cache Here (clear) |
Same as above, but the
cache is cleared. |
Paste Current Image
File
Here |
Inserts the current image file at the clicked position. |
Remove from
Album |
Remove the clicked image from the album |
Popup
Image |
Pop-up a large
resizeable
window for the image. Replace previous popup
window. |
View
Metadata |
Metadata short report
for
clicked image file. |
![]() ![]() |
Zoom-in / zoom-out.
Increase or
decreast the gallery thumbnail size. If decreased to zero, the gallery becomes a simple list of file names. |
![]() |
Sort the gallery thumbnails in an alternative sequence. You can sort by file name (default), Photo date/time (from EXIF data), or file modification date/time (file creation or last modification date/time). The sequence may be ascending or descending. |
![]() ![]() |
Jump to the beginning
or
end of the gallery. |
![]() ![]() |
Scroll back (up) or
forward
(down) by one gallery page. |
![]() |
Slow scroll the
gallery.
Can be used to visually scan for a desired image file. Press the button again to stop the scroll, or press any other button. |
Hamburg.jpg, 53.455, 53.553,
9.906,
10.067 Houston.jpg, 29.479, 30.053, -95.786, -94.905 |
dialog
input: |
top |
bottom |
left |
right |
adjusted
margin: |
right |
left |
top |
bottom |
image
files |
Fotoxx has been tested
with
500K image files and the performace was good. See
Benchmarks
below. |
image size | The max. supported
image
width or height is 20,000 pixels (compile time constant). The maximum image size is 4 GB (about 240 megapixels). Images edited in memory have 4 float numbers (16 bytes) per pixel (RGB + alpha). |
image edits | 99 edits for undo / redo and file version numbering (filename.v01 to filename.v99). |
image
tags |
10,000 tags, 200,000
chars.
for all tags, 1000 chars. for one image (compile time
constants). |
thumbnail cache |
Thumbnail images are
cached
in main memory to improve gallery performance. Gallery
scrolling is
slower for the initial pass, and faster thereafter.
Revisited
galleries are fast unless the cached thumbnails have been
replaced. |
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 |
libchamplain-gtk |
Gnome geographic
mapping
functions |
xdg-utils | req. |
open text or html files with user's preferred application |
exiftool | req. |
(v. 8.60 or later)
read and
write image metadata (tags, comments, etc.) |
Raw
Therapee |
opt. |
open a RAW file for
editing
using its native GUI |
growisofs | opt. | burn a CD or DVD with selected images |
xgamma | opt. |
used for the Monitor Gamma function (adjust monitor gamma) |
fotoxx-maps |
opt. |
set of geographic maps
to
show image locations and report images by mouse
click |
hugin |
opt. | PT Panorama function
uses
Panorama Tools (normally packaged with Hugin) |
/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. |
/usr/share/fotoxx-maps/* |
geographic maps data
files
(112 MB) |
/usr/share/doc/fotoxx-maps/* |
change log, man page,
README |
/albums | image albums from
Manage
Albums function |
/custom_kernel | saved custom kernel data files |
/edit_scripts |
saved edit script
files
(for batch editing) |
/favorites | saved data for user-configuration of favorites menu |
/image_index | top directories,
thumbnail
directory, image index file |
/mashup | saved mashup project files |
/patterns |
saved background
patterns |
/printer_color |
saved printer color
calibration files |
/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 |
/slideshow_trans |
saved slide show
transition
parameters |
/thumbnails | thumbnail files (default location, user can change this) |
/user_maps |
custom map files made
by
the user |
/write_text | image text overlays
saved
from Add Text function |
bookmarks | bookmark names and image file locations |
burnlist |
list of image files to
write on DVD/BlueRay disc |
KB-shortcuts | user-defined or modified keyboard shortcuts |
logfile | Fotoxx outputs that may be relevant for diagnosing problems |
metadata_report |
Batch Report Metadata
output report - tabular text file |
metadata_report_items |
list of metadata items
reported by Batch Report Metadata |
metadata_short_list |
metadata key names for
Batch Add / Change Metadata |
metadata_view_extra |
extra items for the
metadata short report, added by the user |
mosaic_tiles |
binary file,
compressed
tiles from the Mosaic function |
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 function |
tags_defined | a list of all categories and tags currently used in all images |
zappcrash |
if Fotoxx crashes, a
traceback dump is deposited here |
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 | Indexed |
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 edits
made
by Fotoxx |
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/location and country from camera GPS, or entered by user | yes |
EXIF GPSLatitude, GPSLongitude | earth coordinates from camera GPS, or entered by user | yes |
EXIF
RollAngle |
camera tilt
angle -
can be used to auto-level an image |
no |
Image Index Speed (find
new
image files, update image index and thumbnails) |
Rate |
Image index
speed
using a 5400 rpm disk |
2360 /
min. |
Image index
speed
using a solid-state disk (SSD) |
2906 /
min. |
Image Search Speed (find image files
based
on metadata select criteria) |
Rate |
search for indexed metadata (see
list
above) |
>100K / sec. |
search for non-indexed metadata
using
a 5400 rpm disk |
4508 / min. |
search for non-indexed metadata
using
a solid-state disk (SSD) |
10654 / min. |
Disk
Type |
Index Level(*) |
initial
startup after reboot |
subsequent startup |
5400
rpm |
2 |
25
sec. |
4.8
sec. |
5400
rpm |
1 |
2.5 |
2.0 |
5400
rpm |
0 |
1.3 |
1.3 |
SSD |
2 |
6.9 |
4.7 |
SSD |
1 |
2.0 |
1.8 |
SSD |
0 |
1.1 |
1.1 |
Add Lines / Arrows to Image | add lines or arrows, position with mouse, set
thickness, color, other styles |
Add Text to Image | add text, position with mouse, set font,
color,
transparency, other styles |
Add Transparency | convert a color or brightness level into
transparency level |
Adjust HSL | replace a color tone with another, based on
HSL
color model |
Adjust RGB / CMY | adjust color levels based on RGB color
model |
All Directories |
show all image directories at all levels,
click
any for gallery view |
Anti-Alias | remove pixelated edges from low-resolution
images |
Area Copy and Paste | select image area, copy and paste across
images,
load and save to file |
Area Enable / Disable | toggle between area editing and whole image
editing |
Area Invert | exchange inside area <--> outside
area |
Area Open and Save | save area to a file, open and re-use (paste
into
an image) |
Area Show / Hide | show or hide area outline during image
editing |
Area Unselect | permanently remove a selected area |
Batch Add / Change Metadata | add or revise metadata items for selected
images |
Batch Geotags | add or revise location name and coordinates
for
selected images |
Batch Add / Remove Tags | add or remove multiple tags (keywords) for
selected images |
Batch Convert Files | convert size, file type, name, location ...
for
selected images |
Batch Delete / Trash | delete or trash selected images |
Batch RAW | process selected RAW images, save as editable
files in 8 or 16 bit color |
Batch Raw Therapee | same as above, using the Raw Therapee image
converter |
Batch Rename Tags | rename multiple tags (keywords) for selected
images |
Batch Report Metadata | output metadata text file for selected
metadata
items and images |
Batch Upright | find rotated images and upright them |
Blend Image |
blend image pixels in areas painted with the
mouse |
Blur Background (Bokeh) | select image areas to remain sharp and blur
the
rest |
Blur Image | blur an entire image or selected area |
Bookmarks | add bookmarks to image collection, go to
bookmarked location |
Brightness Distribution Graph | show a brightness histogram, for all colors
or
each RGB color |
Brightness Gradient | add a brightness/color gradient to an image (fix uneven lighting or color) |
Burn Images to DVD / BlueRay | burn selected image files to DVD or Blue Ray
disc |
Cartoon | convert an image into a cartoon |
Change Language | change the user interface language |
Choose Map | choose a local map file (world, continent,
country, city) |
Color Depth | set color depth from 1 to 16 bits per RGB
color |
Color Drawing | convert an image into a simulated color
drawing |
Color Mode | change between black/white and color,
positive or
negative |
Color Profile | change color profile (e.g. sRGB <-->
Adobe
RGB) |
Color Saturation | adjust the color saturation of an image |
Copy / Move Image File | copy or move an image file to another
location |
Copy to Desktop | copy an image file to the desktop |
Cycle Desktop Wallpaper | change the monitor background image
periodically
or at bootup |
Dark / Bright Pixels | highlight pixels outside a selected
brightness
range |
Delete Metadata | delete selected metadata items or all
metadata |
Delete / Trash Image File | delete an image file or move it to the trash
bin |
Denoise Image | reduce noise in a photo made under low light
conditions |
Directed Blur | blur the image in one direction
(perpendicular
direction remains sharp) |
Dots | convert an image into a dot matrix (Roy
Lichtenstein effect) |
Edit Any Metadata | edit any metadata item |
Edit Brightness Distribution | edit the brightness distribution directly
(shift
pixel brightness levels) |
Edit Metadata | edit main metadata items (date/time, tags,
rating,
location, caption) |
Embossing | add a 3D relief effect to an image |
Export File List | export a text file list of selected images
(for
external program feed) |
Favorites | graphic popup menu with user-selected
functions,
icons, and layout |
Find Area Gap | show where there is a gap in a Select Area
hand-drawn outline |
Find Duplicate Images | find duplicate images within the entire image
collection |
Fix Perspective | correct the perspective of a photo made at an
angle |
Flatten Book Page | flatten a photo of a curvy page from a thick
book |
Flip Image | invert an image left-right or top-bottom |
Graduated Blur | preserve high-contrast pixels and blur the
rest,
scaled by contrast |
Grid Lines | set grid lines on or off, or change
horizontal and
vertical counts |
High Depth of Field (HDF) | combine near- and far-focus photos for
extended
focus depth |
High Dynamic Range (HDR) | combine low- and high-brightness photos for
extended brightness range |
Image Locations Report | list image locations and date groups, click
on
list for gallery of images |
Images by Map Location | click on a map marker for a gallery of images
at
that location |
Image Timeline Report | list image counts by year and month, click on
list
for gallery of images |
Index Image Files | installation utility - find all image files
and
make an index for fast searching |
Keyboard Shortcuts | show keyboard shortcuts and define custom
shortcuts |
Leverage Edits | regulate the intensity of an edit function
using
brightness, contrast, or color |
Line Color | change the color used for image lines (area
outlines, mouse "paintbrush") |
Local Color | adjust colors in multiple image areas with adjustable blending |
Make Waves | image wave warp, vary intensity, wavelength,
randomness |
Manage Albums | create and arrange arbitrary ordered views of
images without duplications |
Manage Tags | create tags (keywords) and categories, for
managed
image tagging |
Mashup | photomontage - combine images and text in an
arbitrary layout |
Match Colors | match colors in one image to the colors in
another
image |
Missing Translations | list the missing translations for a given
language |
Monitor Color | show a color pattern on the monitor for
adjusting
brightness and contrast |
Monitor Gamma | show a special image on the monitor for
adjusting
gamma |
Mosaic | convert an image into a mosaic of image tiles
which can be clicked to view |
New Blank Image | create a blank image with a desired color
(background for later use) |
Newest Images | show the newest images based on photo date or
file
date |
New Window | create a parallel Fotoxx window |
Open Image File | standard file open dialog to select an image
file
to view or edit |
Open Previous File | show the previous file - instant toggle
between
any two files |
Open RAW File | open a RAW file to view or edit (tiff file
with 16
bits per RGB color) |
Organizing for Searching | how image organization, naming, and metadata
affects search capability |
Net Map | world map at any scale, retrieved as needed
from
the internet |
Net Map Source | select optional source for internet map |
Paint / Clone | paint on an image with the mouse, using a
color or
other image area |
Paint Edits | "paint" an edit function locally and
gradually
with the mouse |
Paint Transparency | "paint" image transparency locally and
gradually
with the mouse |
Panorama Image | combine 2-4 images into a wide panorama with
automatic edge fitting |
Pattern | tile the image with a repeating pattern, vary
contrast and transparency |
Pencil Sketch | convert an image into a simulated pencil
sketch |
Plugins | add a menu for an external plugin function,
or
call the function |
Previous / Next Image | go to the previous or next image in the
current
gallery |
Print Calibrated Image | print an image using a predefined printer
color
profile |
Printer Color Calibration | compute a calibrated color profile for a
printer |
Print Image File | print an image with custom margins and
scaling |
PT Panorama | combine images into a panorama using the
Panorama
Tools program |
Recent Images | show the most recent images viewed or
edited |
Red Eyes | remove red eyes from photos made with flash
lighting |
Remove Dust | remove dust spots from scanned slides or
archaic
images |
Rename Image File | file rename function, easy to use for a
series of
images |
Replace Album File | substitute one file for another in selected
or all
albums |
Resize Image | change the image scale with presets for 3/4,
2/3,
1/2, 1/3, 1/4 |
Resources | report memory usage to log file (leak
detector) |
Retouch Combo | edit brightness, contrast, color, color
temperature, white balance ... |
Save to Disk | save modified image to same file, to new
version
or to new file |
Script Files | record a series of edits with one file, then
execute on many files |
Search Images Report | find images based on date, rating, tags,
caption
text, location/file name ... |
Select Area | select image area(s) to be edited separately
from
background |
Select Hairy | special tool to select a ragged or hairy area
with
speed and precision |
Selective Rescale | shrink an image while leaving a selected area
unchanged |
Set Desktop Wallpaper | set the desktop background image from the
current
image |
Set Map
Markers |
set the map markers to show all images or
only the
current gallery |
Sharpen Image | sharpen fuzzy edges within an image |
Shift Colors | shift image RGB colors with a sliding scale:
GBR
<-- RGB --> BRG |
Show Captions | toggle display of captions and comments in
upper
left image corner |
Show RGB | show RGB values at selected image locations,
also
during edits |
Slide Show | show album images in sequence with animated
transitions and pan/zoom |
Smart Erase | replace power lines, signs, ground litter,
etc.
with neighborhood pixels |
Spherical Projection | project an image into a sphere, variable size
and
flatness |
Stack / Noise | combine multiple high ISO noisy photos to
make one
with reduced noise |
Stack / Paint | combine photos taken at different moments to eliminate transient objects |
Stuck Pixels | find and map stuck pixels, use map to heal
photos
from the same camera |
Sync Gallery | set the gallery to the directory of the
current
image file |
Texture | add texture to an image by amplification of
existing brightness variation |
Tiles | convert an image into tiles with variable 3D
effect |
Tone Mapping | amplify low contrast details without changing
overall contrast |
Trim (crop) and Rotate |
combination function to level a tilted image
and
trim margins |
Unbend Images | fix perspective for a curved wide-angle
image,
especially panoramas |
Undo / Redo Button | step forward or backward through image edit
stages, or go to any stage |
Unwarp Closeup | remove distortion from close-up face photos
(balloon face, big nose) |
Update Albums | auto update albums to latest file
versions |
Upload to Flickr | upload selected image files to the Flickr
internet
photo service |
Upright Image | rotate image -90 or +90 degrees (automatic if
EXIF
orientation available) |
User Settings | dialog for user settable options |
Vertical Panorama | combine 2-4 images into a vertical panorama
with
automatic edge fitting |
Vignette | fix camera vignette (dark corners) or design
a
vignette with any shape |
View Metadata | brief report of most significant metadata, or
full
report of everything |
Voodo 1 and Voodo 2 | automatic image enhancement (1-click) that
often
works well enough |
Warp Affine | warp image with affine transformation
(parallel
lines remain parallel) |
Warp Area | warp within a Select Area by dragging the
image
with the mouse |
Warp Curved | warp image by mouse dragging, with range from
1-100% of image size |
Warp Linear | warp image by dragging one corner - straight
lines
remain straight |
World Map | select from locally stored map files: world,
continents, countries |
Zonal Flatten | bring details out of shadows and other
low-contrast areas |