 |
@@ -53,10 +55,9 @@
|||||||||
 |
- World Maps: View a map (world,
-continent, country, city), click on a marked location to view a gallery
-of photos from that location. Requires optional package fotoxx-maps. + |  |
+ OSM Maps: View a world map, zoom in or out to any scale, click on a marked location to view a gallery
+of photos from that location. Requires good internet connection. |
 @@ -90,15 +91,12 @@ | ||
 |
- Metadata: Edit image -captions, + | Metadata: Edit captions,
comments, ratings, tags
(keywords), geotags (locations) ... Search -images using these criteria, file and directory names, dates, or any -image -data. +images using these criteria, file and directory names, dates, or any metadata. |
Areas: Select image areas to
edit
-separately. Copy and paste selections within or across images. +separately. Copy and paste within or across images. |
@@ -129,14 +127,13 @@
 |
Bend: fix -perspective, straighten curves, flatten book page, various types of +perspective, straighten curves, various types of warping ... |
 |
- Effects: posterize, -convert to drawing or painting, emboss, tiles, dots, cartoon, vignette + | Effects: posterize, make a drawing or painting, emboss, tiles, dots, cartoon, vignette ... |
 |
Undo / Redo: Left / right click for before / after view, within an edit or for each -completed edit for the current image file. | +completed edit. Middle click: see all past edits, view image at selected edit stage.|
 |
