From f3db298465f3399e046ae385ed33699e791f9f03 Mon Sep 17 00:00:00 2001 From: Berthold Stoeger Date: Wed, 20 Jun 2018 18:56:31 +0200 Subject: Manual: Adapt description of "find moved images" functionality Adapt description and add example image. Signed-off-by: Berthold Stoeger --- Documentation/images/FindMovedImages1.jpg | Bin 0 -> 218092 bytes Documentation/user-manual.txt | 39 +++++++----------------------- 2 files changed, 9 insertions(+), 30 deletions(-) create mode 100644 Documentation/images/FindMovedImages1.jpg diff --git a/Documentation/images/FindMovedImages1.jpg b/Documentation/images/FindMovedImages1.jpg new file mode 100644 index 000000000..7f607af78 Binary files /dev/null and b/Documentation/images/FindMovedImages1.jpg differ diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index b0202022b..02379fe18 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -1898,40 +1898,19 @@ in order to find it when the dive is opened again. If the photo or the whole photo collection is moved to another drive or to a different machine, the path to the photo changes. Now, _Subsurface_ looks for the photos at their original location before they were moved, cannot find them and cannot display them. Because, after moving photos, large numbers of photos - may need to be deleted and re-imported from the new location, _Subsurface_ has a mechanism to ease this inconvenience: automatic updates using fingerprints. - -When a photo is loaded into _Subsurface_, a fingerprint for the image is calculated and stored with the - other reference information for that photo. After moving a photo collection (that has already been loaded - into _Subsurface_) to a different directory, disk or computer, _Subsurface_ can: - -- look through a particular directory (and all its subdirectories recursively) where photos have been moved to, -- calculate fingerprints for all photos in this directory, and - -- if there is a match between a calculated fingerprint and the one calculated when a photo was -originally loaded into _Subsurface_ (even if the original file name has changed), automatically update the directory information so that _Subsurface_ can find the photo in the new moved directory. + may need to be deleted and re-imported from the new location, _Subsurface_ can locate the photos based on their filename and path. This is done by selecting from the Main Menu: _File -> Find moved images_. This brings up a window within - which the NEW directory of the photos needs to be specified. Select the appropriate directory and click - the _Scan_ button towards the bottom right of the panel. The process may require several minutes to - complete, after which _Subsurface_ will show the appropriate photographs when a particular dive is opened. - - -[[Image_fingerprint_upgrade]] -**** -*Upgrading legacy photo collections without fingerprints* -[icon="images/icons/important.png"] -[IMPORTANT] - -_Subsurface_ automatically calculates fingerprints for all images that it can access. -When manipulating images, ensure that all the images associated with the dive log can be accessed by _Subsurface_. +which the searching of the images can be controlled. The search is started by clicking on _Select folder and scan_. +Since photos taken with different cameras might have the same filename, the names of the parent folders are likewise compared. +Therefore, the root folder of the NEW picture collection should be chosen. For finer control, it is possible to search +only for photographs of the currently selected dive(s) by selecting the appropriate option. -_Subsurface_ automatically checks and, if necessary, updates the fingerprints associated with a single dive if: +After the searching has finished, the original filenames and the new locations of the photographs will be shown. +The matching parts of the paths are emphasized. Photographs that are found at their known positions are +not listed. The proposed changes can be applied by clicking _Apply_ or rejected by clicking _Cancel_. -- The images associated with that dive are visible as thumbnails on the *Dive Profile*. - -- If you edit anything in the *Notes* panel and save the edits by selecting _Apply changes_. - -**** +image::images/FindMovedImages1.jpg["FIGURE:Find moved images",align="center"] === Logging special types of dives -- cgit v1.2.3-70-g09d2