
| Image view: the current image fills the entire window. |
| Gallery view: current thumbnail gallery (directory or other image grouping). |
| World Map view: images with
geotags are dots on the map, which can be clicked. |

| change to gallery view |
|
change to world map view |
| custom favorites popup menu |
| sync, open, save, rename, print, trash ... |
| index, settings, batch functions, collections ... |
| tags, captions, geotags, search functions |
| select areas for separate edit, copy, paste |
| trim, rotate, resize, brightness, contrast, text ... |
| sharpen, denoise, red eyes, color, paint, clone ... |
| fix perspective, warp, flatten book page ... |
| artistic effects, conversions ... |
| HDR, HDF, stack, panorama, mashup ... |
| use other edit apps within Fotoxx |
| user guide, change log, translations ... |
| left / right mouse click: undo / redo one edit step (*) |
| left / right mouse click: move to previous / next gallery image |
|
save (replace), save new version, save new file name |
| change to image view |
| change to world map view |
| set gallery to the directory of the current image file |
| open another directory for a new image gallery |
| open a list of bookmarks, select one and go there |
| use larger thumbnails |
|
use smaller thumbnails or no thumbnails (show file names only) |
| sort gallery list by file name or date, ascending or descending |
| go to the top of the gallery (the first image files) |
| go to the last page in the gallery |
| go up (back) one page |
| do down (forward) one page |
| go up one row |
| go down one row |
| scroll gallery window in slow motion |
| batch and combine functions (convenience duplicates) |