diff -Nru fotoxx-16.06/data/tags_defined fotoxx-16.07/data/tags_defined
--- fotoxx-16.06/data/tags_defined 2016-06-01 07:53:43.000000000 +0000
+++ fotoxx-16.07/data/tags_defined 2016-07-01 10:19:38.000000000 +0000
@@ -1,4 +1,4 @@
people: Mary, John, relatives,
-places: Yellowstone, NY City,
+places: Yellowstone, NY City, Italy,
things: monument, building, garden,
events: Danube cruise, 2012 Italy,
diff -Nru fotoxx-16.06/data/tags_defined~ fotoxx-16.07/data/tags_defined~
--- fotoxx-16.06/data/tags_defined~ 1970-01-01 00:00:00.000000000 +0000
+++ fotoxx-16.07/data/tags_defined~ 2016-07-01 10:19:38.000000000 +0000
@@ -0,0 +1,4 @@
+people: Mary, John, relatives,
+places: Yellowstone, NY City,
+things: monument, building, garden,
+events: Danube cruise, 2012 Italy,
diff -Nru fotoxx-16.06/data/userguide-en.html fotoxx-16.07/data/userguide-en.html
--- fotoxx-16.06/data/userguide-en.html 2016-06-01 07:53:43.000000000 +0000
+++ fotoxx-16.07/data/userguide-en.html 2016-07-01 10:19:38.000000000 +0000
@@ -10,13 +10,20 @@
+
+
+
+
+
+
+
| Fotoxx User Guide -v.16.06 | +v.16.07 best
window size ==> |
-
+
+
Fotoxx Overview
@@ -360,9 +367,10 @@ slow zoom in or out.
+ Image printing and printer color calibration tool.
- + Comprehensive user guide and help popups.
-
-
+ + Comprehensive user guide and help popups.
+
+
+
Fotoxx Usage
@@ -1629,9 +1637,8 @@ longitude). This is done in a standards-compliant manner so that data can be shared with other image management applications. Options for how to organize a large image collection can be found -in the topic Organizing Images.
-
-
+in the topic Organizing Images.
+
File View Menus
@@ -1705,10 +1712,11 @@ Icon library: Icons for many image edit functions can be found here:
/usr/share/fotoxx/icons/edit-funcs -
+
-
-
+
+
+
File Menu (File @@ -1882,7 +1890,7 @@
Set Desktop Wallpaper (File View > File > Set Desktop Wallpaper)
-This is a duplicate of the same function in Gallery View (link).
+This is a duplicate of the same function in Gallery View (link).
@@ -2028,7 +2036,7 @@ There are several alternatives for organizing a large image collection so that it can be easily searched. It would be good to review these before choosing an organization system.
-
+
View Metadata (short) (File View > Metadata > View Metadata (short))
@@ -2097,7 +2105,7 @@
+
Show Captions on Image (File View > Metadata > Show Captions on Image)
@@ -2126,11 +2134,12 @@ characters. To see up to 1000 characters, use the View Metadata function. If Show Captions switched ON, captions and comments are also displayed during a Slide -Show.
-
+Show.
Tags -Overview
+Overview
+The Edit Metadata function (below) is used to add tags to an image. Read this overview first.
+
Image files can have identification or classification tags (keywords, labels) assigned to them. These can be used to search a large image collection for those images having desired tags. @@ -2223,20 +2232,67 @@ for tags, you can type desired tag names or pick them from the list of available tags. Available tags matching the first few letters you type are shown, and you can pick from this list. You cannot -search for a tag that does not exist in your images.
-
+enter a search tag that does not exist in your images.
+
+ +Geotags Overview
+The Edit Metadata function (below) is used to add geotags to an image. Read this overview first.
+
+ +Modern cameras can record the location of each photo, using an +internal GPS receiver. Latitude, longitude, city or location, and country are +recorded in the EXIF metadata of the image JPEG or RAW file. The Edit Metadata function also allows location +data to be entered or revised for any image. The Fotoxx Search Images function can find images by +location, including an optional range: e.g. find all photos taken +within 30 km of London. Locations may also be specified by clicking +on a map. There are two functions that can find all images from a +specified location or region: Images by +Geotag: find all images for a country, a country and location, or a +country, location and date range. Images by Map Location: click on a +map to show all images within a range of the clicked +location.
+ +
Edit Metadata (File View -> Metadata > Edit Metadata)
-
-
-The menu Metadata > Edit Metadata is used to edit the most +> Metadata > Edit Metadata)
+The Edit Metadata function is used to add metadata to an image.
+Please read Tags Overview and Geotags Overview (above) before using Edit Metadata.
+
+
+
+
+
+
+descriptive information, free text
+
+
+image location data
+
+
+
+
+current image tags - click to remove
+recent tags list for convenience - click to add
+enter a few characters to get a list of
+matching tags - click to add
+
+
+
+
+
+tags to choose from - click to add
+
+Edit Metadata is used to edit the most frequently used metadata: image date and time, rating, caption, -comments, and tags. The dialog initially shows existing data for +comments, location data, and tags. The dialog initially shows existing data for the current image. After making additions or changes, press [Apply] -to update the image file. There is no file versioning for metadata -changes unless you do this yourself by saving a new version and -then modifying the metadata.
+to update the image file. There is no automatic file versioning for metadata +changes, but if you want a new version, use File Save > New Version before starting Edit Metadata.
+
+The dialog shows the metadata for the current image in File View, or +for a clicked thumbnail in Gallery View. The dialog updates itself when +a new image is opened or new thumbnail is clicked.
Existing tags are shown in Image Tags. Available tags are shown in the Defined @@ -2272,17 +2328,15 @@ can include a time using the format hh:mm[.ss]. You may enter an optional Stars rating for the image. The dialog remains open if you navigate to a -new image, and the data is updated from that image. The [Apply] +new image, and the data is updated from that image.
+
+The [Apply] button writes the data to the image file and to the metadata index file used for searching images.
-
-The button [Prev] can be used to load all available data from the +The [Prev] button can be used to load all available data from the previous image viewed or edited. This can be used to speed-up the processing of a group of images sharing much of the same data.
-
-The button [Manage Tags] starts the Manage Tags dialog shown immediately below.
-The button [Geotags] starts the Edit Geotags dialog shown below.
-
Manage Tags
+The [Manage Tags] button starts the Manage Tags dialog.
Manage Tags Dialog
This dialog starts from the button [manage tags] in the Edit Metadata dialog. You can also assign categories to tags to help organize them and locate them @@ -2305,7 +2359,126 @@
Use the [orphan tags] button to list tags that are defined but not assigned to any images. These may be deleted if no use is -planned.
+planned.
+Adding Geotags
+The Edit Metadata dialog shows the location data for the current image, +if +any. For an +image with missing or incorrect location data, enter a location name +(city, park, museum ...) and use the [Find] button to either complete +the data in the +dialog, or get a list of matching locations to choose from (e.g. +London, United Kingdom and London, Canada). The list of locations comes +from your image files, so a location will not be known until it is +assigned to an image for the first time. 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 metadata +index file for later searching by location. Use the [Prev] button +to fill the dialog data with the last +location used. If the [Find] button does not find a location (it is not +present in any other image), you can use the [Web] button to find +the location data from an internet web service (MapQuest +Open for now, but this could change). The location data is +completed and returned into the dialog. These names are not +standardized in format or language, 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 find +the location using an internet service, and enter the location data +into the dialog. Pressing [apply] will add the data to the current +image and make the location available for future use.
+ + +
+ + +Here are two web sites to look-up a location / country (there are many +others):
+ + + +http://www.worldatlas.com/aatlas/findlatlong.htm
+ + + + http://brainoff.com/geocoder/ +
+ + + +
+ + +Blank the latitude and longitude if you want to save only the location +and / or country name in the image file. If the latititude / +longitude data is changed from the values returned by [Find], these +values are saved and will be used from now on for new entries for +this location. Previous images with the same location are not revised. You +can use Images by +Geotag to find all images for a location, and +Batch Add Geotags to change the latitude / longitude for all of +them.
+ + +
+Note: Non-English locales: If a comma is used for a decimal point +in latitude / longitude, this is accepted but converted to a period +internally. The web service returns periods.
+ + +
+ + +Note: If a location is saved without latitude / longitude, there will +be no "red dot" to mark the location on a map, and finding photos for +this location by clicking on a map will not work (Images by Map +Location). The other method to find photos by location, Images by Geotag, will still work.
+
+Note: The EXIF keyword "city" is used to mean any location name: city, +park, museum, lake, etc. Fotoxx uses the term "location" to avoid +confusion (e.g. city = Yellowstone Park). When retrieving or saving +metadata, either term may be used. Internally, "location" is converted +into "city" for metadata storage or retrieval.
+ + +
+ + +If you change to one of the map views and click on a location, this location will be inserted into the Edit Metadata dialog.
+ +
+You can use Batch Add Geotags (see below) +to quickly add location data to many image files at once.
+ + +
+ + +
| 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. |
Edit Any Metadata (File @@ -2320,7 +2493,7 @@ You may enter the key name in lower case and with or without spaces between the words, e.g. "Bits per Sample" and "bitspersample" will both work. To see all present keys and data, use View Metadata (long).
-
+
Delete Metadata (File View > Metadata > Delete Metadata)
@@ -2357,7 +2530,7 @@ only those tags will be shown in the list of defined tags. If your tags list is huge, this can reduce the list to a manageable size for pointing and clicking.
-
+
Batch Rename Tags (File View > Metadata > Batch Rename Tags)
@@ -2393,8 +2566,7 @@ which you can edit to add other keys to the list. The [Full List] button provides information on how to get a list of all available -key names.
-
+key names.
Batch Report Metadata (File View > Metadata > Batch Report Metadata)
@@ -2414,157 +2586,40 @@ can be left or deleted). When [proceed] is pressed, all selected files are searched for all the selected metadata items. A tabular report is produced in the text file /home/<user>/.fotoxx/metadata_report -and displayed in your standard text editor.
-
-
-Geotags Overview
-Modern cameras can record the location of each photo, using an -internal GPS receiver. Latitude, longitude, city and country are -recorded in the EXIF metadata of the image JPEG or RAW file. The -Fotoxx Edit Geotags function (immediately below) allows location -data to be entered or revised for any image. The Fotoxx Search Images function can find images by -location, including an optional range: e.g. find all photos taken -within 30 km of London>. Locations may also be specified by clicking -on a map. There are two functions that can find all images from a -specified location or region: Images by -Geotag: find all images for a country, a country and city, or a -country, city and date range. Images by Map Location: click on a -map to show all images within a range of the clicked -location.
-
-
-Edit Geotags (File View -> Metadata > Edit Metadata, [Geotags] button)
-
-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. -London, United Kingdom and London, Canada). 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 metadata -index file 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 not -present in any other image), you can use the [Web] button to find -the city and location data from an internet web service (MapQuest -Open for now, but this could change). The location data is -completed and returned into the dialog. These names are not -standardized in format or language, 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.
-
-Here are two web sites to look-up a city / country (there are many -others):
- -http://www.worldatlas.com/aatlas/findlatlong.htm
- - http://brainoff.com/geocoder/ -
- -
-Blank the latitude and longitude if you want to save only the city -and / or country name in the image file. If the latititude / -longitude data is changed from the values returned by [Find], these -values are saved and will be used from now on for new entries for -this city. Previous images with the same city are not revised. You -can use Images by -Geotag to find all images for a city, and -Batch Add Geotags to change the latitude / longitude for all of -them.
-
-Note: If the location name is not a city (e.g. Yellowstone Park), -simply use this name for the City input.
-
-Note: Non-English locales: If a comma is used for a decimal point -in latitude / longitude, this is accepted but converted to a period -internally. The web service returns periods.
-
-Note: If a city is saved without latitude / longitude, there will -be no "red dot" to mark the city on a map, and finding photos for -this city by clicking on a map will not work (Images by Map -Location). The other method to find photos by city, Images by Geotag, will still work.
-
-If you change to one of the map views and click on a location, this location will be inserted into the dialog.
-For a series of photos made in the same location, you can quickly -add location data. After getting the location data for the first -image, use the [Next] button to open the next image, then the Edit -Geotags [Prev] button to fetch the previous location data, then the -[Apply] button to save into the current image file. If there are -many photos, you can use Batch Add Geotags (see below) -to quickly update all of them.
-
-
| Summary: - + Open an image file and select the Edit Geotags menu. - + Enter (or change) a city name (possibly abbreviated) -in the dialog. - + Use [find] to find the city 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 -city. - + 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. - + Open the next image (use the [prev/next] button if -appropriate). - + Use the [prev] and [apply] buttons to add the same -location data again, if wanted. |
-
+and displayed in your standard text editor.
Batch Add Geotags (File View > Metadata > Batch Add Geotags)
-
+
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, using the buttons [Find] [Web] and [Prev], or one of the map views. Press [proceed] -to start the update process. Use this function also to correct city -/ country spellings or latitude / longitude data, or to fix -inconsistencies.
-
+Then get the location data as described above in Edit Metadata, using the buttons [Find] [Web] and [Prev], or one of the map views. Press [proceed] +to start the update process. Use this function also to fix inconsistencies in location spellings or latitude / longitude data.
+
Images by Geotag (report) (File View > Metadata > Images by Geotag)
-
-This is a fast way to find all photos made in a given country or -city and country. In the dialog, select the desired level of -grouping: by country, by country and city, by country and city and +
+
+This is a fast way to find all photos made at a given location. In the dialog, select the desired level of +grouping: by country, by country and location, or by country and location and date. In the last case, you can select a date range for grouping of images having nearby dates. A number N will group images with dates that are N days or less apart from other images in the group (i.e. gaps are <= N days).
-
A popup window shows all cities +
A popup window (geotag groups) +shows all locations found in the image geotags, and the -dates of photos taken in those cities. The count of photos taken is -also shown. In the above example, 9 photos are from Grossglockner -starting Oct. 19, 2005. Click on a line in the window to get a +dates of photos taken in those locations. The count of photos taken is +also shown. In the above example, 30 photos are from Canberra made in +November 2004. Click on a line in the window to get a thumbnail gallery of those images, and from there you can click on -any image to view or edit. Note that this method uses only city and +any image to view or edit. Note that this method uses only location and country to find the images. Earth coordinates are not used. If you have -images with missing or inconsistent earth coordinates for a given city -(or location), use this function to get all of them, and then use Batch Add Geotags to make the earth coodinats consistent.
+images with missing or inconsistent earth coordinates for a +given location, use this function to get all of them, and then use +Batch Add Geotags to make the earth coodinats consistent.
Search Images (report) @@ -2574,28 +2629,48 @@ it possible to search thousands of images per second. The index contains a subset of the EXIF and IPTC metadata in the image files. Some of this data is automatic, created by the camera. Other data, -such as tags and star ratings, can be added by the user.
-
-An example search: find all images dated 2006 or later, rated with -4 stars or more, having tag "buildings" and geotag "Dresden". The -output report for this search is shown here:
-
+such as tags and star ratings, can be added by the user.
+
+There are two report formats: a gallery of thumbnails showing all +images that match the search criteria, or a metadata report which +combines thumbnails with metadata text. Here is an example of the +metadata report format:
+
-Search Images -Dialogs
-
+Search Images +Dialogs
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The main dialog is on the left. If the button "search other metadata" -is used, the dialog on the left appears. This can be used to select +is used, the dialog on the right appears. This can be used to select metadata that is not available in the main -dialog.
+dialog. Details are given below.
In the main dialog, select which images to search, either all (the entire image database) or current set, meaning the -images in the current gallery list (can be a directory, album, or -the results of a prior image search). Then choose what to do with +images in the current gallery list, which can be a directory, album, or +the results of a prior image search. Then choose what to do with the matching images found: new set means replace the current set with the images found, add means add them to the current set (gallery), and remove means remove them from @@ -2608,7 +2683,7 @@ criteria. The metadata report has both thumbnail images and a list of metadata items beside each thumbnail. These are some standard items (date, rating, tags, geotags, captions, comments) and any -items you added in the metadata selection dialog.
+items you added in the optional search metadata dialog.
Enter your search criteria. Select desired tags, dates, star ratings, text (comments, captions), file or directory names, and location names. @@ -2674,30 +2749,75 @@ captions of all images, and matching images are selected. Substrings will also match.
-To search locations, enter one or more city or country names in the search locations +To search locations, enter one or more location or country names in the search locations field. Only image files with geotags matching one of the entered -locations will be selected. Both city and country names can be used.
+locations will be selected.
The radio buttons all and any apply to tags, text, and file names. You can select images having ALL the entered strings, or ANY of the entered strings. Example: if the search file field contains [egypt cairo] and any is selected, then image files with either of these names within the directory or file name would be selected.
+
+If +you wish to find missing data, you can enter "null" as a match value. "null" is available in the defined tags list.
+
Search Metadata Dialog
You may use this dialog to search for "extra" metadata items not present in the main dialog. The items available for any given image -file can be shown using View Metadata (long). These +file can be shown using View Metadata (long). +These include camera make and model, exposure time, F-number, ISO, metering mode, focal length, shooting mode, etc. etc. You can enter shortcut names like "exposuretime" instead of "Exposure Time". You may also enter match criteria, if wanted, so that only the images with matching metadata are reported. For example, if you enter "model" with the match value "DMC-FZ28" (a Panasonic camera) then -only the images taken with this camera will be reported. You can -also enter multiple match values for one key, separated by -blanks. If you wish to find missing data, you can enter "null" as a search value.
-
+only the images taken with this camera will be reported.
+
+The matching logic can be selected for each metadata key:
+
| 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 + |
+
Performance
If no extra metadata to report is entered, then many thousands of images per second are searched and reported (assuming a strong PC). @@ -2707,16 +2827,13 @@ metadata index. For good performance, always use dates, file names, etc. to maximize the use of the metadata index and minimize the number of image files that must be read.
-
-Missing Metadata
-You can find images with missing metadata by using "null" as a search -value. "null" for tags is available in the defined tags list.
There is a separate topic, image organization options, which explains the options for using directory and file names and metadata for image searching.
-
+
+
Area Menu (File @@ -2760,8 +2877,7 @@ can be exited and re-started later to modify an existing area or start a new one.
-Line Drawing -Color
+Line Color
The color used for the mouse selection circle and the area outline can be changed at any time by clicking one of the color buttons. This allows you to maintain good contrast during pixel selection, @@ -3019,26 +3135,23 @@ outlines and resume editing the area.
Finish
-
-When -you are finished selecting the enclosed spaces, use the [Finish] +
+An area is not +effective for edits until it is successfully finished. The finish +process finds all the areas enclosed by your drawn outlines. When +you are finished outlining areas, use the [Finish] button to complete the process. A popup dialog will ask you to -click the mouse inside each enclosed space in sequence. The enclosed -spaces are temporarily colored so you can verify that the final result -is what you intended. Press [Done] when all selected areas have been -clicked and filled-in.
-When an enclosed area is clicked, all pixels within the enclosed space are mapped and saved. The enclosed space is temporarily -colored so you can see exactly what part of the image is being -selected. The dialog will show the status of the search, "success" -or "outline has a gap". If there is a gap in the outline, an -attempt is made to show where the gap is: you will see a line -coming out of the colored space to meet the edge of an imaginary -rectangle enclosing the space. You may be able to follow this line -back to the gap, but if the area is convoluted finding the gap can -be difficult. Each use of [finish] will produce a different picture -that may lead you to the gap. Carefully inspect the outline of the -area, close the hole, and use [Finish] again. An area is not -effective for edits until it is successfully finished. Any enclosed +click the mouse inside each enclosed area in sequence. The enclosed +areas are temporarily colored so you can verify that the final result +is what you intended. Press [keep] when all selected areas have been +clicked and correctly colored. Press [Undo] if a colored area does not +match your intention - the original area outline is restored. If the outline of an enclosed area has a gap, the +pixel selection and coloring process will "leak out" and areas outside +the enclosure will be colored. In this case, press [Undo] to go back to +the original outline. Find the gap in the outline and close it, +then try [Finish] again. See the function Find Area Gap below for a fast method to find gaps.
+
+Any enclosed area can be selected, even those not explicitly outlined - if you have a donut with a hole, you can select the donut, the hole, or both.
@@ -3049,17 +3162,12 @@ areas selected with one of the line drawing methods are mapped only when you click inside them.
-If you select any of the four extend to corner options, the -area outline is automatically extended to the corner from drawn -lines that meet the image edges. This avoids the work of drawing -the area outline along the image edges to the corner. Example: to -select the sky, draw the boundary line between sky and ground, -meeting the left and right edges of the image. Then select the -upper left and right corners in the Finish dialog. The entire sky -area will be selected, without having to outline the rest of the -sky.
-
-Disable / +If you draw a line from one image side to another, you can click on +either side of the line to make an area of all pixels on that side of +the line. Example: draw a horizontal line on the boundary between sky +and land. Click above the line to select sky, below the line to select +land.
+
Disable / Enable
Disable the current area and keep the data so that it can be re-activated later. This allows you to alternate edits within a @@ -3074,6 +3182,81 @@
Unselect
Discard the current area permanently.
+
+
+Find Area Gap (File View > Areas > Find Gap)
+If an area outline was created by freehand drawing using multiple +strokes, it is easy to leave small gaps in the outline that are not +visible below 400% zoom. An attempt to finish such an area will fail +because the mapping of the interior pixels will leak out through the +gap and cover large areas not intended as part of the area. If the Finish +functioin fails, use this function to find the gap. Click somewhere on +the outline of the failed area. The outline will be re-drawn in one +direction from the clicked position, until an "end pixel" is found. +This is where the gap is. The function will stop for 2 seconds so you +can see where it stopped drawing, and then the entire area outline will +display again. If you click again near the same position, the outline +will be re-drawn in the opposite direction, again stopping where an +"end pixel" is found. Use the freehand draw tool to close the gap, then +test again to see if the full outline can be drawn without stopping. +This function can be used in parallel with the Select Area function.
+
+ +Select Hairy (File View > Areas > Select Hairy)
+ +
+Selecting a Hairy Boundary
+ +The circle shows the mouse position and radius.
+ +
+The hair has been selected.
+The background has been made transparent.
+ +
This is an area selection function for complex boundary +cases like hair +or bushy plants, where selection by color may not work well, and +freehand draw would need too much effort. The objective is to make the +background transparent and leave the foreground opaque, or partly +transparent where thin structures fade into the background.
+
+Follow these steps:
+ +
-
+
- Choose a window background color (User Options)
+that contrasts with the complex area to be selected. In the example
+above, a white background was chosen to contrast with the darker hair.
+ - Select the entire area to be copied, including the complex boundary areas.
+ - Set a suitable mouse radius for painting over the boundary areas.
+ - Set initial match levels. 40% and 80% are good starting points.
- Choose Select.
+
+ - Click on an area representative of the colors to be selected, but
+away from the irregular edge. About 200 pixels will be sampled from the
+clicked position. These are used to determine which colors will be selected.
+
+ - Left-drag over the boundary area. Unselected pixels are converted +to the window background color, allowing you to see more clearly which pixels are +being selected. +
- Choose Deselect. +
- Click on a background area. A narrow set of colors are chosen that will be made transparent. +
- Left drag over the boundary area. Matching background colors are made transparent.
+
+ - Adjust match level and click on different colors to get the +right balance between selected and unselected pixels. These settings +can be changed as needed for different parts of the selection. +
- If the background color varies, click on each background color
+and drag to make it transparent. The area affected will be smaller or
+larger for match level set higher or lower, respectively.
+
+ - Use right drag to unselect (restore original image), left drag to re-select.
- When done, save the completed area with the Copy button (for subsequent Paste Area) or the Save button (for subsequent Open Area File).
+ - To paste the area into another position or image, use the menu Paste Area or Open Area File.
+
+
+
+When the area is pasted into the target image, +the paste dialog can be used to further blend the edges if needed.
Area Show / Hide (File View @@ -3123,8 +3306,7 @@ Area Open and Save (File View > Areas > Open Area File, Save Area File)
-A selected area can be saved to an image file using the menu Select -> Save Area File. You are asked to supply a file name. A PNG +A selected area can be saved to an image file using the menu Save Area File. You are asked to supply a file name. A PNG file is created. The PNG file has an alpha channel (a 4th 'color') for transparency information. The image is a rectangle enclosing the selected area. Selected pixels are opaque, and others are @@ -3132,15 +3314,16 @@ /home/<user>/.fotoxx/saved_areas by default, but you can save them anywhere.
-Use the menu Select > Open Area File to paste a saved area onto +Use the menu Open Area File to paste a saved area onto the current image file. The background image will show through the transparent parts of the pasted area. Click and drag to position the area. The dialog controls can be used to resize, rotate, and change the brightness of the pasted area. The edge blend control allows you to blend the area edges into the background image if -wanted.
-
-
+wanted.
+
+
+
Edit Menu (File @@ -3774,9 +3957,9 @@ /home/<user>/.fotoxx/plugins which you can modify with a text editor if desired. This is the only way to change the sequence of the menu entries. Be careful not to screw up the -format.
-
-
+format.
+
+
Repair Menu @@ -3844,7 +4027,7 @@
Denoise Image (File View > Repair > Denoise)
-
+
This function reduces the noise in photos taken under poor lighting conditions, making uniform surfaces appear speckled. It also works for scanned prints, as in the example here. Multiple methods are @@ -3874,18 +4057,12 @@ reduce noise. More information can be found in the technical notes.
Here is a short technical description of each method:
-
-
| Flatten -1 | -The highest and lowest -pixel values within a radius are moderated slightly. | -||||||||
| Flatten -2 | + Flatten + |
Pixels are compared to the
mean and sigma of pixels within a radius. Those outside one sigma are moved slightly back toward the @@ -3900,25 +4077,21 @@ Top Hat |
Detect outliers by
-comparison with a band of pixels at a distance. |
+limit.+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 |
-Image brightness (with
-noise) over distance is converted into a series of wave functions
-that nearly sum to brightness and represent an approximation with
+ | RGB brightness (with
+noise) is converted into a series of wave functions
+that |
+nearly sum to brightness and represent an approximation with less noise.
- Threshold |
-Uses the threshold value to
-distinguish pixel noise from image features, and an algorithm to
-adjust initial pixel classifications based on neighboring pixel
-classifications. |
- |
@@ -4422,8 +4595,9 @@ paper sheet or blank wall that is underexposed to come out gray. This image can be used to find both bright and dark stuck pixels.
-
-
+
+
+
Bend Menu (File @@ -4601,8 +4775,10 @@ the [done] button. This function works best when the selected area(s) are small in comparison to the entire image. The pixel rows and columns that intersect the selected areas are not changed. Other areas are -compressed as the image is pulled inward.
-
+compressed as the image is pulled inward.
+
+
+
Effects Menu @@ -4987,8 +5163,9 @@ Tilt-Shift Effect: You can do this by selecting a horizontal rectangular area to remain sharp.
-
-
+
+
+
Combine Menu @@ -5557,8 +5734,9 @@ select any step to go back to
+ use the escape key to abandon the list without making any selection
-
-
+
+
+
Tools Menu @@ -5629,7 +5807,7 @@ Options)
Various user preferences and settings are collected in this dialog.
-They are also saved in the file +They are also saved in the file /home/<user>/.fotoxx/parameters.
@@ -5665,6 +5843,13 @@
+
+This is the color outside image margins when image width and height do not fit the window.
+
+
capture distance
-See the man page for dcraw for more details.
MB: total allocated memory at this time in megabytes
-
+
+
@@ -6161,7 +6341,8 @@ About
This displays a short message about the Fotoxx version number, license, credits, and contact address.
-
+
+
@@ -6188,7 +6369,7 @@ Albums)
An album is an arbitrary sequence of images that is manually assembled from existing images. This is one method to make groups -of associated images. An image album is simply a list of the member +of associated images. An album is simply a list of its member image files. The image files themselves are not copied or changed. A given image file can be a member of multiple albums, or may be present more than once within an album. Albums can be used to group @@ -6200,8 +6381,7 @@ gallery works like any other: you can scroll through the gallery, step through the images with the [Prev/Next] button, or edit the images. Keep in mind that editing an image in an album will edit -the unique image file, so any other way to view this image will -show the same image.
+the underlying image file, so any other way to view this image will show the same changes.
Image Cache
@@ -6333,14 +6513,23 @@ gallery. After closing this dialog, the gallery reverts to the chosen album. Right-click an album thumbnail and select one of the Paste menus to insert the selected images. You can also choose -another album and insert the images if you did not clear the +another album and insert the same images if you did not clear the cache.
+Using two parallel Fotoxx sessions
+Adding many images to an album can be made faster and easier by using +two Fotoxx sessions. Session1 serves as a source of images, while +session2 keeps the album open to receive images from session 1. In +session 1, navigate to the galleries having source images, right click +desired thumbnails and choose "Copy to image cache". In session 2, +right click between the thumbnail where the cached images will be +inserted and choose "Paste image cache here (clear)".
+
+TIP
If image files are renamed or moved using Batch Convert, and if deletion of the original image files was also specified, then all albums containing any of the input files are updated to reflect the @@ -6772,16 +6961,15 @@ [Proceed]
-Batch RAW (DCraw) -(Gallery View > Batch > -DCraw)
-Batch RAW (Raw Therapee) -(Gallery View > Batch > Raw +Batch RAW +(Gallery View > Batch > Batch RAW)
+Batch Raw Therapee +(Gallery View > Batch > Batch Raw Therapee)
-
+
These functions convert selected RAW image files to JPEG, PNG-8, -PNG-16, TIFF-8 or TIFF-16 format, using the program DCraw or Raw -Therapee. The PNG and TIFF formats have either 8 or 16 bits per +PNG-16, TIFF-8 or TIFF-16 format, using the library program libraw or the application program Raw +Therapee. The PNG and TIFF formats have either 8 or 16 bits per color. RAW files generally have 10-12 bits per color, and noise beyond that. Therefore use a 16-bit format to keep all of the data available from a RAW file. The difference between 8- and 16-bit @@ -6795,19 +6983,11 @@ Choose one of the downsize options if wanted, and set the auto sharpen parameters if wanted. See the Sharpen function for an explanation of these parameters.
-
-The remaining parameter options (white balance etc.) apply only to -DCraw - they are not shown if Raw Therapee is used, because -parameter settings for batch operation are not available (defaults -are used). The default settings for DCraw generally work well and -you probably will not need to change them. The parameters for DCraw -are documented in the man page ($ man dcraw).
-
-The image files are converted one at a time and displayed in the +
The image files are converted one at a time and displayed in the main window. Depending on the number of files, this can take a long time (a strong PC does about 40 files per minute for most RAW file types and TIFF-16 output). PNG-16 produces much smaller files than -TIFF-16 because the files are compressed (with no data loss). This +TIFF-16 because the files are compressed (with no quality loss). This also needs more time to do the compression work.
@@ -7148,7 +7328,8 @@
+
+
Organizing Images for Efficient Searching
@@ -7257,7 +7438,7 @@ date range and location without you having to enter any data for each image. You can leave it at this, or add some of the above extras if you accept the extra effort required. My experience so -far with city / country via GPS is that the names are chaotic and +far with location / country via GPS is that the names are chaotic and you may want to sanitize them (upper/lower case, with/without states or other political subdivisions, mixed languages, etc.). You can fix the mess with a little effort: search for the location you @@ -7395,7 +7576,8 @@
-
+
+
Translations
@@ -7489,16 +7671,34 @@ convert to HTML and supply the images. If you make a new or revised translation, please send it to me [contact] so it can be included in future releases.
-
-
+
+
Recent Changes
This section is provided to help you quickly review the changes without reading the whole manual.
Fotoxx version numbers correspond to year and month of release.
-
-v.16.06 (this release)
+
+v.16.07 (this release)
+
-
+
- Search Images: more flexibility for specifying metadata select criteria.
+
+ - Select Area: the Finish function was simplified and the Find Gap function was added.
+
+ - Select Hairy: a new function to select objects with complex boundaries.
+
+
+ - User Options: an option was added to set the window background color.
+
+ - Manage Albums: a new capability was added to use two parallel Fotoxx sessions.
+
+
+
+
+
- Right-click popup menus for File and Gallery views now include Show on OSM Map.
@@ -7813,8 +8013,9 @@ - Magnify function: the user interface was
made more flexible.
-
+
+
+
Technical Notes
@@ -7852,8 +8053,7 @@ constants).