Fotoxx User Guide v.16.11 | 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 options, 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 upload, 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 options, batch functions, utilities |
Help Menu | duplicate of the help menu listed
above |
Map View
Menus |
menus visible in Map View
mode |
Choose
Map |
choose among available
maps |
OSM Map
Source |
|
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 |
![]() |
OSM 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 OSM 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 OSM 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 OSM map view |
![]() |
|
![]() |
choose from available maps (Europe, USA, Germany ...) |
![]() |
change to image file view |
![]() |
change to gallery view |
![]() |
change to world map view |
![]() |
current view = OSM map |
![]() |
|
![]() |
choose internet map source |
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 OSM
Map |
Go to OSM 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 OSM Map | Go to OSM 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, OSM 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 Options) |
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 |
OSM 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 Ramp | Vary brightness 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 |
Method and Example |
Advantages |
Disadvantages |
Directory and File
Names e.g. image files like this: /.../2014/06.25 Rome-12.jpg |
+ simple and easy to
use + fast implementation: batch move and rename files with added dates and sequence numbers + gallery overview at each level of hierarchy + easy to navigate up / down hierarchy levels |
+ no overview of available
search terms + long file names required for multiple search categories (date, place, persons, events ...) + risk inconsistent names, unreliable search |
Captions and Comments e.g. caption or comment like this: 2014 Italy Rome Forum |
+ simple and easy to
use + flexible search using multiple categories + moderately fast implementation: think + write time, per image |
+ no overview of available
search terms + may end up with thousands of categories + risk inconsistent names, unreliable search |
Managed Tags + e.g. Rome, Italy, Susan + Point and click in a tag list to add tags to images + Tags have categories for faster visual location in the tag list |
+ good overview of
available tags to click (organized by persons, places, events ...) + easy creation of new tags + no inconsistent or redundant tags, no typos + therefore searching more reliable |
+ requires careful planning
of tags + slow to find and click tags if >500 tags + hard to revise tag naming system (batch add / delete / rename is available) |
Random Tags + tags with no organizing system |
+ no planning needed + creating and entering tags is faster (point and click or type-in tags) + legacy tags can be kept unchanged |
+ inconsistent tags
(scenery, landscape) + redundant tags (Susan, Susy, Sue) + tags with typos (scenery, scenrey) + poor overview of existing tags + therefore searching less reliable |
Geotags e.g. location data like this: Rome Italy 41.89 N 12.48 E |
+ cameras with GPS store
data automatically + manually add locations (few secs. per image) + batch add location to many images at once + search location by clicking on a map image + search location and date-range by clicking on a report of available locations / dates |
+ useful only for searching
by location + chaotic location naming by cameras (revise using search and batch update) |
Albums e.g. album names like this: + best scenery + Italy 2014 |
+ make ad hoc albums using
any criteria + images can be in multiple albums or multiple times within one album + basis for slide show function |
+ time to locate and add
images to an album (find and click gallery thumbnails) + images not searchable by other categories + not usable by other applications |
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 slant angle,
can be used to auto-level an image |
no |
Image Index Speed (find new
image files, update image index and thumbnails) |
Speed |
Image
index speed using a 5400 rpm disk |
1180 /
min. |
Image index speed
using a 7200 rpm disk |
1700 /
min. |
Image index speed
using a 10000 rpm disk |
1920 /
min. |
Image index speed
using an SSD disk |
2640 /
min. |
|
|
Following benchmarks used 9215
image files and 7200 rpm disk |
|
Startup after reboot,
no new image files |
< 1
sec. |
Startup with 100 new
image files to index |
6
sec. |
Find all images with
tag "Rosi" (253 images) |
< 1
sec. |
Find all images with
"Rosi" in file name (111 images) |
< 1
sec. |
Find all images dated
Jan 1 - May 30, 2013 (255 images) |
< 1
sec. |
Find all images dated
in 2013 and with location = "Freising" (90 images) |
< 1
sec. |
Find all images dated
in 2013 with EXIF "make" = "panasonic" (342
images) |
3.8
sec. |
Click on world map,
France / Esterel (5 images) |
< 1
sec. |
List all locations
having images with geotags (6714 images) |
< 1
sec. |
Click on location
Germany / Dresden (113 images) |
< 1
sec. |
|
|
Following benchmarks used 257K image files on an SSD disk | |
Initial index of 256906 image files (made by duplicating my collection 25x) | 1.6 hours |
Startup with 5921 new
image files |
2.3 min. |
Search 256906 image files for date > 2016.01.01 (13744 images found) | < 1 sec. |
Click on world map, Monument Valley (760 images found) | < 1 sec. |
|
|
Following benchmarks used 257K
image files on a 5400 rpm disk |
|
initial index of 256802 image files (made by duplicating my collection 25x) | 3.6
hours |
Search 256802 image
files for date > 2016.01.01 (14014 images
found) |
< 1
sec. |
Click on world map, Monument Valley (780 images found) | < 1
sec. |
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 |
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 Add 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 |
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 |
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 I(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") |
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 |
OSM Map | world map at any scale, retrieved as needed from
the internet |
OSM 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 |
Ramp Brightness | ramp brightness across an image (compensate uneven
lighting) |
Ramp Color | vary RGB levels centered on chosen image
locations |
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 |
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 Options | 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 |