| Favorites |
User-designed
graphic menu for quick access to frequent functions |
| File Menu | File Management |
| Sync
Gallery |
Replace thumbnail gallery
from the directory of the current image file |
| New Window | Clone Fotoxx and open a new window slightly offset from the old one |
| Open Image File | File open dialog - open an image file to view or edit |
| Open Previous File | Go back to the last image file opened |
| Recently
Seen
Images |
Gallery of the most recent image files viewed or edited |
| Newest
Images |
Gallery
of the most recently added new image files |
| Open RAW File | Open
a camera RAW file and edit
with UFraw or Raw Therapee |
| Save
to
Disk |
Save modified image to disk file |
| Rename Image File | Rename
image files, optionally
add sequence numbers |
| New Blank Image | Create a new blank image file |
| Trash Image File | Move the current
image file into the trash folder |
| Delete
Image File |
Delete the current image
file forever |
| Print Image File | Select
printer / paper format /
orientation and print image |
| Quit Fotoxx | Exit from Fotoxx. |
| Tools Menu | Utilities and setup functions. |
| Index Image Files | Rebuild
the image search index
and refresh thumbnails |
| User Settings | A
collection of user preferences
and settings |
| Keyboard Shortcuts | Assign keyboard shortcut keys to menu functions |
| Manage Collections | Make
named image collections,
arrange the sequence, etc. |
| Slide Show | Show
a series of images full
screen (no menu) |
| Batch
Convert
|
Rename
/ convert
/ resize / move /
upright images |
| Batch
Upright |
Upright images that are
rotated 90° (camera turned) |
| Batch
RAW |
Convert
RAW image files to jpeg,
png, or tiff |
| Brightness
Distribution |
Show
brightness distribution
graph of current image |
| Grid Lines | Add
or remove grid lines for
image alignment (warp, rotate) |
| Line
Color |
Set color for overlay
lines (trim rectangle, select area outlines ...) |
| Show RGB | Show
RGB values at current mouse position and prior clicked positions |
| Dark
/
Bright
Pixels |
Highlight
the darkest
and / or brightest pixels, with adjustable thresholds |
| Find
Duplicate
Images |
Search all image files
and report duplicates |
| Monitor Color | Display a color palette for tuning your monitor |
| Monitor Gamma | Adjust
monitor gamma for better
image viewing |
| Change Language | Change
the GUI language |
| Missing
Translations |
List
missing translations to a popup window |
| Menu and Launcher | Add
a system menu entry and
desktop launcher |
| Burn Images to CD / DVD | Select
images and write them to
CD, DVD or BlueRay |
| Resources | Dump resource usage data to the log file |
| Metadata Menu | View and edit metadata (data stored within image files) |
| View Metadata (short) | View most important image metadata |
| View Metadata (long) | View all available image metadata |
| View Captions and Comments | View captions and comments only in a small popup window |
| Show Captions on Images | Show metadata captions and comments at the top of images |
| Tags Overview | Explanation
of tags and how they
are used |
| Edit Metadata | Add
or change image date,
rating, caption, comments, or tags (keywords) |
| Edit Any Metadata | Add or change any metadata |
| Delete Metadata | Delete specific metadata or all image metadata |
| Batch Add / Remove Tags | Add
or remove multiple tags for multiple image files |
| Geotags Overview | General
Information |
| Download Geolocations | Download city locations and a world map for use in geotag functions |
| Edit Geotags | Add geotag data (city, latitude, longitude) to image EXIF data |
| Batch Add Geotags | Add the same geotag data to multiple image files |
| Images by Location / Date | Find
images from selected
country / city / date range |
| Images by Map Location | Click on a world map to get images at or near the selected location |
| Search Images | Find
images with any desired metadata or (partial) directory and file
names |
| Area Menu | Selected areas within images where edits are confined |
| Overview | Explanation of area selection and editing |
| Select | Select
an area for subsequent
editing |
| Show / Hide | Show or hide an area outline |
| Enable / Disable | Enable or disable an area for subsequent editing |
| Invert | Invert an area |
| Unselect | Unselect an area |
| Area
Color |
Change color of select
area outlines |
| Copy / Paste | Copy an area to memory and paste it somewhere else |
| Open / Save | Save an area to a file and load it later to use in other images |
| Edit Menu | Functions
that change or improve an image |
| Trim / Rotate | Trim / crop image edges and / or rotate an image to level it |
| Rotate 90° | Turn an image 90° left or right, to upright the image |
| Auto-Trim | Auto-select trim margins to remove after rotate, unbend, or warp functions |
| Voodoo Enhance | Automatic image enhancement |
| Retouch Combo | Edit brightness, contrast, color, saturation, white balance |
| Tone Mapping | Increase local contrast to to enhance details |
| Brightness Distribution | Flatten or expand the brightness distribution |
| Resize | Scale an image up or down (pixel dimensions) |
| Flip | Mirror
an image horizontally or
vertically |
| Add Text | Write
text on top of an image |
| Add
Lines |
Add lines and arrows on
an image |
| Brightness Ramp | Vary
brightness across the image
using horizontal and vertical curves |
| Paint Edits | Apply
an edit function gradually
by "painting" with the mouse |
| Leverage
Edits |
Apply edit functions regulated by initial brightness or color |
| Repair Menu | Functions to correct problems in an image |
| Sharpen | Sharpen
a blurred image |
| Blur | Blur
an image (e.g. smoothen
skin) |
| Reduce Noise | Reduce
noise (speckles) in
low-light images |
| Smart Erase | Remove power lines and other spoilers from an image |
| Red Eyes | Remove
red eyes from flash
photos |
| Paint / Clone | Paint
pixels or areas with color
or with other parts of the image |
| Remove Dust | Remove
dust spots on images made
from scanned slides |
| Anti-alias
Tool |
Reduce
jagged lines or edges in
low-resolution images |
| Fix Color Fringes | Reduce
chromatic aberration |
| Fix Stuck Pixels | Fix
stuck pixels (always bright
or dark) from camera sensor defects |
| Shift Colors | Shift
RGB colors relative to
each-other |
| Color Mode | Make
a black-white or color
negative, or positive from negative, or sepia |
| Color Profile | Convert
an image profile, e.g. sRGB <> Adobe RGB |
| Match Colors | Match
the colors in one image to
those in another image |
| Revise RGB | Make
complex color corrections
that vary over the image |
| CMYK |
Change
brightness, color,
contrast using CMYK colors |
| Bend Menu | Funtions that bend or warp an image |
| Unbend | Fix
perspective problems |
| Fix
Perspective |
Straighten
a photo made from an
offset angle |
| Warp area | Distort
image within an area by
pulling with the mouse |
| Warp curved | Distort
entire image by pulling
with the mouse |
| Warp linear | Distort
entire image by pulling
with the mouse |
| Warp affine | Distort entire image by pulling with the mouse |
| Flatten Book Page | Flatten / straighten a photographed page from a book |
| Effects Menu | Functions that make artful transformations |
| Color Depth | Reduce color depth (posterize) |
| Sketch |
Transform
a photo into a pencil sketch |
| Line
Drawing |
Transform a photo into a
colored line drawing |
| Color
Drawing |
Transform a photo into a
solid color drawing |
| Graduated
Blur |
Blur
pixels according to
contrast |
| Embossing | Transform a photo into a simulated embossing |
| Tiles | Transform a photo into tiles (pixelate image) |
| Dots | Transform a photo into an array of dots |
| Painting | Transform a photo into a simulated painting |
| Vignette | Change
brightness or color in a
radial pattern |
| Texture |
Add
textured surfaces to
an image |
| Pattern |
Add a background pattern
to an image |
| Mosaic |
Transform an image into a mosaic using tiles made from all images |
| Custom
Kernel |
Apply a custom
convolution kernel to an image |
| Make
Waves |
Warp an image with a wavy
pattern |
| Combine Menu | Functions that combine multiple images |
| High Dynamic Range | Make a high dynamic range image from multiple images |
| High Depth of Field | Make a high depth of field image from multiple images |
| Stack / Paint | Combine multiple images to remove tourists and cars |
| Stack / Noise | Combine multiple images to reduce noise |
| Panorama | Join 2-4 overlapping images horizontally |
| Vertical Panorama | Join
2-4 overlapping images
vertically |
| Mashup |
Arrange
multiple images
and text on a layout |
| Plugins Menu | Use other image
edit
programs as edit functions in Fotoxx |
| Help Menu | User guide,
translations,
change log |
| Image
View popup menu |
|
| Copy to Location |
Copy the image file to
another location (duplicate the file) |
| Move to Location |
Move the image file to
another location (delete the original) |
| Copy to Clipboard |
Copy the image file to
the clipboard (some apps support clipboard paste) |
| Gallery
View popup menu |
|
| Popup Image |
Open a window with a
large image - resizable, movable, persistent until canceled |
| Popup Image (add) |
Same as above, but a new
window is opened instead of re-using the previous one |
| Others |
The copy and move menus
(see above) are also available |
| Image
View |
Fixed shortcuts |
| left / right arrow keys | Previous / next image |
| + or = / - keys | Zoom image bigger / smaller |
| F / G / W keys | Change view mode: image File, Gallery,
World map |
| Z | Toggle: zoom image to 100% / fit image in window |
| Escape key | Exit slide show mode, exit a dialog. |
| Space Bar | Pause and resume slide show |
| F1 function key | Show user guide for current or prior menu function |
| F11 function key | Toggle main window to full-screen (no menu) and back |
| |
|
| Gallery
View |
Fixed shortcuts |
| Home / End keys | move to first / last page of image gallery |
| Page Up / Down keys | move to previous / next page of image gallery |
| up / down arrow keys | move up / down by one row of image gallery |
| left / right arrow keys | move to previous / next page of image gallery |
| + or = / - keys | bigger / smaller thumbnail size |
| |
|
| Default Shortcuts | These can be changed using Tools > Keyboard Shortcuts |
| F1 function key | display user guide for current function |
| N | Rename Image File |
| K | Keyboard Shortcuts - edit |
| Alt+G | Grid Lines on / off |
| T | Trim / Rotate Image |
| V | Voodoo Enhance |
| R | Retouch Combo |
| U | Undo |
| Shift+U | Redo |
| P |
Open Previous File |
| left click | Zoom-in: magnify image, center at click position |
| right click | Zoom-out: restore image to window size. If no zoom, popup menu with common functions. |
| mouse wheel | Zoom in and out depending on wheel direction |
| left drag on image | Pan / scroll zoomed image, same direction or magnified opposite direction (like scroll bars) |

