Fotoxx User Guide v.17.04 | best window size ==> |
General |
|
Fotoxx Overview | description, prerequisites, license, downloads, capabilities |
Fotoxx Usage |
initialization, navigation, menus, general procedures |
Index of All Functions |
menu functions organized
alphabetically for quick lookup |
Index of Edit Functions |
edit functions organized by
parent menu name |
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, straighten, fix perspective, flatten book page |
Effects Menu | make drawing, painting, embossing, cartoon, add arty effects |
Undo/Redo Button |
undo or redo edits of the
current image |
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 |
Combine Menu | HDR, HDF, stack, panorama, montage, mashup |
Process Menu |
batch tools
for file conversion, metadata updates, RAW import
... |
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 |
![]() |
undo or redo edit steps (left or right mouse button) |
![]() |
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 |
![]() |
combine images: HDR, HDF, stack, panorama, montage, mashup |
![]() |
process - batch move / convert / modify
files, search functions |
![]() |
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) |
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. Outliers 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 |
Startup Display | Determines the initial display 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. Directory Gallery: the given image directory. Album: the given album name (album file). Image File: the given image file. Blank Window: start with no current image and the top image directory in the gallery. |
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. |
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 |
Flip
Image |
Flip or mirror image
horizontally or vertically |
Sharpen |
Sharpen fuzzy edges |
Blur | Blur
image |
Denoise |
Reduce image noise |
Color
Mode |
Make image B&W or
color, positive or negative, or sepia |
Shift Colors | Tune
colors using a slider |
Color
Saturation |
Change color
saturation (intensity) |
Adjust RGB/CMY | Tune
colors using RGB or CMY sliders |
Color
Profile |
Change the color
profile, e.g. Adobe RGB <-> sRGB |
Color
Depth |
Reduce the color
depth (bits/color) for "poster" effect |
Pencil
Sketch |
Convert image to
simulated pencil sketch |
Cartoon |
Convert image to a
cartoon |
Line
Drawing |
Convert image to a
color line drawing |
Color
Drawing |
Convert image to a
color drawing |
Graduated
Blur |
"Soften" the image
while retaining details |
Embossing |
Add a 3D relief
effect to an image |
Tiles |
Convert an image to
tiles |
Dots |
Convert an image to
dots (Roy Lichtenstein effect) |
Painting |
Convert image to a
simulated painting |
Texture |
Add texture to an
image (e.g. image on a rug) |
Pattern |
Add a pattern to an
image (e.g. image on a brick wall) |
Custom
Kernel |
Apply a custom
convolution kernel to the image |
Alien
Colors |
Add strange coloring
to an image |
Hamburg.jpg, 53.455,
53.553, 9.906, 10.067 Houston.jpg, 29.479, 30.053, -95.786, -94.905 |
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.) |
leafpad |
req. |
used for display of
backtrace dump after a fatal error (see zappcrash
below) |
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 |
Edit
Menu |
|
Trim/Rotate |
Trim unwanted margins,
rotate or level an image |
Upright |
Upright an image rotated 90°
or 180° |
Voodoo1 |
Automatic 1-click
enhancement that may work |
Voodoo2 |
Automatic 1-click
enhancement that may work |
Retouch Combo |
Edit brightness, contrast,
color, saturation |
Edit Brightness |
Edit brightness
distribution, rebalance dark and bright areas |
Zonal Flatten |
Increase local contrast to
enhance details, brighten dark areas |
Tone
Mapping |
Increase local contrast to
enhance details |
Resize Image |
Change the image pixel
dimensions |
Flip
Image |
Mirror an image horizontally
or vertically |
Add
Text |
Write text on an image with
special effects |
Add
Lines |
Add lines and arrows to an
image |
Paint
Edits |
Paint a retouch function
gradually, using the mouse |
Leverage Edits |
Apply a retouch function
using brightness or color as a regulator |
Plugins |
Use another image edit
application as a Fotoxx edit function |
Repair
Menu |
|
Sharpen | Sharpen a blurred
image |
Blur |
Blur an image or image
area |
Denoise |
Reduce noise (speckles) in
low-light images |
Smart
Erase |
Remove power lines, trash,
other small image spoilers |
Red
Eyes |
Remove red eyes from flash
photos |
Paint
Image |
Mouse-paint with a color,
brush size, and opacity |
Clone
Image |
Mouse-paint a copy of one
image area over another |
Blend
Image |
Blend or blur image pixels
by painting with the mouse |
Paint Transparency |
Paint increasing
transparency using the mouse |
Add Transparency |
Add transparency based on
image brightness or color |
Color
Mode |
Convert to black &
white, color, negative, positive, sepia ... |
Shift Colors |
Gradually shift RGB colors
to GBR or BRG |
Color Saturation |
Increase or reduce color
saturation (intensity) |
Adjust RGB/CMY |
Adjust image colors using
RGB or CMY adjustments |
Adjust
HSL |
Use HSL to select and change
image colors |
Brightness Gradient |
Add a brightness/color
gradient across an image |
Local
Color |
Fix a false color caste that
varies within an image |
Match Colors |
Match the colors in one
image to those in another image |
Color Profile |
Convert color profile (e.g.
sRGB <--> Adobe RGB) |
Remove Dust |
Remove dust spots on images
scanned from old slides |
Anti-Alias |
Remove pixelation (jaggies)
in low resolution image |
Color Fringes |
Reduce chromatic aberation
causing color fringes |
Stuck Pixels |
Fix bright/dark 'stuck'
pixels from camera sensor defects |
Warp
Menu |
|
Unbend |
Fix images having curved
lines that should be straight |
Fix Perspective |
Straighten an object
photographed from below or aside |
Warp
area |
Warp a selected image area
by pulling with the mouse |
Unwarp closeup |
Reverse distortions of a
close-up face photo (e.g. big nose) |
Warp
curved |
Warp an entire image or a
limited area using the mouse - curvy warp |
Warp
linear |
Warp image by pulling with
the mouse - straight lines preserved |
Warp
affine |
Warp entire image by pulling
with the mouse - parallel lines preserved |
Flatten Book Page |
Flatten and straighten a
photographed book page |
Spherical
Projection |
Curve and image into a
sphereoid shape |
Selective Rescale |
Rescale image down, leaving
selected areas unchanged |
Make
Waves |
Warp an image with a wave
pattern |
Twist
Image |
Twist an image around a
chosen center point |
Effects
Menu |
|
Color
Depth |
Reduce the number of colors
(posterize) |
Sketch |
Convert a photo into a
simulated pencil sketch |
Cartoon |
Convert a photo to a
cartoon-like drawing |
Line
Drawing |
Convert a photo to a
simulated line drawing |
Color Drawing |
Convert a photo to a
simulated color drawing |
Graduated Blur |
Graduated image blur
depending on contrast |
Embossing |
Convert a photo to a
simulated embossing (3D effect) |
Tiles |
Convert a photo into
simulated square tiles |
Dots |
Convert a photo into a Roy
Lichtenstein style dot matrix |
Painting |
Convert a photo into a
simulated painting |
Vignette |
Change brightness or color
radially around a chosen center |
Texture |
Add texture to an image or
selected area |
Pattern |
Add a background pattern to
an image |
Mosaic |
Create a mosaic using tiles
from all available images |
Custom Kernel |
Edit and apply a custom
convolution kernel to an image |
Directed Blur |
Blur an image area in a
single direction via mouse drag |
Blur Background |
Select foreground areas,
blur the background (bokeh, tilt-shift) |
Combine
Menu |
|
High Dynamic
Range |
Combine images for an
extended brightness range |
High Depth of
Field |
Combine images for an
extended depth of sharp focus |
Stack
/ Paint |
Combind imges to remove
transient cars, tourists, etc |
Stack
/ Noise |
Combine images to reduce
noise by averaging |
Panorama |
Stitch together a series of
images horizontally |
Vertical Panorama |
Stitch together a series of
images vertically |
PT
Panorama |
Stitch together a series of
images using Panorama Tools |
Montage |
Join many images into a
compact table format |
Mashup |
Arrange multiple images and
formatted text in a layout |
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 |
Alien Colors |
repaint an image or area
with random strange colors |
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) |
Clone
Image |
use the mouse to copy from
one image area to another |
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 |
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 |
Montage | join many images together in a compact rectangular format |
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
Image |
paint a color over an image
area with the mouse |
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 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 |
Twist
Image |
twist an image around a
chosen center point |
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 |
Uninstall Appimage |
completely remove an
AppImage package |
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 |