change to gallery view |
change to world maps
view |
custom favorites popup menu |
sync, open, save, rename, print, trash ... |
index, user settings, batch functions, albums, slide show ... |
edit tags, captions,
ratings, geotags ... search images |
select areas for separate edit, copy, paste |
trim, rotate, resize, brightness, contrast, color, add text ... |
sharpen, clean noise, 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 |
+ or = |
zoom-in (amount adjustable in
user settings) |
− |
unzoom, fit entire image
within window |
Z |
toggle: zoom to 1x image size,
zoom back to fit window |
← / → keys |
go to previous / next image in
current gallery |
change to image file view |
change to world maps 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) |
change to image file
view |
change to gallery view |
choose another map |
set map search range |
Favorites |
User-designed
graphic menu for quick access to frequent functions |
File Menu | File Management |
Sync
Gallery |
Replace thumbnail gallery
with 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 |
Bookmarks |
Define bookmarked gallery
locations, go to bookmarked location |
Keyboard Shortcuts | Assign keyboard shortcut keys to menu functions |
Manage Albums | Make image
albums, add and remove images, arrange the sequence |
Slide Show | Show a series of
images full screen (no menu) |
Cycle Background |
Cycle the Desktop
background image using a Fotoxx album |
Batch
Convert |
Rename / convert
/ resize / move / upright images |
Batch Upright |
Upright images that are
rotated 90° or 180° (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 |
Magnify
Image |
Magnify the image within
a radius of the mouse. Works like a magnifying glass. |
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 disc |
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 |
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 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 |
Auto-Trim | Auto-select trim
margins to remove after rotate, unbend, or warp functions |
Upright |
Turn an image 90° or 180° to upright the image |
Voodoo Enhance | Automatic image enhancement |
Retouch Combo | Edit brightness, contrast, color, saturation, white balance |
Tone Mapping | Increase local contrast to to enhance details |
Brightness Distribution | Flatten or expand the brightness distribution |
Zonal Flatten |
Flatten brightness
distribution in independent image zones |
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 |
Plugins |
Use other image edit programs as edit functions in Fotoxx |
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 Denoise |
Reduce noise using a
calculated threshold to avoid loss of detail |
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 |
Directed
Blur |
Blur an image in a single
direction using the mouse |
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 |
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 |
Popup Image shortcut |
Shift key + left click on
a gallery thumbnail creates a popup window containing the image. Zoom in/out using the mouse wheel. When zoomed small it disappears. |
General |
|
F / G / W keys | Change view mode: image File, Gallery, World maps |
F1 function key | Display user guide for current or prior function |
F11 function key | Toggle main window to full-screen (no menu) and back |
Image
File View |
|
left / right arrow keys | Previous / next image |
+ 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 to current
image file |
M | 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 |
V | Voodoo Enhance |
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 |
Escape key | exit a dialog |
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) |
right drag on gallery | Scroll down or up by
dragging to the top or bottom edge, faster as mouse approaches the edge. |
mouse + Ctrl key |
Mouse acts on main window
instead of a mouse-using dialog like Select Area. |
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. |
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 gallery pages with a large thumbnail size.
If this is changed, you need to delete your thumbnail files so that the
index process is forced to rebuild them with the new size. Only those
needing replacement are rebuilt. |
hidden
directories |
Show hidden directories
in gallery view. If not checked, these are not displayed. |
prev/next
version |
Show only the last
versions of image files when using the prev/next button or KB keys. |
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. |
Keyboard Shortcuts (key K) ![]() |
Manage
Albums Dialog![]() Choose: Choose an album to view or edit. The gallery window will show its current images. Use the thumbnail popup menu (below) to add or remove images. Images: 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. You can also use Search Images to create a gallery for selecting images, or choose an album gallery. Selected images are added to the image cache. The cached images can now be added to an album using the popup menu (below). Clear: Discard all images in the image cache. Delete: Select an album to delete. Image files are not deleted. New Album dialog ![]() Right-click Popup Menu ![]() |
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°/180°, upright it (status 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 magnifies the image in an area around the mouse pointer. Left-drag the mouse around the image to magnify different areas, analogous to viewing a printed image through a magnifying glass. Use the dialog to adjust the radius of the area and the amount of magnification. A mouse click will end the magnify, and a new mouse drag will start it again. Use the M-key shortcut to start or end the Magnify function. |
Monitor Gamma ![]() Gamma determines how RGB brightness values (0-255) are converted into brightness on the monitor. The standard value is 2.2 and this should normally be used for image editing. Adjust the dialog slider until the middle band has the same brightness as the upper and lower bands at scale location 2.2. Be far enough from the monitor that you cannot see the fine lines in the chart. The chart only works at 100% size, so do not zoom the chart. The command line utility "xgamma" is required (normally present). The chart image originates from Norman Koren. The linked web site has more information about this chart. |
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 |
Batch Add Geotags ![]() |
USA.jpg, 24.855, 49.17,
-124.99, -59.766 Europe.jpg, 30.89, 71.25, -10.73, 39.71 |
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 |
Zonal Flatten ![]() ![]() Zonal Flatten enhances visible detail in image areas having poor contrast. It is similar to Flatten, described above, but is more effective for an image that already has a wide overall brightness distribution. The revised brightness for a pixel is based on its position in the brightness distribution for nearby zones. Zones sets the number of zones. A larger number calculates new pixel values from closer areas. Flatten controls the strength of the effect, and deband moderates darker or brighter image areas. This function is very effective at increasing contrast: it can amplify noise in uniform areas like sky. If the deband control is insufficient to correct this, use Select Area and Reduce Noise to fix the noisy areas. Alternatively, use Select Area beforehand to select sky (or other areas to omit) and then invert the selection prior to using Zonal Flatten. Technical Explanation (optional) The image is divided into areal zones. The zone count approximates the user input and may be slightly more. Each pixel is adjusted based on the 9 closest zones, the 3x3 zones surrounding the zone of the pixel. More zones means smaller and closer zones. The brightness of a pixel is compared to the brightness distributions of the nearby zones, and the brightness is adjusted up or down in the direction that would flatten the distribution if the pixel were really a member. The influence of the 9 zones are weighted based on their distance from the pixel being calculated. The influence of the leftmost zones goes to zero for a pixel on the right edge of its zone. The same is true for the topmost zones, etc. This prevents abrupt brightness transitions that would be visible to the eye. The nature of the eye helps hide the bizarre alterations in pixel brightness, since the eye also judges the brightness of a spot based on its surroundings. A larger number of zones will make each pixel brightness adjustment depend on areas closer to the pixel. |
![]() Making a Watermark: use a text transparency of 70% or more and a background transparency of 100%. The text should be faint but readable. To add a "relief" effect, use Select Area to put a box around the text and use the function Effects > Embossing to give the text an appearance of depth. |
Menu
Name |
command
line |
Gimp |
gimp %s |
auto-gamma |
mogrify
-auto-gamma
%s
|
Gthumb |
gthumb %s |
Flatten Outliers 1 | The highest and lowest pixel values within a radius are moderated slightly. |
Flatten Outliers 2 | Pixels are compared to
the mean and sigma of pixels within a radius. Those outside one sigma are moved slightly back toward the mean. |
Median Brightness | Pixels are set to the median value of their neighbors within a radius. |
Top Hat | Detect outliers by
comparison with a band of pixels at a distance. The distance is increased in steps from 1 pixel to the radius limit. |
Wavelets | Image brightness (with noise) over distance is converted into a series of wave functions that nearly sum to brightness and represent an approximation with less noise. |
Brightness | Increase or
decrease overall image brightness |
+Red
- Cyan etc. |
Increase or
decrease the brightness of one RGB color and change complimentary colors in the opposite direction |
Contrast |
Increase or
decrease the overall image contrast |
Red, etc. |
Increase or
decrease the contrast of individual RGB colors |
Mashup ![]() ![]() In the first Mashup dialog, choose a background or layout image where other images will be placed. Choose an existing image or create a new monotone image with a specified size and color. You may also open a previously saved mashup project and continue editing. ![]() The 2nd Mashup dialog is a choice: edit images, edit text, edit lines and arrows, save the mashup project for later revision, save the completed composite image (Done) or abandon the image (Cancel). The first three choices lead to dialogs to perform the respective edits. Each of these return to this dialog when done, so you can add or modify images, text, and lines / arrows in any sequence. Rescale is explained below. ![]() Use this dialog to select and place images on the layout and revise their appearance: size, rotation, position, and transparency. An image may be partly or wholly transparent, overall or within specified areas. This means that the background image or an overlapped image can show through the transparent areas. The Add button leads to a gallery file selection dialog (link). Selected images are placed on the layout. Click on an image to select it. Drag the image from the middle to reposition the image in the layout. Drag the lower right corner to resize the image. Use the dialog controls to adjust the image. The dialog controls operate on the last image added, clicked or dragged. The Next button will cycle through the images one at a time, flashing the selected image. This can be used when overlapped images make it difficult to select the desired image by clicking it. Scale resizes the image. Angle rotates the image. The Stacking Order buttons raise or lower an image relative to other images - this determines which overlapping image will be on top. Base Transparency is used to make an entire image partly transparent. The [paint] button is used to make any part of an image partly or fully transparent, using the Paint dialog below. The [warp] button is used to bend or warp an image, using the Warp dialog below. The black margins checkbox can be used to remove black margins from other edit functions, e.g. bend or warp. These will be made transparent. The Margins controls can be used to increase edge margins. The Hard margins cut off image edges. The Blend margins make the edges partly transparent to blend them into the background or overlapped images. ![]() "Paint" more or less transparency for selected image areas. Click on an image to select it. The mouse will have a circle around it to show the range of action. Use radius to adjust the size of the circle. Left-drag the mouse over the image to make it transparent in the areas covered by the circle. Right-drag to make it opaque. If Gradual is checked, transparency changes are made slowly as the mouse is dragged. Specify a power value for the mouse center and edges to make the changes faster or slower. ![]() Click this dialog to insure it is active, and click on an image to select it. Drag the image with the mouse - the image will warp or stretch locally in the direction of the mouse (like sheet rubber). The area of warping is roughly given by warp span, which is a fraction of the image size. Each drag is a step that adds to previous steps. Recent steps can be reversed with [undo last], and the unbent image can be restored with [undo all]. ![]() The Edit Text dialog is used for placing text on the layout. Enter some text and press Add. The text is placed on the layout. Drag it into position, then use the dialog controls to set font, size, color, angle, background color, outline size and color, shadow size and color, and transparencies for each of these. Drag the text to a new position at any time. Click on any existing text to show its properties in the dialog and revise them. Click on a text and press Delete to remove it. When done editing, press Done to return to the 2nd Mashup dialog. ![]() The Edit Line / Arrow dialog is used for placing lines or arrows on the layout. It works very much like adding text. Enter a length and width and press Add. A line is placed on the layout, or an arrow if one of the Arrow head options is checked. Drag the line / arrow to the desired position. Adjust length, width, angle and attributes (background, outline, shadow) using the dialog. You can also drag either end of the line/arrow to reposition that end while leaving the other end fixed. You can use the mouse to move and resize objects in the layout: click the object to select it - it flashes to confirm the selection. drag from the approximate center to reposition the object. drag the image or text lower right corner to resize. for a line/arrow, drag either end to move that end only. The keyboard arrow keys can also be used to move the currently selected object in 1-pixel steps. You can add images saved by Select Area. In the Edit Images dialog, press [Add] to start the file selection dialog. Use the [Top] button in the gallery window, select HOME, then select .fotoxx/saved_areas. Open any of the .tiff images found there. The original area outline is used, and edge blending works from these edges. Mashup project files You can save a project and open it later to continue editing. However, the project file will open successfully only if the layout image and all the overlay images are still available in their original locations. The Mashup project is rebuilt using these images and some saved metadata that is in the project file: image and text locations, scales, transparency, etc. Mashup Rescale Working with a very large layout (over 20 megapixels) can be quite slow, especially if the PC is not very strong. Dragging a large overlay image can be slow and jerky. You can work much faster if you use a smaller layout to build the project, and then make it larger after you are finished. There is no loss of resolution in the final image, since the overlay images and text are regenerated from the inputs (e.g. an image that was scaled to 0.2x in the initial layout is rescaled to 0.6x if the layout is magnified by 3x). The original full size image file is used for this rescale. The Rescale button allows you to magnify the project by 2x, 3x or 4x (4x, 9x or 16x by area). There is also a 'reset' option to restore the original smaller project size. With this method, you can work with a 10 megapixel layout and resize it up to 160 megapixels when done. The larger layout can still be worked on directly afterwards, but it will be much slower. PT Panorama Fix Mashup can be used to fix minor alignment offsets from PT Panorama. After running PT Panorama, start Mashup (in the same Fotoxx session), and create a flat layout image with a good size for editing (e.g. 3000 pixels wide). Start the dialog to add images to the layout. Navigate to the directory /tmp/fotoxx-xxx/ where you will find the images left by PT Panorama. They have been color matched and warped to fit together. Add these images to the layout. Check the box to make the black margins transparent. Resize them to fill the layout and move them around to fit together. Zoom the window larger for precise algnment and align the images as well as possible. Small misalignments will persist if the images do not fit perfectly. There may also be brightness or color mismatches at the image edges, but these can be fixed later. Start the Warp Images dialog. Drag the mouse in small steps over a misaligned area to move an image into alignment with its neighbor. Use a small span (e.g. 0.1) to insure that correcting one misalignment does not create others elsewhere. Several cycles of dragging the images in several locations may be needed, but with patience you can make the alignments perfect. If there are visible brightness or color mismatches at image edges, blend these together using the margin blend controls. This should be done only after the alignment has been perfected - otherwise this will cause blurring where the images do not align, making alignment corrections harder to see and control. Lastly, rescale the layout to a larger size if wanted. |
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 300+ tags hard to revise tag naming system (batch tag add / delete / replace available) risk of inconsistent naming and chaos |
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 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 2012 |
make ad hoc albums
using any criteria images can be in multiple albums or multiple times within one album |
time to locate and add
images to an album (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 good. 500K image files should be practical on a strong PC, but startup time may be 20+ seconds. |
image size | The max. supported image 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 file for editing using own GUI |
rawtherapee |
open a RAW file for
editing using own GUI (slightly better results than ufraw) |
brasero | burn a CD or DVD with selected images |
xgamma | used for the Monitor Gamma function (adjust monitor gamma) |
fotoxx-maps |
makes several geographic
maps available for reporting by clicked location |
hugin |
the function PT Panorama
uses the panorama tools utilities packaged with hugin |
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 |
/.../filename.jpg | initial image directory or image file 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, fr ...) |
-menu "func name" | -m |
startup menu function - Fotoxx will start with this function active. |
-noindex |
disable image indexing (see below for bad
implications). |
CPU 123% | current Fotoxx CPU load for all threads and processor cores |
MB 1234 |
total free memory,
including the file cache (which can be reallocated to apps) |
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 |
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. |
/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 |
/favorites | saved data for user-configuration of favorites menu |
/image_index | text files containing searchable metadata 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 |
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 | 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 image
edits |
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 |
Time |
First time index of
7898 image files |
4.5 min. |
Subsequent startup
with no new image files |
< 1 sec. |
Subsequent
startup, 493 new files to index |
18 secs. |
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 city = "Freising" (90 images) |
< 1 sec. |
Find all images
dated in 2013 with EXIF "make" = "panasonic" (342 images) |
9 secs. |
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. |