| menu text | text for the popup menu - optional if a menu icon is used |
| menu func | the Fotoxx function to use - the exact menu name |
| menu icon | menu icon - /directory.../filename.png - optional if a menu text is used |
| icon size | if icon is used, its size from 24x24 to 64x64 pixels |
| close window | checkbox: close the popup window when this menu is selected |

| tiff-16 | tiff-8 | png-16 | png-8 | jpeg-100 | jpeg-90 | jpeg-80 | jpeg-70 |
| 70 MB | 35 MB | 23 MB | 17 MB | 8 MB | 3 MB | 2 MB | 1 MB |




| Startup Display | Determines the initial
window
content when
Fotoxx is started. Recent Files: the most recently viewed or edited image files (gallery display). Newest Files: image files most recently added to the Fotoxx database (gallery). Previous Gallery: the directory of the last image viewed (gallery). Previous Image: show the last image viewed. Blank Window: start with no current image and the top image directory in the gallery. Directory Gallery: the given top image directory or sub-subdirectory underneath. Image File: the given image file. |
| Menu Style | The menu style: icons
only or both text and icons. |
| Image
Pan (zoomed image) |
Drag: image moves with
the
dragged mouse. Scroll: image moves against the dragged mouse (like invisible scroll bars), Magnified: movement is magnified: multiple drags for large movement are not needed. |
| Monitor scale |
If a high DPI monitor is
scaled up to make fonts larger, enter the scale value used. 1.0 is
default. If clicking inside the Gallery top panel jumps to the wrong directory, the problem is here. |
| 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. |
| RAW command | The command used to
convert
camera RAW files to tiff-16. This can be changed if you need. See the man page for dcraw for more details. |
| RAW file types | The RAW file types recognized. If your camera uses something else, add it to the list and this may work. You can also shorten the list to those file types you actually use. |

