[digikam-doc] digikam: geolocationeditor moved from kipi to digikam
Gilles Caulier
caulier.gilles at gmail.com
Mon Aug 22 12:05:34 UTC 2016
Git commit 5119d381173f11c354cf736e90f1c18a1ac66f49 by Gilles Caulier.
Committed on 22/08/2016 at 12:04.
Pushed by cgilles into branch 'master'.
geolocationeditor moved from kipi to digikam
A +- -- digikam/geolocationcorrelate.png
A +- -- digikam/geolocationcorrelate1.png
A +- -- digikam/geolocationeditcoords.png
M +15 -14 digikam/index.docbook
A +188 -0 digikam/tool-geolocationeditor.docbook
http://commits.kde.org/digikam-doc/5119d381173f11c354cf736e90f1c18a1ac66f49
diff --git a/digikam/geolocationcorrelate.png b/digikam/geolocationcorrelate.png
new file mode 100644
index 0000000..2897bd1
Binary files /dev/null and b/digikam/geolocationcorrelate.png differ
diff --git a/digikam/geolocationcorrelate1.png b/digikam/geolocationcorrelate1.png
new file mode 100644
index 0000000..ccf61ae
Binary files /dev/null and b/digikam/geolocationcorrelate1.png differ
diff --git a/digikam/geolocationeditcoords.png b/digikam/geolocationeditcoords.png
new file mode 100644
index 0000000..0e3b7fd
Binary files /dev/null and b/digikam/geolocationeditcoords.png differ
diff --git a/digikam/index.docbook b/digikam/index.docbook
index a96d3af..50bba0e 100644
--- a/digikam/index.docbook
+++ b/digikam/index.docbook
@@ -7,22 +7,23 @@
<!ENTITY digikam '<application>digiKam</application>'>
<!-- relative path to snapshots for digikam and showfoto -->
<!ENTITY path "">
- <!ENTITY doc-file-formats SYSTEM "file-formats.docbook">
- <!ENTITY doc-sidebar SYSTEM "sidebar.docbook">
+ <!ENTITY doc-file-formats SYSTEM "file-formats.docbook">
+ <!ENTITY doc-sidebar SYSTEM "sidebar.docbook">
<!-- image editor -->
- <!ENTITY doc-photo-editing SYSTEM "photo-editing.docbook">
- <!ENTITY doc-editor-color SYSTEM "editor-color.docbook">
- <!ENTITY doc-editor-enhance SYSTEM "editor-enhance.docbook">
- <!ENTITY doc-editor-transform SYSTEM "editor-transform.docbook">
- <!ENTITY doc-editor-filters SYSTEM "editor-filters.docbook">
- <!ENTITY doc-editor-decorate SYSTEM "editor-decorate.docbook">
- <!ENTITY doc-color-management SYSTEM "color-management.docbook">
+ <!ENTITY doc-photo-editing SYSTEM "photo-editing.docbook">
+ <!ENTITY doc-editor-color SYSTEM "editor-color.docbook">
+ <!ENTITY doc-editor-enhance SYSTEM "editor-enhance.docbook">
+ <!ENTITY doc-editor-transform SYSTEM "editor-transform.docbook">
+ <!ENTITY doc-editor-filters SYSTEM "editor-filters.docbook">
+ <!ENTITY doc-editor-decorate SYSTEM "editor-decorate.docbook">
+ <!ENTITY doc-color-management SYSTEM "color-management.docbook">
<!-- tools -->
- <!ENTITY doc-tool-acquireimages SYSTEM "tool-acquireimages.docbook">
+ <!ENTITY doc-tool-acquireimages SYSTEM "tool-acquireimages.docbook">
+ <!ENTITY doc-tool-geolocationeditor SYSTEM "tool-geolocationeditor.docbook">
<!-- menus -->
- <!ENTITY doc-menu-descriptions SYSTEM "menu-descriptions.docbook">
- <!ENTITY doc-ie-menu SYSTEM "ie-menu.docbook">
- <!ENTITY doc-credits-annexes SYSTEM "credits-annex.docbook">
+ <!ENTITY doc-menu-descriptions SYSTEM "menu-descriptions.docbook">
+ <!ENTITY doc-ie-menu SYSTEM "ie-menu.docbook">
+ <!ENTITY doc-credits-annexes SYSTEM "credits-annex.docbook">
<!-- Do not define any other entities; instead, use the entities
from kde-genent.entities and $LANG/user.entities. -->
@@ -2386,7 +2387,7 @@ Fun stuff
<!-- ******** MISC TOOLS *************************************************** -->
&doc-tool-acquireimages;
-
+&doc-tool-geolocationeditor;
<!-- *********************************************************************** -->
diff --git a/digikam/tool-geolocationeditor.docbook b/digikam/tool-geolocationeditor.docbook
new file mode 100644
index 0000000..3c4e040
--- /dev/null
+++ b/digikam/tool-geolocationeditor.docbook
@@ -0,0 +1,188 @@
+<chapter id="tool-geolocationeditor">
+<chapterinfo>
+
+<abstract>
+<para>
+The Geolocation Editor allows for adding and editing GPS coordinates of picture metadata. The geo-data is stored into the image (EXIF tags) and the location can be displayed in an external browser map.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>GPS</keyword>
+<keyword>Map</keyword>
+</keywordset>
+</chapterinfo>
+
+<title>Geolocation Editor</title>
+
+<para>
+ The <quote>Geolocation Editor</quote> provides the tools to localize pictures
+ geographically in the common spherical coordinate system (used by GPS/Galileo).
+ Altitude, latitude and longitude are used.
+</para>
+<note><para>
+ The tool only works for image formats that have EXIF or XMP metadata supported by
+ <ulink url="http://www.exiv2.org">Exiv2 library</ulink>.
+</para></note>
+
+<sect1 id="geolocation-title"> <title>Geolocation</title>
+<para>
+The tool has two methods to mark the pictures with coordinates:
+</para>
+<itemizedlist>
+ <listitem>
+ <para>Batch correlation of GPS tracking data with a series of images.</para>
+ </listitem>
+ <listitem>
+ <para>Semi-automatic coordinate attribution to single pictures.</para>
+ </listitem>
+</itemizedlist>
+
+<sect2 id="geolocation-correlator"> <title>The correlator</title>
+ <para>In order to correlate your images with geographic data you need to
+ have a GPS tracking information available as a XML file in <literal>gpx</literal>
+ format (<application><ulink url="http://www.gpsbabel.org">gpsbabel</ulink></application>
+ and <application><ulink url="http://www.ncc.up.pt/gpsman/">gpsman</ulink></application>
+ can download and convert tracking data from a GPS device for you).
+ </para>
+ <para>
+ <menuchoice><guimenu>Image</guimenu>
+ <guimenuitem>Geolocation</guimenuitem>
+ <guimenuitem>Correlator</guimenuitem></menuchoice>.
+ This interface can correlate a previously selected number of pictures
+ with registered GPS tracking information.
+ </para>
+ <example id="geolocation-geo-correlation-dialog">
+ <title>The geo-correlation dialog based on EXIF date/time and tracking data (gpx format)</title>
+ <screenshot><mediaobject><imageobject><imagedata fileref="geolocationcorrelate.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+ </example>
+ <para>
+ Select the images you want to correlate in the application main view,
+ then call the menu. The above dialog will show up. To indicate possible
+ time/location correlation you have to load a track file with
+ <guilabel>Load GPX File</guilabel> that contains GPS data taken at
+ the same time and location as the pictures with your camera.
+ </para>
+ <para>
+ When the file is loaded, an automatic correlation is done showing the
+ attributed coordinates in red. GPS track data is invariably recorded
+ in GMT time, so you need to match the camera time with GMT, which
+ can be done with <guilabel>Time Zone</guilabel>. Select the
+ <emphasis>camera time zone</emphasis> here!
+ </para>
+ <para>
+ The <guilabel>Max. time gap</guilabel> setting specifies the limit
+ within which GPS time and camera time shall be deemed coincident.
+ The maximum value is 2000 seconds.
+ </para>
+ <tip><para>If you have no tracking data for pictures that were taken
+ in the same place you can just manually edit a <literal>gpx</literal>
+ file and apply it to those images. The 2000 second time gap will then
+ correlate all pictures taken within 20 minutes.
+ </para></tip>
+
+ <para>
+ The option <guilabel>Interpolate</guilabel> and <guilabel>Difference
+ in min.</guilabel> can be used if there is no match of data. If you
+ know that in reality there is a location match despite a larger time gap
+ between camera and GPS, you can set this limit here and click on the
+ <guilabel>Correlate</guilabel> button to interpolate.
+ </para>
+ <example id="geolocation-correlation">
+ <title>Correlation</title>
+ <screenshot><mediaobject><imageobject><imagedata fileref="geolocationcorrelate1.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+ </example>
+ <para>
+ 240 minutes is the maximum time difference that can be introduced here.
+ </para>
+
+</sect2>
+
+<sect2 id="geolocation-edit-coordinates"> <title>Edit Coordinates</title>
+ <example id="geolocation-semi-automatic-attributing">
+ <title>Semi-automatic attributing of coordinates through map interaction</title>
+ <screenshot><mediaobject><imageobject><imagedata fileref="geolocationeditcoords.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+ </example>
+ <para>
+ The coordinates can be set manually with this dialog. This comes in handy
+ if there is a series of photos taken at the same location. Since the
+ coordinates are memorized from one dialog call to another, it is as
+ easy as clicking on <guilabel>OK</guilabel> to set the previous data
+ to the current photo.
+ </para>
+ <para>
+ Otherwise the location can be found and fixed iteratively with the
+ displayed map. Click on the region of interest, zoom in, adjust
+ location by clicking again, and so on until sufficient accuracy is
+ achieved. The altitude must always be entered manually. The map can
+ be switched between map mode, satellite image or mixed mode.
+ </para>
+</sect2>
+
+<sect2 id="geolocation-manual"> <title>Commandline tagging</title>
+ <para>
+ Completely outside of the &digikam; context, the are ways to GPS tag images.
+ Here is a shell script that uses <command>exiftool</command> to tag a
+ batch of images.
+ </para>
+
+
+<programlisting>
+#!/bin/sh
+# exiftool wrapper script for easy commandline use. It treats regex files or whole directories.
+#
+# FMT Output
+# "%d deg %d' %.2f"\" 54 deg 59' 22.80"
+# "%d deg %.4f min" 54 deg 59.3800 min
+# "%.6f degrees" 54.989667 degrees
+
+if [ -z $1 ]; then
+ echo "Usage: exiftool-gps-wrapper lat long [alt] file || dir (use signed floating coordinates)"
+else
+
+ if [ -z "$4" ]; then foo="$3"; alt=0
+ else foo="$4"; alt=$3
+ fi
+
+ echo $foo
+ if [ -e "$foo" ] ; then
+ latR=$(echo "$1" | awk '{if ($1 < 0) print "S"; else print "N"}')
+ lonR=$(echo "$2" | awk '{if ($1 < 0) print "W"; else print "E"}')
+ lat=$(echo "$1" | awk '{val = $1; if ($1 < 0) sub(/-/, "", val); print val}') # absolute value
+ lon=$(echo "$2" | awk '{val = $1; if ($1 < 0) sub(/-/, "", val); print val}') # absolute value
+ # use the following syntax for easy googlian paste of ll=-1.23456,53.345345
+ #lonR=$(echo "$2" | awk '{if ($2 < 0) print "W"; else print "E"}')
+ echo $lat, $latR, $lon, $lonR, $3, $4, $foo
+
+ function setgpsinfo ()
+ {
+ exiftool -c "%.6f" -GPSMapDatum="WGS-84" -GPSAltitude=$5 \
+ -GPSLongitudeRef=$4 -GPSLongitude=$3 -GPSLatitudeRef=$2 -GPSLatitude=$1 "$6"
+ exiftool -GPS:ALL "$6"
+ }
+
+ if [ -d "$foo" ] ; then
+
+ for i in "$foo" ; do # the selection of files treated depend on the passed regex
+ echo "i= "$i
+ setgpsinfo $lat $latR $lon $lonR $alt "$i"
+ done
+ else
+ setgpsinfo $lat $latR $lon $lonR $alt "$foo"
+ fi
+ else echo "file or folder is wrong"
+ fi
+fi
+</programlisting>
+</sect2>
+</sect1>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
More information about the kde-doc-english
mailing list