この readme は、 Mobiclip マルチエンコーダツールのエンコードジョブの自動化を助ける二つのスクリプトファイルについて解説します。

----------------------------------------------
スクリプトファイルは Python プログラミング言語で記述されており、 Python インタプリタがコンピュータにインストールされていることを要件とします。

両方のスクリプト共にジョブキューファイルを入力として必要とし、ジョブを一つだけ含んでいなければなりません。このジョブは、どのように動画ファイルが処理されるかを定義します。

キューファイル(.queue)は、 Mobiclip マルチコアエンコーダツールを用いて作成および保存されなければなりません。更なる情報は、 documents フォルダ内のユーザーマニュアルをご覧ください。   

スクリプトが実行する時、キューファイル内で定義されている入力および出力ファイル名とディレクトリはコマンドライン上でスクリプトに渡される引数に置換されます。

----------------------------------------------

------------
MME_Encode.py の用法: 

ある特定の動画ファイルを Mobiclip マルチコアエンコーダを用いてエンコードするには、 MME_Encode.py を使用します。

このスクリプトは、ある特定の動画ファイルをエンコードしたい場合、かつ常に同じエンコードの仕様を使用したい場合に、便利です。
------------

MME_Encode.py [OPTIONS] <キュー> <動画> <出力>

OPTIONS の引数は任意です: 
 -h, --help : ヘルプメッセージを表示する

位置指定(必須)引数: 
<キュー> : 自分の動画ファイルをエンコードするのに使用するキューファイルの名前
<動画> : エンコードされる入力動画ファイルの名前
<出力> : MoFlex ファイル用の出力ディレクトリ(存在しない場合は作成されます)

例: 
MME_Encode.py Split_Side-by-Side.queue Video_test.mp4 "Output Video"
MME_Encode.py Split_Side-by-Side.queue C:\Work\InputVideo\Video_test.avi "C:\Output Video"

----------------------------------------------

------------
MME_Batch_Multi_File.py の用法: 

一つのディレクトリ内の動画ファイルすべてを Mobiclip マルチコアエンコーダを用いてエンコードするには、MME_Batch_Multi_File.py を使用します。

このスクリプトは、.MP4、.AVI、.MKV、そして.MOVで終わる動画ファイルすべてに関し入力ディレクトリをスキャンし、その後、指定されたキューファイル内で定義されたジョブでそれらをエンコードします。出力ファイルには、ファイルの拡張子が .MoFlex に変わるということを除き、同じファイル名が使用されます。

時間を節約するため、スクリプトは、ファイルが既にエンコードされていることを検知した場合、それをスキップします。ツールは、入力ファイルと同じ名前で .MoFlex ファイルが出力ディレクトリ内に既に存在し、その MoFlex ファイルの作成日が元の動画ファイルより後である場合、ファイルをスキップします。

このスクリプトは、エンコードを必要とする新たに追加された動画ファイルに関し入力ディレクトリを繰り返しスキャンしたい場合に便利です。ディレクトリを再スキャンするには、単純にスクリプトを再起動する、さもなければ定期的に実行されるようスクリプトをスケジュールしたいと思われるかもしれません。
------------
MME_Batch_Multi_File.py [OPTIONS] <キュー> <入力> <出力>

OPTIONS の引数は任意です: 
 -h, --help : ヘルプメッセージを表示する
 -c, --clean : 開始する前に出力ディレクトリ内のすべてのファイルを削除する (入力ファイルは一切スキップされません)
 
位置指定(必須)引数: 
<キュー> : 動画をエンコードするのに使用するキューファイル
<入力> : エンコードされる動画ファイルを包含している入力ディレクトリ
<出力> : 出力ディレクトリ(存在しない場合は作成されます)

例 : 
MME_Batch_Multi_File.py Split_Side-by-Side.queue InputVideo "Output Video"
MME_Batch_Multi_File.py --clean Split_Side-by-Side.queue C:\Work\InputVideo "C:\Output Video"

------------
注意事項 / 要件 : 
* このスクリプトは Windows のコマンドプロンプトウィンドウから実行されるものとし、http://www.python.org/からダウンロードできる、Python v2.7.4を用いてWindows7上でテスト済です。
* キューファイルは、ジョブを一つだけ含んでいなければなりません。複数のエンコード用プロファイルが必要とされるのであれば、その場合は、複数の「Mobiclipエンコーダ」フィルタを自分のキューファイル内でジョブを定義するグラフに追加してください。
* Mobiclip マルチコアエンコーダツールは、スクリプトを起動する時に既に実行中であってはならず、さもなければ、エラーとなり何も処理されません。このため、同時にスクリプトのインスタンスを複数起動することは試みないでください。 MobiclipMulticoreEncoder.exe のインスタンスは一度に一つだけ実行可能です。
* 自分のディレクトリ名やファイル名にスペースがはいっている場合、完全なパスはこのように引用符で囲まれなければなりません: "C:\Output Video"

------------
トラブルシューティング : 
* まず最初に、スクリプトを起動する時に MobiclipMulticoreEncoder.exe が既に実行中ではないことを、 Windows タスクマネージャーのプロセスタブでチェックしてください。

* 出力ディレクトリ内に MoFlex ファイルが作成されない場合、以下を行うことによりキューファイルが有効であることを確認してください : 
- Windows のスタートメニューから Mibiclip マルチコアエンコーダツールを起動します。
- Mobiclip マルチコアエンコーダ内「ジョブキュー」タブ上にキューファイルを、「キューを読み込む」ボタンをクリックすることにより手動で読み込みます。
- 「グラフエディタ」タブ内でジョブのグラフを表示するには、マウスでクリックすると現れるジョブを選択し、「ジョブを確認」ボタンをクリックします。
- 「動画ファイル」フィルタの設定上でダブルクリックして開き、それから自分の入力動画ファイルのうちの一つを選択し、フィルタを閉じます。
- すべてのフィルタが緑である（適切に設定されている)ことを確認します; でなければ、赤いフィルタが緑に変わるよう再設定します。
- 「ジョブキュー」タブを表示して確認し、「キューを消去」ボタンをクリックすることにより、既存のジョブキューを消去します。
- このジョブを自分の空のジョブキューに追加するには、「グラフエディタ」タブへ戻り、「ジョブキュー」ボタンをクリックします。
- 追加したてのジョブを処理し始めるには、「ジョブキュー」タブへ戻り、「キューを開始」ボタンをクリックします。
- ジョブが正常に完了し出力ファイルが作成されることを確認します。さもなければ、「グラフエディタ」タブ内で自分のジョブを再度表示して確認し編集する必要があります。
- 「ジョブキュー」タブ上の「キューを保存」ボタンをクリックすることにより自分の修正を保存し、この新しい .queue ファイルを用いて python スクリプトを再実行します。