New:
Start a new collection or replace an existing one. The dialog
shown immediately below is started.
Specify a collection name, or use the
[browse] button to select an existing collection to be replaced. Select
one of the three options. Option 1 creates the collection with no
images. Option 2 fills the collection from cached images, if any.
Option 3 creates the collection
from the current gallery. This may be a directory, the output of an
image search, or a collection.
Gallery thumbnails from any
gallery have a right-click popup menu. Copy
to
Image
Cache adds the image to the image cache. The other menu entries
are present only if the gallery is a collection. Cut to
Image
Cache removes the image from the collection and add it to the
image cache. Paste Image
Cache
Here (xxxx) inserts all cached images at the clicked position.
Click roughly between two
thumbnails where the images will be inserted. The (keep)
option keeps the image cache and (clear)
clears it. Remove from
Collection removes the clicked image from the collection.


| Select Files |
Select files to convert
from a gallery window (link). |
| New Name |
Optional new name with #
characters to be replaced with
sequence numbers. |
| base, adder |
Starting sequence number
and adder for each output file. |
| New
Location |
Optional new directory
location for the converted files. |
| new
file type |
File type for converted
images, or "no change". |
| max.
width, height |
Output images will fit
within these dimensions (ratio is not changed). |
| delete
originals |
Delete the input files
after successful conversion. |
| copy metadata |
Copy all EXIF and IPTC
metadata to the output files. |
| upright |
If an image is rotated
90°, upright it (direction known from EXIF). |
| sharpen |
Sharpen output images
using the two supplied parameters |


![]() |
When a point on the image is clicked, the RGB values are shown in a dialog window. The values have the format xxx.dd, where xxx is the upper 8 bits of the color value and .dd is the lower 8 bits. The range is 0.00 to 255.99. The lower 8 bits are zero unless the image is being edited or the image is a 16-bit TIFF or PNG file. EV (exposure value) is an alternative unit, useful for precise color adjustment. EV is zero for mid-brightness (128). The outputs are updated immediately if the image is being edited. The last nine points clicked are shown. The points are labeled on the image corresponding to the letters A-I in the dialog window. If "delta" is checked and the image is being edited, then the changes are shown instead of the absolute values. If no edit is active, "delta" does nothing. |
| RGB | 0 | 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128 | 256 |
| EV | nan | -7 | -6 | -5 | -4 | -3 | -2 | -1 | 0 | 1 |
This
function is used to find duplicated image files anywhere within your
image database. A duplicate image file can be an image
file that exactly duplicates another image file, or an image file that
"almost" duplicates another. For the sake of speed, thumbnail
images are compared in memory. Hence it is possible
that identical thumbnails are found for which the main images have some
minor (likely invisible) differences that do not show up in the
thumbnails. An image copy that was reduced to 1/2 size is likely be
classified as a duplicate. The thumbnail
size can be set from 32 to 256 pixels (max. width or height). A
larger size reduces the probability of false positives. The thumbnail
size greatly affects the amount of main memory required - e.g. for 100K
images, size 32 needs 220 MB, whereas size 64 needs 880 MB. The memory
required is roughly size x size x 0.75 x 3 x (image count). Two
parameters are used to set the sensitivity for detection of
identical or nearly identical images: pixel
difference is the RGB value difference below which pixels are
considered
equal. Set to 1 to detect any pixel difference. pixel
count is the number of
different
pixels below which two images are classified as duplicates. Example: if
pixel difference = 3 and
pixel count = 100, then images are classified as duplicates if fewer
than
100 pixels are different by less than 3. The output is a gallery
view, showing each pair (or more) of duplicate images. Screening 100K
images needs about 11 minutes on a strong PC.

