GoPro動画をジンバルを使わずソフトウエアだけで自動水平保持（傾き補正）する

Processingのインストール

Processingは「Java を単純化し、グラフィック機能に特化した言語」らしい。

下記よりダウンロード＆インストール。
Download \ Processing.org

gyrocamのダウンロード

下記よりgyrocamをダウンロード ＆ 解凍 する。
https://github.com/JuanIrache/gyrocam/archive/master.zip

gyrocam.pdeの実行

gyrocam.pdeをダブルクリックして実行する

なお自分の環境（Windows10）では「このアプリはお使いのPCでは実行できません」と出て先に進めなかった。

どうやらzipの解凍に失敗しているらしい。
「processing.exe」や「processing-java.exe」のサイズが0kbのときは失敗している。

Zipファイルをエクスプローラーで開いてから任意の場所（デスクトップなど）にコピーするといい。

gyrocam.pdeを実行、起動するとダイアログが表示される。
Processingが実行されるファイルはファイル名と同名のフォルダの配下に入っている必要があるらしい。

フォルダーを作って移動する？と聞いてくるので「OK」をクリック。

スケッチ（プログラム）が開くので初期設定を行う。

gyrocam.pdeの初期設定

変換する動画に合わせてgyrocam.pdeの初期設定を行う。
スケッチの47〜82行目。この中で関連する部分を修正する。

50行目：String filename = “GOPR0083”;
「GOPR0083」は元動画のファイルネームに書き換える。GPMD2CSVで作られたファイルネームも同じはず。
今回は「GOPR0114.MP4」という動画なので「GOPR0083」の部分を「GOPR0114」に書き換える。

51行目：float vFov = 69.5;
動画のVFovに合わせて書き換える。デフォルトは「69.7」

この数値はHERO6、HERO5、HERO5 Sessionで異なる。
下記の表で適正な値を設定する。

HERO5 Session

https://gopro.com/help/articles/Question_Answer/HERO5-Session-Field-of-View-FOV-Information

HERO5

https://gopro.com/help/articles/Question_Answer/HERO5-Black-Field-of-View-FOV-Information

HERO6

https://gopro.com/help/articles/question_answer/hero6-black-field-of-view-fov-information

今回はHERO5の1080P Wの動画なので16:9の「69.5」で設定する。
SuperViewの数値がないが適当に「120」とか入れても補正できたので水平保持には関係ないのかもしれない（プログラム未確認）

69行目：int offset = -30;
動画とCSVデータのタイムラグを調整する。　
とりあえずそのままでもOK。水平補正がずれるようなら微調整する。
各GoProで固有の値があるらしい。初期値は-30。単位はマイクロ秒。

74行目：float smooth = 1;
回転のスムーズさ。。.95 ➡ 1 に書き換える

75行目：float smoothZ= .95
Z軸方向スムーズさ。.95 ➡ 1 に書き換える

76行目：float limitY = -1;
Y軸回転の制限。.02 ➡ -1 に書き換える

78行目：float limitZ = -1;
水平方向回転の制限。.06 ➡ -1 に書き換える

これでスケッチの初期設定が完了。

ソースファイルの用意

先程自動で作られた「gyrocam」フォルダの配下に「data」というフォルダを作成する。
またそのフォルダに動画ファイルとCSVファイルをコピー（移動）する。

ライブラリをインストールする

この状態で実行しても「 processing.video」というライブラリがないと怒られる。

No library found for processing.video
Libraries must be installed in a folder named ‘libraries’ inside the sketchbook folder (see the Preferences window).

メニューのスケッチ➡ライブラルをインポート➡ライブラリを追加

libraryタブの検索窓に「video」と入力し検索。

上記のライブラリを選択してインストールをクリックする。

これでやっと準備完了。

スケッチを実行する

IDEの上にある三角の再生ボタンっぽいのをクリックするとスケッチが実行される。

フォルダにAfter Effects用のキーフレームファイルが作成される。

この中の [元動画のファイル名]-AErotation.csv が水平補正用のファイルとなる。

Adobe AfterEffectsをインストールする

導入済みの場合はスキップしてください。
www.adobe.com

動画読み込み

Adobe AfterEffectsを起動。

「新規コンポジション フッテージから」➡元動画を選択

キーフレームをクリップボードにコピー

gyrocam.pdeで作成された[元動画のファイル名]-AErotation.csvをエクセルで開く。

表全体選択➡コピー

csvファイルなのでやGoogle スプレッドシートやOpenOfficeでもいいはず（未検証）

動画の詳細を展開➡トランスフォーム➡回転を選択した状態で貼付け（ペースト Ctrl+V)

これで○フレーム目に△度回転させるというデータが転記される。

これが冒頭の動画。

補正データの貼付け前 ➡ 貼付け後
youtu.be