[kipi-plugins-doc] /: geolocationeditor moved from kipi to digikam
Gilles Caulier
caulier.gilles at gmail.com
Mon Aug 22 12:04:21 UTC 2016
Git commit 45f1d01b23b2378cdc223c6d71cc94322d254445 by Gilles Caulier.
Committed on 22/08/2016 at 12:03.
Pushed by cgilles into branch 'master'.
geolocationeditor moved from kipi to digikam
D +0 -196 geolocation.docbook
D +- -- geolocationcorrelate.png
D +- -- geolocationcorrelate1.png
D +- -- geolocationeditcoords.png
M +0 -5 index.docbook
http://commits.kde.org/kipi-plugins-doc/45f1d01b23b2378cdc223c6d71cc94322d254445
diff --git a/geolocation.docbook b/geolocation.docbook
deleted file mode 100644
index c404225..0000000
--- a/geolocation.docbook
+++ /dev/null
@@ -1,196 +0,0 @@
-<chapter id="geolocation">
-<chapterinfo>
-
-<authorgroup>
- <author>
- <firstname>Gerhard</firstname><surname>Kulzer</surname>
- <affiliation><address><email>gerhard at kulzer dot net</email></address></affiliation>
- </author>
-</authorgroup>
-
-<abstract>
-<para>
-The Kipi Geolocation plugin 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>KDE</keyword>
-<keyword>Kipi</keyword>
-</keywordset>
-</chapterinfo>
-
-<title>Geolocation Editor</title>
-
-<para>
- The Kipi plugin <quote>Geolocation</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 plugin only works for image formats that have EXIF metadata supported by
- <ulink url="http://www.exiv2.org">libkexiv2</ulink>.
-</para></note>
-
-<sect1 id="geolocation-title"> <title>Geolocation</title>
-<para>
-The plugin 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 kipi-plugin 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:
--->
-
diff --git a/geolocationcorrelate.png b/geolocationcorrelate.png
deleted file mode 100644
index 2897bd1..0000000
Binary files a/geolocationcorrelate.png and /dev/null differ
diff --git a/geolocationcorrelate1.png b/geolocationcorrelate1.png
deleted file mode 100644
index ccf61ae..0000000
Binary files a/geolocationcorrelate1.png and /dev/null differ
diff --git a/geolocationeditcoords.png b/geolocationeditcoords.png
deleted file mode 100644
index 0e3b7fd..0000000
Binary files a/geolocationeditcoords.png and /dev/null differ
diff --git a/index.docbook b/index.docbook
index abb7313..f93e621 100644
--- a/index.docbook
+++ b/index.docbook
@@ -9,7 +9,6 @@
<!ENTITY doc-effectimages SYSTEM "effectimages.docbook">
<!ENTITY doc-filterimages SYSTEM "filterimages.docbook">
<!ENTITY doc-flickrexport SYSTEM "flickrexport.docbook">
- <!ENTITY doc-geolocation SYSTEM "geolocation.docbook">
<!ENTITY doc-imagesgallery SYSTEM "imagesgallery.docbook">
<!ENTITY doc-imageviewer SYSTEM "imageviewer.docbook">
<!ENTITY doc-jpeglossless SYSTEM "jpeglossless.docbook">
@@ -96,9 +95,6 @@ The plugins available in this handbook are:
<para><link linkend="flickrexport">Remote Flickr Export plugin</link></para>
</listitem>
<listitem>
-<para><link linkend="geolocation">Geolocation plugin</link></para>
-</listitem>
-<listitem>
<para><link linkend="imagesgallery">Images Gallery plugin</link></para>
</listitem>
<listitem>
@@ -146,7 +142,6 @@ please contact the Kipi team mailing list at <email>kde-imaging at kde.org</email>.
&doc-effectimages;
&doc-filterimages;
&doc-flickrexport;
-&doc-geolocation;
&doc-imagesgallery;
&doc-imageviewer;
&doc-jpeglossless;
More information about the kde-doc-english
mailing list