| Key Name | Fotoxx Usage |
| Date / Time Original | Edit Metadata function - image date |
| Keywords | Edit Metadata function - image tags |
| Rating | Edit Metadata function - image stars |
| User Comments | Edit Metadata function |
| Caption-Abstract | Edit Metadata function |
| Geotags | Edit Geotags function, 3 search image functions |
| Image
History |
History of Fotoxx edits applied to the image |
| any key | Edit Any Metadata, Delete Metadata |

The
dialog
displays the location data for the current image, if any. The
live display is updated when a new image is opened. For an image with
missing or incorrect location data, enter a city name and use the
[Find] button to either complete the data in the dialog, or get a list
of matching cities to choose from (e.g. Bermingham, United Kingdom and
Bermingham, United States). Partial matches are found, so you can
usually enter a leading substring, e.g. "hono" for Honolulu. Use the
[Apply] button to enter the data into the EXIF metadata for the current
image, and also into the search index for later searching by location.
If the data is revised in the dialog (spelling of city / country, or
revision of latitude / longitude), this will take precedence for future
city searches. Use the [Prev] button to fill the dialog data with the
last location used. If the [Find] button does not find a city (it is
missing from the cities-geotags file), you can use the [Web] button to
find the city and location data from an internet web service (MapQuest
Open for now, but this can change). The location data is completed and
returned into the dialog. These names are not standardized and there
are many duplicates, so check the returned data for reasonableness and
change the spelling and capitalization if needed. The [Apply] button
will add the location data to the image, and this location will be
available for future use by using the [Find] button. If the [Web]
button
fails, you can manually find the city in the internet and enter the
location data into the Edit Geotags dialog. Pressing [apply] will add
the data to the current image and make the location available for
future use.
With
this
function, you can select many images and add the same location
data to all of them. Use the [select files] button to select the image
files from a gallery window (link).
Then get the location data as described above in Edit Geotags. Press
[proceed] to start the update process. Use this function also to
correct city / country spellings or latitude / longitude data, or to
fix
inconsistencies.


| Rectangle | Drag the mouse to enclose a rectangular area. |
| Ellipse | Drag the mouse to enclose an elliptical area. |
| Freehand Draw | Drag and click the mouse to draw lines that outline an enclosed space. |
| Follow Edge | Click or drag along
the
edge of an
image object to draw lines that follow the edge. |
| Replace | Drag the mouse near an area edge-line to move the edge to the mouse. |
| Controls for the methods below |
"mouse radius" sets
the
size of a selection circle around the mouse pointer. "match level" sets the color match (0-100%) required for pixel selection. |
|
Select area within mouse |
Left / right drag
to
select / unselect all pixels within the mouse circle. Selection is independent of color. |
|
Select one matching color within mouse |
Click on the image
to
select a color. Left / right drag to select / unselect pixels inside the mouse circle that match the selected color within "match level". |
|
Select all matching colors within mouse |
Left / right drag
to
select / unselect pixels surrounding the mouse that match the color of any pixels inside the mouse circle, within "match level". |
| left drag | select pixels inside mouse circle and those with matching colors within search range |
| right click | undo previous selection, repeat to unselect more |
| right drag | unselect pixels inside mouse circle and those with matching colors within search range |

| amplifier |
increases or decreases
the effect of the brightness edit curves |
| brightness |
moves the entire curve up
or down |
| contrast |
moves the curve lower and
upper
parts in opposite directions |
| low color / high |
increases or decreases
color saturation |
| warmer / cooler |
adjusts color temperature
(reddish <--> blueish) |
| dark
areas / bright |
apply color changes to
darker / all / brighter image areas |
| brightness distribution |
show a brightness
distribution graph in the curve edit window |
| click for white balance |
enables the mouse to
click
on a black point or gray / white point |
| Settings File |
dialog settings can be
saved in a file and loaded later for use with other images |













| Flatten Outliers 1 | The highest and lowest pixel values within a radius are moderated slightly. |
| Flatten Outliers 2 | Pixels are compared to
the mean
and sigma of pixels within a radius. Those outside one sigma are moved slightly back toward the mean. |
| Median Brightness | Pixels are set to the median value of their neighbors within a radius. |
| Top Hat | Detect outliers by
comparison
with a band of pixels at a distance. The distance is increased in steps from 1 pixel to the radius limit. |
| Wavelets | Image brightness (with noise) over distance is converted into a series of wave functions that nearly sum to brightness and represent an approximation with less noise. |






