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>[email protected]</email>. &doc-effectimages; &doc-filterimages; &doc-flickrexport; -&doc-geolocation; &doc-imagesgallery; &doc-imageviewer; &doc-jpeglossless;
