Merge pull request FrankBijnen#353 from FrankBijnen/Development

Development

Docs/ExifToolGUI_V6.md

@@ -81,6 +81,7 @@ Basic idea behind GUI is, to keep it <u>simple!</u> Thus, only those options are
 <li>Português</li>
 </ul>
 <li>Starting with V6.3.0 an installer is provided.</li>
+<li>Support for Exiftool features <u>geolocate</u> and <u>-api geolocation</u>.</li>
 </ul>
 <a href="changelog.txt"><b>See changelog.txt for a complete list of issues.</b></a>
 
@@ -89,7 +90,7 @@ Basic idea behind GUI is, to keep it <u>simple!</u> Thus, only those options are
 ExiftoolGUI should run on Windows 7, 8 32-64bit. However, it is highly recommended to use Windows 10 or 11 when you plan to use the OSM map, or GEOcoding.<br>
 It will not run on Windows XP or earlier!<br>
 
-You can use the installer to install ExifToolGui and all required components. If you do you can skip the requirements. <br>
+If you use the installer to install ExifToolGui that should take care of all required components, and you can skip this section.<br>
 
 The portable version is still available, and will be continued to be released. Read the following requirements. 
 
@@ -181,12 +182,7 @@ That's all you need. And when a new ExifTool or GUI version is available, you on
 <li><a href="#m_exp_imp">Export/Import</a> menu</li>
 <li><a href="#m_modify">Modify</a> menu</li>
 <li><a href="#m_various">Various</a> menu</li>
-<li><font class="blue">Help</font></li>
-<ul>
-<li><u><font class="blue"> Online Documentation</font></u> Opens this document</li>
-<li><u><font class="blue"> Check versions</font></u> Check for updated versions of GUI and ExifTool </li>
-<li><u><font class="blue"> About</font></u></li>
-</ul>
+<li><a href="#m_help">Help</a> menu</li>
 <br>
 <b>Panels:</b><br>
 <li><a href="#p_filelist">Filelist</a> panel</li>
@@ -197,9 +193,6 @@ That's all you need. And when a new ExifTool or GUI version is available, you on
 <a href="#final">Final words</a><br><br>
 
 <h2><a name="m_program">Program menu</a></h2>
-<h3>About</h3>
--Displays ExifTool and GUI versions and links.<br>
-<br>
 <h3>Preferences</h3>
 <img src="ExifToolGUI_V6_files/preferences_general.jpg"><br>
 <br><br>
@@ -264,7 +257,8 @@ In the next dialog keep only 'Thumbnail' checked, and click on OK.</li>
 <br><br>
 <b><u>GeoCoding</u></b> settings tab<br>
 <br>
-Here you can setup the GeoCoding parameters. Typically you only have to check <b>Enable GeoCoding</b><br>
+Here you can setup the GeoCoding parameters.<br>
+Getting started: <a href="Readme GeoCoding Getting started.txt"><b>Readme GeoCoding Getting started.txt</b></a><br>
 For an in-depth explanation see <a href="Readme GeoCoding.txt"><b>Readme GeoCoding.txt</b></a>
 <br><br>
 
@@ -475,6 +469,8 @@ next GUI start. Remaining options settings however, are only temporary
 
 <h3>API WindowsWideFile (requires Exiftool v12.66)</h3> -Force the use of wide-character Windows I/O functions when the CharsetFileName option is used.<br>
 
+<h3>API LargeFileSupport</h3> -To process files larger than 2GB. Video's for example.<br>
+
 <h3>Custom options</h3> -You can specify additonal options that exiftool should use. Expert option. Normally used with the Log Window.<br>
 Possible use case is the option <b>-htmldump</b> and use the log window to catch the output. Or <b>-API LargeFileSupport=1</b> to support large files.<br>
 <br>
@@ -675,7 +671,8 @@ For every selected file a lookup is done using the selected provider. To reduce
 In the dialog you can customize how the fields are filled.<br><br>
 <img src="ExifToolGUI_V6_files/updatelocationfromgps.jpg"><br><br>
 Notes:<br>
-- Due to the nature of this function, it uses an external webservice, there are some 'point of failures'.<br>
+- If you use Gecode provider 'Exiftool geolocation' no internet connection is required.<br>
+- The other providers use an external webservice, and thus there are some 'point of failures'.<br>
 <ul>
 <li>You need a reliable internet connection.</li>
 <li>The external webservice could be (temporarily) out of service for various reasons.</li>
@@ -706,6 +703,17 @@ In addition you have more control over how the function is performed.<br><br>
 <br>
 <br>
 
+<h2><a name="m_help">Help menu</a></h2>
+<h3>Online Documentation</h3>
+-Opens this document<br>
+
+<h3>Check versions</h3>
+-Check for updated versions of GUI and ExifTool <br>
+
+<h3>About</h3>
+-Displays ExifTool and GUI versions and links.<br>
+<br>
+
 <h2><a name="p_filelist">Filelist panel</a></h2>
 <img src="ExifToolGUI_V6_files/filelistpanel.jpg"><br>
 <br>