This
function
can be used to make complex color corrections, whereby
different parts of the image need different corrections. Select up to 9
control points on the image by clicking them with the mouse. The points
are added to the list in the dialog window, with the most recent point
at the top. The points are labeled A-I in the list and on the image
window. The current RGB values are shown (or EV or OD units if
selected). Change the RGB / EV / OD values in the dialog, and the image
will be changed to match. Each pixel in the image is influenced by all
the control points in the dialog, with the closer control points having
more influence than those farther away. The slider Blend determines how
widely the control points spread their influence. If
"delta" is checked, the values shown are the deltas (differences) from
the original image.
| Brightness | Increase or
decrease overall image brightness |
| +Red
- Cyan etc. |
Increase or
decrease the brightness of one RGB color and change complimentary colors in the opposite direction |
| Contrast |
Increase or
decrease the overall image contrast |
| Red, etc. |
Increase or
decrease the contrast of individual RGB colors |










This
function
adds a textured surface to an image or selected
areas within an image. Radius
determines the texture pattern size. Strength determines the intensity
of the pattern, from almost invisible to dominant. 



Select
the
HDR menu function and select up to 9 images, which must all have
nearly the same pixel dimensions. The
images are aligned and combined automatically. This needs 10 seconds to
a minute or
more per image, depending on image
size and CPU speed. When
done, the combined image is shown, along with a dialog
for manual adjustments. The contributions from the input images are
shown as a series of editable curves. The horizontal scale represents
pixel brightness, from dark to bright. Each curve represents an
image which contributes to the pixels. The image contribution at a
given brightness level is proportional to the height of its curve at
that level. The initial curve for the brightest image will be high on
the left and low on the right, meaning a high contribution to dark
pixels and a low contribution to bright pixels. The darkest image will
be low on the left and high on the right, and the remaining images will
be in-between. The curves can be edited by dragging them with the
mouse. The corresponding image contributions
are changed accordingly, and you can see the results in quasi-real-time
in the output image. In
general, the brightest image should have a higher contribution to the
darker pixels, and the darkest image a higher contribution to the
brighter pixels. You will likely need practice to become effective at
working the curves. A faster and easier alternative may work as well:
after the images are combined, ignore the curves and exit from HDR. Use
various edit functions to refine the image: Brightness Distribution,
Retouch Combo, and Tone Mapping. Select Area can be used to
enclose any area in the image which needs more brightness, color, or
local contrast, so you can apply different methods and parameters to
different areas.
Processing the photos: in Fotoxx,
choose the HDF menu function and
select up to 9 images. The images will now be aligned as well as
possible. This needs 10 seconds to a minute or more per image,
depending on image
size and CPU speed. The output image is an even mix of the aligned
input images. A small amount of camera movement between the photos is
compensated, but this is limited, and parallax shifts are not
compensated at all. When the alignment is complete, a dialog opens. You
can select any input image and "paint" with the mouse on any area of
the output image. This converts the original image mix to the selected
image for the area being painted. For each area or object in the image,
choose an input image that is sharp in that area. The radius of the
paintbrush can set larger or smaller, so you can paint large areas
quickly and control fine detail when needed. If you have overlapping
near and far objects, time and patience will be needed to make all of
them sharp. Misalignments can be corrected by selecting the "warp"
option in the dialog. The underlying images can then be dragged and
warped with the mouse, and the composite output image is changed
accordingly. The warp is limited to the area around the mouse. When a
painted area is dragged, the corresponding image is automatically
selected and dragged, while areas painted with other images remain
fixed. Areas that have not been painted cannot be dragged. Move around
to different areas and make incremental drags until all areas are
aligned.
Combine
(overlay)
multiple photos of the same subject taken at different times.
Remove tourists and cars that come and go between shots by painting
them away with the mouse.
Making the photos: Choose a point for the center of the image. Take
several photos using the same center and being careful not to shift or
rotate the camera too much. The more photos the better. Up to nine can
be used with Fotoxx, but you can take more in order to have some to
discard if they are not sharp, a common problem with low light
conditions and long exposure times.
Start
by selecting 2-4 image files. The
images
are initially joined and shown with a small transparent overlap. A
pre-align dialog asks you to drag the images into rough alignment. Drag
the images into the correct left to right order. The image to drag may
overlap other images. To be clear about which image is being dragged,
drag from near the center of the image. After the images are in the
correct order, align each image to its left neighbor. It works best to
proceed from left to right. Move an image horizontally and vertically
into rough alignment with its neighbor to the left, then rotate the
image if needed by dragging the bottom edge left or right. The image
pivots around the mid-point of its overlap with the image to the left.
The fastest method is to align the overlap middle region first, then
rotate the right image if needed to bring the upper and lower overlap
regions into alignment. Extreme accuracy is not needed. Use the
[resize] button to get a bigger
combined image after moving them closer
together. The images should be correctly curved and fit together well.
If they do not, then the lens mm
parameter (focal length, 35mm
equivalent) needs adjustment. The curvature of the images changes as
lens mm is adjusted. The initial value is obtained from the EXIF data
if available, and this is normally good enough. The lens
bow parameter
(barrel or pincushion distortion) is not available in EXIF and must be
adjusted manually, but this is usually insignificant and can be left at
zero. You can measure and set the lens parameters manually using the [search] button described
below. If the images have
no curvature
(e.g. scanned or downloaded images),
use the no curve checkbox to
set the lens mm effectively to infinity.

