README.md

   1 # adjustgpx-core
   2
   3 GPSログファイル(GPX)を元にして写真へ「位置情報(緯度経度)」と「方向」を追記します。(EXIF更新)
   4
   5 ## 概要
   6
   7 GPSログの記録時刻とデジカメの撮影時刻とを見比べて、GPSログ内に写真へのリンク情報を付加した新しいGPSログファイルを作成します。
   8
   9 - 対象とする画像ファイルは'*.jpg'のみです。
  10 - GPSログの形式は「GPX」形式に対応しています。
  11 - 画像ファイルの撮影日時をファイルの更新日時／EXIF撮影日時から選択することができます。
  12   - ファイル更新日時： 高速処理が可能です。
  13     - 一部のトイカメラ系のデジカメにはEXIF情報が正しく付加されないものがあります。そのような機種におすすめです。
  14   - EXIF撮影日時: ファイル更新日時が利用できない場合はこちらを使ってください。
  15     - iPadなど直接ファイルを扱えないデバイスの場合はファイル更新日時が使えません。
  16     - うっかりファイルをコピーしてしまった場合は、ファイル更新日時が撮影日時を意味しなくなります。その時もEXIFにしてください。
  17 - 画像の精確な撮影時刻を入力することでGPSログとの時差を自動補正します。
  18 - 結果は、取り込み元のGPXファイルとは別に、元ファイル名にアンダーバー「_」を付加した.ファイルに出力します。
  19   - SPEED(速度): 出力GPXに<speed>タグを付加することができます。
  20   - MAGVAR(方向): 'MAGVAR'とは磁気方位のことです。直前のポイントとの２点間の位置関係を'MAGVAR'として出力できます。
  21   - 出力先のGPXに写真へのリンク情報を付加する／付加しないを選択可能にしました。
  22     - [☑ 出力GPXにポイントマーカー<WPT>を書き出す]
  23 - 画像にEXIF情報を付加することができます。
  24   - 緯度経度: GPSログから算出した緯度・経度情報をEXIFに書き出すことができます。
  25   - 撮影方向: GPSログから移動方向を擬似撮影方向としてEXIFに書き出すことができます。（カメラの向きではありません）
  26
  27 http://sourceforge.jp/projects/importpicture/wiki/FrontPage
  28
  29 ## 起動
  30
  31 下記のように'AdjustGpx'を起動するとGUIでパラメータを逐次設定可能です。（推奨起動方法）
  32
  33 ```
  34 > java -cp AdjustGpx.jar osm.jp.gpx.matchtime.gui.AdjustGpx
  35 ```
  36
  37 下記のコマンドラインによる起動方式は度重なる機能追加によりパラメーターが増大したため複雑になりすぎ作者でさえわけがわからなくなりました。
  38
  39 一応、過去の起動方法を記載しておきます。しかし、コマンドラインからの引数は2016-10-03版以降は正しく引き継がれません。
  40
  41 GUI版の'AdjustTerra.jar'を使ってください。
  42
  43 ```
  44 > java -jar AdjustGpx.jar <outputfile> <targetDir> <time base image> <time> <gpx>
  45 ```
  46
  47 | (パラメータ) |    |
  48 | -------- | --------------------------- |
  49 | argv[0]  | 画像リストの出力ファイル  |
  50 | argv[1] | 画像ファイルが格納されているディレクトリ |
  51 | argv[2] | 時刻補正の基準とする画像ファイル |
  52 | argv[3] | 基準画像ファイルの精確な撮影日時 "yyyy-mm-dd'T'HH:MM:ss" |
  53 | argv[4] | 撮影位置をロギングしたGPXファイル    (省略可能：省略した場合は指定された画像ディレクトリ内のGPXファイルを対象とする（複数可能）) |
  54
  55 ```
  56 exp) java -jar AdjustGpx.jar list.csv . IMG_01234.JPG 2012-06-15T12:52:22 鎌倉宮_2012-06-15_12-00-16.gpx
  57 ```
  58
  59 ## GUIバージョン
  60
  61 撮影した画像を確認しながらパラメータを設定することができます。
  62
  63 また、補正した撮影時刻と位置情報を画像ファイルのEXIFに書き込むことも可能です。
  64
  65 EXIFへの書き込みには別途「Apache commons imaging」ライブラリが必要です。
  66
  67 commons_imaging ライブラリは下記から入手してください。（version 1.0 以降が必要です）
  68
  69 - About 'commons-imaging-1.0-SNAPSHOT.jar'
  70   - 'commons-imaging-1.0-SNAPSHOT.jar' is the work that is distributed in the Apache License 2.0
  71
  72 ## Repository
  73
  74 Source repository
  75 | adjustgpx-core | http://surveyor.mydns.jp/gitbucket/git/yuu/adjustgpx-core.git |
  76 | osdn   | yuuhayashi@git.osdn.net:/gitroot/importpicture/importpicture.git |
  77
  78 Binary repository : `http://surveyor.mydns.jp/archiva/repository/haya4/adjustgpx/`
  79
  80 ```
  81     <!-- http://surveyor.mydns.jp/archiva/repository/haya4/adjustgpx -->
  82     <dependency>
  83       <groupId>osm.surveyor</groupId>
  84       <artifactId>adjustgpx-core</artifactId>
  85       <type>jar</type>
  86     </dependency>
  87 ```