@@ -902,7 +910,7 @@ Here's how to edit metadata in <font class="blue">Workspace</font>:
 <br>
 If you've changed your mind and don't wish to change particular tag,
 then select that tag, right-click (to show pop-up menu) and choose <font class="blue">Undo selected editing</font> -this is usefull in cases when many tags are allready edited and not saved.<br>
-If you've changed your mind completely (don't wish to apply any changes), then just click on <font class="blue">Workspace</font> button and changes will dissapear.<br>
+If you've changed your mind completely (don't wish to apply any changes), then just click on <font class="blue">Workspace</font> button and changes will disappear.<br>
 <u>Note:</u> Changes are lost in most cases when you click elsewhere outside Metadata view area.<br>
 <br>
 <li>When you're finished with editing metadata values, click on <font class="blue">Save</font> button.</li>

Docs/ReadMe for Developers.txt

@@ -97,4 +97,16 @@ Changed TFileStream to ThandleStream in ExifInfo.pas. To open the file ourselves
 
 Fixed typo in BreadcrumbBar directory name
 
+Version 6.3.0
+
+Added an installer. To build the installer yourself, you will need to install InnoSetup.
+Created an RC file to hold some constants, mostly related to URL's
+Added commandline parm /IniPath=
+Layout changed, to accomodate for larger texts in other languages.
+Style fixes. Change the background color of the ShellList selected line. Also for the BreadCrumbBar. Silver.vsf was changed.
+Fixed OpenPictureDialog. Use WIC if default fails.
+Added option to add custom ExifTool config
+Added geolocate -api geolocation features
+Dont throw error in Finalization. Causes memory leaks etc. Allow for 3 retries deleting temp dir
+
 Frank

Docs/ReadMe for Users.txt

@@ -128,4 +128,16 @@ Changed with version 6.2.9
 - Added a tray icon in the windows taskbar to reset the window size to default. You need to make sure the icon is not hidden in Windows.
 - Optionally show hidden files and folders. You need to be an admin and enable the option in Preferences.
 
+Changed with version 6.3.0
+- A nasty bug was fixed that would prevent the OSM map to display if the GPS coordinates had negative values. (West or South)
+- Created an installer. Recommended if you dont use ExifToolGui as a portable program.
+- Added version checks for ExifTool and ExifToolGui. See Help/Check Versions.
+- The About form was moved to Help/About
+- Translations available, when installed via the installer. The language will be selected according to your Windows settings.
+  Or use the commandline parm /Lang=xxx (NLD, DEU, FRA, ITA, PTB, ESP ENU) to force a specific language.
+- Style fixes for darkmode styles. The selected file(s), folder are now clearly visible.
+- Added support for ExifTool -geolocate and -api geolocation.
+  For better compatibility with the new ExifTool features the location found is stored differently. For more details see: Readme GeoCoding.txt
+- Added the option to specify a custom ExifTool Config
+
 Frank

Docs/Readme 4K monitor.txt

@@ -2,7 +2,7 @@ Notes on using 4K (HighDpi) monitors.
 
 History:
 Initially Issue #199 tried to improve 4K support.
-- The defaults where /HighDpi=SystemAware and no scaling.
+- The defaults were /HighDpi=SystemAware and no scaling.
 
 More testing resulted in Issue #216, and changing the defaults to:
 - /HighDPI=PerMonitorAwareV2 (Windows 10, or higher), /HighDpi=PerMonitorAware (Windows 8.1 or higher).
@@ -18,7 +18,7 @@ The problem with 4K monitors is that they typically have a higher DPI than 96, t
 The result could be that items look too small, or not correctly positioned, or even be unreadable.
 
 Previous versions of Delphi used scaling to overcome that.
-The problem with scaling, without using the SetProcessDpiAwareness(Context) API, is that items can be blurry.
+The problem with scaling, without using the SetProcessDpiAwareness(Context) API, is that items can be become blurry.
 Recent Delphi versions support the Windows HighDpi Api. (E.g. Via Manifest or API SetProcessDpiAwareness, SetProcessDpiAwarenessContext)
 
 Solution:

Docs/Readme GeoCoding Getting started.txt

@@ -0,0 +1,16 @@
+- If you dont want any GeoCoding choose 'Disable GeoCoding'.
+
+- If all you want is to get the location of coordinates and dont want to enable Internet Access for lookup.
+
+  In Preferences/GeoCoding choose 'Enable Offline GeoCoding (ExifTool)'
+
+  Choose GeoCode provider 'ExifTool' when using any of these 2 functions:
+
+  - Modify/Update City, Province, Country from GPS coordinates
+
+  - Button 'Geotag files' (At the bottom of the OSM map)
+    Click on Setup Geo
+
+- If you want to search for cities, and have more control over the data choose 'Enable All Geocoding'.
+  Get an ApiKey from https://geocode.maps.co/ and set it up in Preferences.
+  All options are now available.

Docs/Readme GeoCoding.txt