Arrange
multiple
images and text in a layout (photo montage). Images can be
added, resized, rotated and moved around by dragging with the mouse.
Images can be made entirely or partly transparent in selected areas.
Text can be
added, moved, resized and rotated. Text attributes can be specified:
font, size, color, outline, shadow, transparency. Lines and
arrows can be added. The example here
shows some of the possibilities.






| Method
and
Example |
Advantages |
Disadvantages |
| Directory
and File Names e.g. image files like this: /images/2012/Rome-12.jpg |
• simple and easy
to use • fast implementation: batch move and rename files with added sequence numbers • gallery overview at each level of hierarchy • easy to navigate up / down hierarchy levels |
• no overview of
available search terms • long file names required for multiple search categories (date, place, persons, events ...) • risk of inconsistent naming and chaos |
| Captions and Comments e.g. caption or comment like this: 2012 Italy Rome Forum |
• simple and easy
to use • flexible search using multiple categories • moderately fast implementation: think + write time, per image |
• no overview of
available search terms • may end up with thousands of categories • risk of inconsistent naming and chaos |
| Tags (EXIF Keywords) e.g. tags like this: italy, rome, forum, elizabeth |
• flexible search
using multiple categories • moderately fast implementation: think time + one click per tag, per image (or batch add tags to a group of images) • good overview of available tags to click (organized by persons, places, events ...) • easy addition of new tags |
• requires careful
planning of tags • slow to find and click tags if 200+ tags • hard to revise tag naming system (batch tag add / delete / replace available) |
| Geotags e.g. location data like this: Rome Italy 41.89 N 12.48 E |
• cameras with GPS
store data automatically • add locations in a few seconds per image (or batch add location to many images) • search location by clicking on a world map • search location and date-range by clicking on a report of available locations / dates |
• useful only for
searching by location • chaotic location naming by cameras (revise using search and batch update) |
| Named Collections e.g. collection names like this: • best scenery • Italy 2012 |
• make ad hoc
collections using any criteria • images can be in multiple collections or multiple times within one collection |
• time to locate
and add images to collection (find and click gallery thumbnails) • images not searchable by other categories • not standards compliant |
| image
files |
Fotoxx was tested
with 156K image files and performace was fine (see benchmarks,
below). 500K image files should be practical on a strong computer, but startup time may be 20+ seconds. |
| image size | The max. supported width or height is 20K pixels (compile time constant). |
| image edits | 99 edits for undo / redo and file version numbering (filename.v01 to filename.v99). |
| geotag cities | 20,000 different
cities / locations for geotagged images (compile time constant). |
| tags | There are limits listed in the topic Tags Overview. |
| xdg-utils | open text or html files with user's preferred application |
| exiftool | (v. 8.60 or later) read
and
write image metadata
(tags, comments, etc.) |
| dcraw | batch convert RAW image files to tiff, jpeg, or png |
| ufraw | open a RAW image for editing using the ufraw GUI |
| brasero | burn a CD or DVD with selected images |
| canberra |
play sounds for slide show |
| xgamma | used for the Monitor Gamma function (adjust monitor gamma) |
| g++ | GNU C++ compiler and C libraries |
| libgtk3.0-dev | Gnome GTK3 / GDK3 / Pixbuf / etc. function libraries |
| libtiff5-dev | tiff library development files |
| libpng12-dev | png library development files |
| liblcms2-dev | Little CMS development files |
| -v | output release version and exit |
| /.../imagefile.jpg | initial image directory or image file to open |
| -recent (or -r) | show a gallery of recently seen image files, most recent at the top |
| -new (or -n) | show a gallery of the
newest image files (from Index Image Files) |
| -prev (or -p) | show the last file viewed in the previous session |
| -blank (or -b) | show a blank window |
| -lang lc_RC | language code (+ opt. region code) to use for GUI (de, de_AT, fr ...) |
| -menu "menu name" | startup menu function - Fotoxx will start with this menu active. |
| CPU 123% | current Fotoxx CPU load for all threads and processor cores |
| Free 1234 MB |
total free memory,
including the file cache (can be allocated) |
| 2345x1234x8 |
image width x height x depth (bits per color) |
| 3.45MB | image file size (updated when a modified image is saved) |
| 56% | zoom status, image % size |
| edits: 3 | 3 edits have been made and can be reversed with the [undo] button |
| area active | a select area is present and enabled - edits are confined within the area |
| dialog open | a dialog for user input is open and waiting |


