src/README.jp.txt

   1 [ AdjustTime ]
   2
   3 GPSログファイル(GPX)を元にして写真へ「位置情報(緯度経度)」と「方向」を追記します。(EXIF更新)
   4
   5 [概要]
   6 GPSログの記録時刻とデジカメの撮影時刻とを見比べて、GPSログ内に写真へのリンク情報を付加した新しいGPSログファイルを作成します。
   7
   8  ※ 対象とする画像ファイルは'*.jpg'のみです。
   9  ※ GPSログの形式は「GPX」形式に対応しています。
  10  * 画像ファイルの撮影日時をファイルの更新日時／EXIF撮影日時から選択することができます。
  11         - ファイル更新日時： 高速処理が可能です。
  12                         一部のトイカメラ系のデジカメにはEXIF情報が正しく付加されないものがあります。そのような機種におすすめです。
  13         - EXIF撮影日時: ファイル更新日時が利用できない場合はこちらを使ってください。
  14                         iPadなど直接ファイルを扱えないデバイスの場合はファイル更新日時が使えません。
  15                         うっかりファイルをコピーしてしまった場合は、ファイル更新日時が撮影日時を意味しなくなります。その時もEXIFにしてください。
  16  * 画像の精確な撮影時刻を入力することでGPSログとの時差を自動補正します。
  17  * 結果は、取り込み元のGPXファイルとは別に、元ファイル名にアンダーバー「_」を付加した.ファイルに出力します。
  18         - SPEED(速度): 出力GPXに<speed>タグを付加することができます。
  19         - MAGVAR(方向): 'MAGVAR'とは磁気方位のことです。直前のポイントとの２点間の位置関係を'MAGVAR'として出力できます。
  20         - 出力先のGPXに写真へのリンク情報を付加する／付加しないを選択可能にしました。
  21                 [☑ 出力GPXにポイントマーカー<WPT>を書き出す]
  22  * 画像にEXIF情報を付加することができます。
  23         - 緯度経度: GPSログから算出した緯度・経度情報をEXIFに書き出すことができます。
  24         - 撮影方向: GPSログから移動方向を擬似撮影方向としてEXIFに書き出すことができます。（カメラの向きではありません）
  25
  26 http://sourceforge.jp/projects/importpicture/wiki/FrontPage
  27
  28 [起動]
  29 下記のように'AdjustTime'を起動するとGUIでパラメータを逐次設定可能です。（推奨起動方法）
  30
  31 > java -cp .:AdjustTime2.jar:commons-imaging-1.0-SNAPSHOT.jar osm.jp.gpx.matchtime.gui.AdjustTime
  32
  33
  34 下記のコマンドラインによる起動方式は度重なる機能追加によりパラメーターが増大したため複雑になりすぎ作者でさえわけがわからなくなりました。
  35 一応、過去の起動方法を記載しておきます。しかし、コマンドラインからの引数は2016-10-03版以降は正しく引き継がれません。
  36 'AdjustTime2.jar'と'AdjustTime.ini'を使ってください。
  37
  38 > java -jar importPicture.jar <outputfile> <targetDir> <time base image> <time> <gpx>
  39
  40 (パラメータ)
  41          argv[0] = 画像リストの出力ファイル
  42          argv[1] = 画像ファイルが格納されているディレクトリ
  43          argv[2] = 時刻補正の基準とする画像ファイル
  44          argv[3] = 基準画像ファイルの精確な撮影日時 "yyyy-mm-dd'T'HH:MM:ss"
  45          argv[4] = 撮影位置をロギングしたGPXファイル     (省略可能：省略した場合は指定された画像ディレクトリ内のGPXファイルを対象とする（複数可能）)
  46
  47 exp)
  48
  49 > java -jar importPicture.jar list.csv . IMG_01234.JPG 2012-06-15T12:52:22 鎌倉宮_2012-06-15_12-00-16.gpx
  50
  51
  52 [ GUIバージョン ]
  53 撮影した画像を確認しながらパラメータを設定することができます。
  54 また、補正した撮影時刻と位置情報を画像ファイルのEXIFに書き込むことも可能です。
  55 EXIFへの書き込みには別途「Apache commons imaging」ライブラリが必要です。
  56 commons_imaging ライブラリは下記から入手してください。
  57 （version 1.0 以降が必要です）
  58
  59 -------------------------------------------------------------------
  60
  61 [Restamp]
  62
  63 動画から一定間隔で切り出したIMAGEのファイル更新日時を書き換える
  64
  65  ・画像ファイルの更新日付を書き換えます。(Exi情報は無視します)
  66     ※ 指定されたディレクトリ内のすべての'*.jpg'ファイルを処理の対象とします
  67
  68  ・画像は連番形式（名前順に並べられること）の名称となっていること
  69
  70  ・一定の間隔（等間隔）で撮影された画像ファイルの中から２つの画像の撮影時刻を
  71  　入力することで、２つの画像の間の画像数から撮影間隔を割り出し、時刻を指定され
  72  　ていない残りの画像も含めて、画像ファイルの「ファイル更新日時」を書き換えます。
  73
  74 ## パラメータ
  75  ・対象のフォルダ（ディレクトリ内のすべての'*.jpg'ファイルを処理の対象とします）
  76  ・基準となる画像（２つ）
  77  ・基準画像の正しい日時（２つ）
  78
  79 > java -cp .:AdjustTime2.jar osm.jp.gpx.Restamp <imgDir> <baseFile A> <baseTime A> <baseFile B> <baseTime B>
  80
  81  argv[0] = 画像ファイルが格納されているディレクトリ         --> imgDir
  82  argv[1] = 時刻補正の基準とする画像ファイル                     --> baseFile A
  83  argv[2] = 基準画像ファイルの精確な撮影日時 "yyyy-MM-dd_HH:mm:ss" --> baseTime A
  84  argv[3] = 時刻補正の基準とする画像ファイル                     --> baseFile B
  85  argv[4] = 基準画像ファイルの精確な撮影日時 "yyyy-MM-dd_HH:mm:ss" --> baseTime B
  86
  87 ## 使い方
  88  1. 予め、動画から画像を切り出す
  89  　　ソースファイル（mp4ファイル）; 「-i 20160427_104154.mp4」
  90      出力先: 「-f image2 img/%06d.jpg」 imgフォルダに６桁の連番ファイルを差出力する
  91  　　切り出し開始秒数→ 「-ss 0」 （ファイルの０秒から切り出し開始）
  92  　　切り出し間隔； 「-r 30」 (１秒間隔=３０fps間隔)
  93  ```
  94  $ cd /home/yuu/Desktop/OSM/20180325_横浜新道
  95  $ ffmpeg -ss 0  -i 20160427_104154.mp4 -f image2 -r 15 img/%06d.jpg
  96  ```
  97
  98  2. ファイルの更新日付を書き換える
  99  ```
 100  $ cd /home/yuu/Desktop/workspace/AdjustTime/importPicture/dist
 101  $ java -cp .:AdjustTime2.jar osm.jp.gpx.Restamp /home/yuu/Desktop/OSM/20180325_横浜新道/img 000033.jpg 2018-03-25_12:20:32 003600.jpg  2018-03-25_13:20:09
 102  ```
 103
 104
 105 -------------------------------------------------------------------
 106 AdjustTime2.jar
 107 Copyright (c) 2014 Yuu Hayashi
 108 This software is released under the MIT License, see LICENSE.txt.
 109
 110 -------------------------------------------------------------------
 111 About 'commons-imaging-1.0-SNAPSHOT.jar'
 112 'commons-imaging-1.0-SNAPSHOT.jar' is the work that is distributed in the Apache License 2.0
 113
 114 commons-imaging-1.0-SNAPSHOT.jarについて
 115 'commons-imaging-1.0-SNAPSHOT.jar'は、 Apache 2.0ライセンスで配布されている製作物です。
 116
 117 commons-imaging-1.0-SNAPSHOT.jarの入手元
 118     https://repository.apache.org/content/groups/snapshots/org/apache/commons/commons-imaging/1.0-SNAPSHOT/
 119     commons-imaging-1.0-20170205.201009-115.jar
 120         commons-imaging-1.0-20150518.202342-66.jar
 121
 122 ----------------
 123 osm.jp.gpx.GeoDistance.java は'やまだらけ'様の著作物です。
 124         Copyright (C) 2007-2012   やまだらけ
 125         The MIT License (MIT)
 126         参照元: http://yamadarake.jp/trdi/report000001.html
 127
 128