@@ -1,11 +1,25 @@
+Support for new ExifTool functions geolocate and -api geolocation. (Requires ExifTool 12.78 and GUI version V6.3.0)
+
+Starting from version V6.3.0 a new GeoCode provider for reverse geocoding has been added.
+You can obtain the City, State and Country from GPS Coordinates or obtain the GPS coordinates from a city, by selecting 'ExifTool geolocation' as Geocode provider.
+It uses features available in ExifTool V12.79. For more background info: https://exiftool.org/geolocation.html
+
+In order to be compatible with the new ExifTool function the existing GUI functions have been modified.
+
+Exiftool writes the location found into tags: XMP:photoshop:City, XMP:photoshop:State, XMP:photoshop:Country and -XMP-iptcCore:CountryCode
+In previous versions Gui wrote the info only into -XMP-iptcExt:LocationShownCity, -XMP-iptcExt:LocationShownProvinceState and -XMP-iptcExt:LocationShownCountryName
+Depending on the setting only the CountryCode was written into -XMP-iptcExt:LocationShownCountryName or the full CountryName.
+Starting with V6.3.0 Gui will write both into the photoshop and into the iptcExt tags. You can choose in preferences if you want the 
+CountryCode, or the full CountryName displayed in the filelist. (If CountryCode is empty, and CountryName is not empty, it will display the CountryName in the filelist)
+
 Lessons learned from user testing.
 
 A few users have done some testing with GeoCoding. A few issues found are resolved in code, other issues are worth documenting.
 
 General remarks:
 
 - If you run into problems, it's a good idea to replay the commands with the Log Window open. That information helps solving issues.
-- The 2 providers currently available, Geocode and Overpass, will drop requests when you generate too many per second.
+- The 2 online providers currently available, Geocode and Overpass, will drop requests when you generate too many per second.
   Please use the 'Throttle values' in preferences. They specify a minimum nr of milliseconds between calls. For example 2000 means you can only do 1 call per 2 seconds!
 
 Issues found with 'Video files' (No Jpeg (JPG) or Camera-Raw (DNG, CRW, NEF etc), but Video's like MP4 or Mov)

Docs/Readme Portable.txt

@@ -1,5 +1,16 @@
 ExiftoolGui Portable?
 
+Starting with version V6.3.0. a new program parameters is available: '/IniPath=<path>'
+With this parameter you specify the location of the ini file. If it is specified, then immediately after starting GUI, the INI file will be saved. 
+If it fails an error message is displayed and the program halted. To prevent that changes made by the user would not be saved.
+<path> can be:
+- A fully qualified path: eg: "c:\a dir with spaces"
+- %P The directory from where the program was loaded.
+- %W The working directory.
+- %T a Temp directory.
+
+Note: Also specifying /DontSaveIni has no effect!
+
 Bogdan Hrastnik stated in his documentation on https://exiftool.org/gui/ Bullet 2. ExifToolGui.
 
 "GUI doesn't write anything into registry file or elsewhere. After first usage, all settings are written into "ExifToolGUI.ini" file, which is automatically

Docs/changelog.txt

@@ -82,3 +82,5 @@ Version:        Description             Issue
                 Fix Issue #327          Add version check. Create installer
                 Fix Issue #329          Keep URL's used in a rc file
                 Fix Issue #341          Improve Overpass defaults
+                Fix Issue #347          Style Dark Filelist Highlighted Color
+                Fix Issue #350          Add Exiftool features 'geolocate' and '-api geolocation' to GUI as a new GeoCode provider

README.md

@@ -1,4 +1,4 @@
-# ExifToolGui
+# ExifToolGui
 <h4>A GUI for ExifTool</h4>
 
 This is an updated version of the ExifToolGui program created by Bogdan Hrastnik. Many thanks go out to him.
@@ -9,7 +9,7 @@ This is an updated version of the ExifToolGui program created by Bogdan Hrastnik
 - Deutsch hat angefangen. [DLL](Translation/ExifToolGui.DEU), [BTM quelldatei](Translation/ExifToolGUI_de.xlat)<br>
 - English was already available as default. [DLL](Translation/ExifToolGUI.ENU)<br>
 
-When you place the language DLL in the same folder as the EXE, it should be selected automatically. According to your Windows language. 
+When you place the language DLL in the same folder as the EXE, it should be selected automatically. According to your Windows language.
 To override the default use /Lang=xxx as commandline parm. Where xxx is the languagecode. (NLD, DEU)
 
 Note: <br>
@@ -63,7 +63,7 @@ a stacktrace can be copied to the clipboard if an Exception occurs. Please also
 
 <h4>Legal, Copyright etc.</h4>
 
-This is a continuation of the project started by Bogdan Hrastnik. He did not mention any License, and or Copyrights. Likewise I will not. 
+This is a continuation of the project started by Bogdan Hrastnik. He did not mention any License, and or Copyrights. Likewise I will not.
 I have used some open source components, you can find their legal info in the corresponding subdirectories.