| /usr/bin/fotoxx | the executable program file |
| /usr/share/fotoxx/* | user guide,
translation.po files, icons, default data, etc. |
| /usr/share/doc/fotoxx | change log, man page,
README and
other documentation files. |
| /collections | image collections from
Manage Collections function |
| /custom_kernel | saved custom kernel data files |
| /favorites | saved data for user-configuration of favorites menu |
| /geotags | downloaded geotag locations and world map image file |
| /image_index | text files containing searchable data for all image files |
| /locales | saved translation (.po) files, possibly user-modified |
| /mashup | saved mashup project files |
| /patterns |
saved background patterns |
| /retouch_combo | saved settings for the Retouch Combo function |
| /saved_areas | "cutout" files saved from the Select Area > Save dialog |
| /saved_curves | curve data saved from Retouch curve edit dialogs |
| /slideshows | user preferences from
Slide Show function |
| /thumbnails | thumbnail files (default location, user can change this) |
| /write_text | image text overlays saved
from Add Text function |
| bookmarks | bookmark names and image file locations |
| KB-shortcuts | user-defined or modified keyboard shortcuts |
| latest_release | contains the current or latest Fotoxx release version |
| logfile | Fotoxx outputs that may be relevant for diagnosing problems |
| mosaic_tiles |
binary file, compressed
tiles from the Mosaic function |
| newest files | a list of the 200 most recently added image files |
| pagesetup | saves page setup data for print function |
| parameters | setup parameters that are saved across Fotoxx sessions |
| plugins | saves the plugins menu contents |
| printsettings | saves print settings data for print function |
| recent_files | a list of the last 100 files opened by Fotoxx, saved when Fotoxx exits |
| search_results | list of the last image files found with Search Images |
| stuck-pixels |
data saved from the Fix
Stuck Pixels functin |
| tags_defined | a list of all categories and tags currently used in all images |
| zdialog_inputs | saved dialog data for dialogs that recall prior inputs |
| zdialog_positions | saved dialog window positions (relative to main window) |
| Metadata section and name | Usage | Index |
| IPTC:Keywords | tags entered by user | yes |
| IPTC:Rating | "star" rating entered by user | yes |
| EXIF:ImageSize | pixel width and
height,
1234x2345 |
yes |
| EXIF:DateTimeOriginal | date / time photo was made, or entered by user | yes |
| EXIF:ImageHistory | history of image edits (used by Fotoxx and others) | no |
| EXIF:UserComment | comment text entered by user | yes |
| IPTC:Caption-Abstract | caption or abstract text entered by user | yes |
| EXIF:FocalLengthIn35mmFormat | camera focal length used, 35mm equivalent | no |
| EXIF:City, Country | city and country from camera GPS, or entered by user | yes |
| EXIF:GPSLatitude, GPSLongitude | earth coordinates from camera GPS, or entered by user | yes |
|
Benchmark Description |
Image
Files |
Time |
| First
initialization,
find and
index all image files |
156,240 |
99 min. |
| Subsequent startup
with
no new image files |
0 new, 156,240 old |
7 sec. |
| Subsequent
startup, 343 new files to index |
343 new, 155,897 old |
20 sec. |
| Find all images
with tag "Rosi" |
5502 found |
1 sec. (1) |
| Find all images
with "Rosi" in file name |
2856 found |
1 sec. |
| Find all images
dated Jan 1 - Feb 28, 2013 |
420 found |
1 sec. |
| Same time period,
with city = "Freising" |
168 found |
1 sec. |
| Same time period,
with EXIF "make" = "panasonic" |
126 found |
7 sec. (2) |
| Click on world
map, France / Esterel |
105 found |
1 sec. |
| List all locations
having images |
368 locations |
2 sec. |
| Click on location
Germany / Augsburg |
231 found |
1 sec. |