Cube2DM

フリーで使える
全天周・全天球画像・動画の変換コンバータ

http://T.NOMOTO.org/Cube2DM/

動作環境：Windows (64 bit 版 )魚眼レンズにはいくつかの射影方式があり、方式によって見え方が異なります。Cube2DM は各種射影方式の魚眼レンズの映像や CubeMap 形式の全天球画像、通常のカメラレンズで撮影した映像をドームマスタ（等距離射影）、全天球パノラマ（正距円筒図法）、通常のカメラレンズの形式（中心射影）、その他の形式に変換するプ
ログラムです。静止画だけでなく、連番画像や動画映像にも対応しており、画角や向きを変えることも可能です。

入力形式（静止画・連番画像・各種動画）

出力形式（静止画・連番画像・動画 (MP4, AVI)）
ドームマスタ 全天球パノラマ ( エクイレクタングラー )（正距円筒図法）（等距離射影）円周魚眼

通常のカメラレンズの射影方式（中心射影）（等距離射影）（正射影）（等立体角射影）（連番画像）（動画対応）
魚眼レンズの射影方式：
正射影：安原製作所 MADOKA180, RAYNOX DCR-CF187PRO
等距離射影（f シータ方式）：
Entaniya Fisheye, Kodak SP360, フジノン HD 魚眼レンズ ,多くの魚眼レンズ、各種ドームマスタ映像など
等立体角射影：SIGMA 4.5mm F2.8 EX DC CIRCULAR FISHEYE HSM
SIGMA 8mm F3.5 EX DG CIRCULAR FISHEYE
THETA S のデュアルフィッシュアイ出力 , Arecont MPL1.55 など( 仰角調整 )対角魚眼（等距離射影）（正射影）（等立体角射影）（連番画像）（動画対応）

俯仰角
方位角

画像サイズ
背景色調整

キューブマップ（連番画像）

調整（動画ファイル未対応）

通常の写真（中心斜影）（連番画像）（動画対応）

通常のカメラレンズ：
一般的な写真画像など

全天球パノラマ（正距円筒図法）（連番画像・動画対応）
Version: 2017/03/12

● 出力フォルダ：書き出しファイルが保存されるフォルダを● 入力フォルダ：読み込みファイルをドラッグ、またはフォ指定します。

ルダパスを記入します。（末尾に￥はつきません。）● 出力ファイル名：書き出しのファイル名を記入してくださ● 入力ファイル名：読み込みファイルをドラッグ、またはい。連番画像の場合は入力ファイルと同様、出力番号形式ファイル名部分を記入して拡張子をプルダウンから選択し書き出すことができます。出力動画のフレームレートは拡張の場合、プルダウンから番号形式を選択してください。

を指定してください。拡張子を mp4,avi にすることで動画もて行全体としてファイル名になるようにします。連番画像
番号の形式：子のプルダウン右側の fps 欄に記入します。

（なし）番号なし● 開始番号・終了番号：書き出しを行う画像の最初の番号

0：現在の画像番号が順番に追加されます。と最後の番号を入力動画の番号にて指定します。

00：00,01,...99,100, といった具合に 2 桁で追加。他も● 現在の画像番号：現在処理中の画像番号を表示・指定同様。00000 なら 00000,00001,...99999,100000 といっします。入力・出力プレビューにて表示する画像はこの番た番号が追加されます。

号となります。

● 動 画 読 込：動 画 を 読 み 込 む た め の ボ タン で す。

● 入力ファイル表示倍率：入力ファイルをプレビュー表示す

OpenCV の opencv̲ﬀmpeg310̲64.dll が対応する動画る場合の表示倍率を指定します。ここで拡大・縮小表示さ形式を読み込めます。動画読込時は入力形式を予め選れる場合の補間方法は右側のプルダウンで指定します。

択してください。

入力プレビュー：入力画像のプレビューボタンです。動画・● 入力形式：入力ファイルに対応する入力形式を選択し連番の場合「現在の画像番号」にて指定した番号の画像がてください。

表示されます。

● 同期表示：動画処理中にプレビューを表示したい場合は● 入力オフセット：画像読み込み時に指定したピクセルの画像の 1 枚のみの表示になります）

魚眼レンズの中心が画像中心でない場合に使用します。

チェックします。（マルチスレッド処理の場合は同時処理中分画像をずらして読み込みます。（魚眼レンズのみ有効）● プレビュー表示倍率：書き出される画像のプレビュー倍● 入力画角：魚眼レンズによる入力映像幅に対応する画率を指定します。ここで拡大・縮小表示される場合の補間方法は右側のプルダウンで指定します。

● 出力プレビュー：書き出される画像のプレビューボタンです。動画・連番の場合「現在の画像番号」にて指定した番号の画像が表示されます。

同期表示：動画処理中にプレビューを表示したい場合はチェックします。（マルチスレッド処理の場合は同時処理中の画像の 1 枚のみの表示になります）● 出力サイズ：出力画像のサイズを指定します。等距離射影では正方形のみ。正距円筒図法では縦幅、横幅を自由に設定できます。

● 作業解像度→出力解像度への補間方法：作業解像度を角を指定します。

● 作業解像度：作業用画像として高解像度を作成した後に出力 ● 円周マスク：入力画像の画角 180 度より外側を背景色サイズに変換することができます。デフォルトは等倍ですが、入 でマスクします。
力画像の解像度と比較して出力解像度が著しく小さい場合はデータの抜け防止のために 2 以上の値にするとよいかもしれません。

（作業解像度と入力画像の解像度が同程度になる値を設定の後、● 水平画角：中心射影の場合、入力画面横幅が出力画像における何度に相当するかを指定します。

「作業解像度→出力への補間方法」を「ピクセル領域のリサンプ ● スレッド数：マルチスレッド処理を行う場合は 2 以上にします。使用の PC に依存しますが、多すぎると逆にリング」とします）● 仰角・方位角・画面回転：出力画像において向きを変更する
場合、値を設定してください。

● 出力画角：等距離射影出力において、出力したい映像の画面幅に対応する画角を指定します。

速度低下を招く可能性があります。またメモリ消費はスレッド数に比例します。

● 音声の分離・添付：動画から動画に全フレーム変換する場合のみ有効です。入力動画の音声を wav ファイルとして分離、および書き出し動画に入力ファイルの音声ル領域のリサンプリング」がよいかもしれません。

● マスク：等距離射影出力の場合、円形のマスクを画面周辺に を結合することができます。処理は動画の変換処理の後背景色で描画します。
ﬀmpeg.exe にて行わ れ、結 合 後 の 動 画 はファイル 名

ユーザ定義の射影方式を選択できます。

● 背景色：画像背景に最初に設定される色です。

2 倍以上にした場合に設定します。縮小の場合は「ピクセ● 出力形式：等距離射影、正距円筒図法、中心射影の他、 ● 入力→作業解像度への補間方法：変換の補間方法です。

使用例：SP360 の円周魚眼映像 ( 画角 214°) や対角魚眼の画像を変換したい（入力画角の設定方法の例）
１．入力フォルダ・入力ファイル名を入力して動画・画像を撮影したレンズの入力射影形式を選択します。
２．出力画角として魚眼レンズの画角 (SP360 なら 214°, madoka180 なら 180°) を入力します。さらに出̲withAudio という名前で保存されます。
● 変換開始：変換開始ボタンです。

使用例：画像やイラストをドーム用に変形したい

１．入力フォルダ・入力ファイル名を入力して、入力形式として中心射影を選択します。

力側の「マスク」にチェックを入れ、出力形式をドームマスタ形式にして出力プレビューを表示します。

２．水平画角の値が実際に視野に表示される際の画角（大きさ）です。

がプレビュー画像外周の円周マスクに重なるようにします。対角魚眼映像の場合は画像の四隅が画像

３．仰角・方位角・画面回転を調整して出力したい向きにします。

３．出力プレビューボタンを押しながら入力画角と入力オフセットを調節して、円周魚眼の円周部分の境目入力元の写真の画角を入力すれば撮影時の様子を再現できます。

プレビューボタンを押しながら必要な向きに調整します。

外周のマスクに重なるようにします。

４．出力フォルダ・出力ファイルや出力サイズ等の設定を行い、４．これで入力画角とオフセット位置調整が完了です。これ以後入力画角とオフセットは変えません。

変換開始ボタンを押すことでドームマスタまたはエクイレクタングラー

５．他の射影方式で出力したい場合はここで出力形式を変更します。

映像が保存されます。このとき背景色を設定すると、動画編集ソフトで６．ドームマスタの場合は、実際に出力したい画角を「出力画角」に入力してください。
７．仰角・方位角・画面回転を調整して出力したい向きにします。

８．出力フォルダ・出力ファイルや出力サイズ等の設定を行い、変換開始ボタンを押すことでドームマスタ

カラーキーを使った合成がやりやすいかもしれません。

またはエクイレクタングラー映像が保存されます。

入力時：下の式の c1~c14 の 14 個の補正パラメータにて魚眼レンズの射影のマニュアル変換設定が可能。(Ver.2017/3/12 パラメータ追加 )ユーザ定義の射影変換

画角が 180 の領域

画像高さ（入力画角：高さに対応する画角）

1r

画像の座標系

normalized distance from center r

r = c15~17·(c1+c2·(θ/90°)+c3·(θ/90°)2+c4·(θ/90°)3+c5·(θ/90°)4+c6·(θ/90°)5+c13·(θ/90°)7+c14·(θ/90°)9+c7·sin(c8·θ)+c9·cos(c10·θ)+c11·tan(c12·θ))

17 個の補正パラメータは coef̲in.txt 内に改行区切りで記載すること。（17 行の各行が補正係数）

1.0c15~17 は倍率色収差補正用で RGB に対応。c16 は常に 1.0, c15 ,c17 を変更 (1.001 程度 ) して補正します。

正射影

等距離射影
等立体角射影0.003060angle θ90

等距離射影： c2 (2 行目 ) のみ１で他は０正射影： c7= 1, c8= 1，他は０等立体角射影： c7=１.414214(=1/sin(0.5 90°)),c8= 0.5，他は０立体射影： c11= 1, c12= 0.5，他は０90°θθ
中心方向からの角度

出力時：パラメータファイルは coef̲out.txt です。7~12 行目（c7~c12）は入力用と同じ値が使えますが sin,cos,tan の各項は共存できません。多項式部分はθ/90°=c1+c2·r+c3·r2+c4·r3+c5·r4+c6·r5 といった形になります。

本ソフトウェアは無保証です。基本的にサポートも行いませんが、本ソフトウェアを使用しての映像・画像変換処理は自由に使用いただいて結構です。
もし本ソフトウェア自体を販売・配布等行いたい場合はご連絡ください。
また、映像作品に使用の場合、教えていただけると作者は喜びます。
不具合等は報告すると改善する場合があります。

ダウンロード先：http://T.NOMOTO.org/Cube2DM/