README
--[[
Marker Maker for After Effects 6.0.0.0
(C) 2012 あかつきみさき(みくちぃP)

このJob Pluginについて
VOCALOID3 vsqx データをAdobe After Effectsで読み込めるファイルに出力します.
出力可能な形式はAE上で直接実行する「ExtendScript」とAEスクリプトft-MarkerExporterで読み込める「XML」,XML→JSON変換した「JSON」の3種類です.
VOCALOID3上で入力されたノートに基づく位置にマーカーがついています.

ExtendScriptファイルに含まれる情報
マーカーのコメント・Flashキューポイントには,ひとつは対応するノートの歌詞情報,もうひとつには母音情報を含んでいます.
歌詞情報には,スライダー制御エフェクトで,音階が入力されています.
母音情報には,スライダー制御エフェクトで,母音に対応した値が入力されています.

XMLファイルに含まれる情報
マーカーのコメント・Flashキューポイントには,ひとつは対応するノートの歌詞情報,もうひとつには発音記号情報を含んでいます.
マーカーにはデュレーション・ノートナンバー・ベロシティ情報が含まれています.

JSONファイルに含まれる情報
一部JSON用にXMLを個別変換(最上位xml→json)したJSONファイルです. 基本的なデータはXMLと同じ内容です.

インストール
VOCALOID3上でパスを設定する必要があります.
適当なディレクトリ(フォルダー)に置いて,VOCALOID3の「ジョブ→Jobプラグインを管理」から該当ディレクトリ(フォルダー)へパスを設定すれば完了です.
アンインストールはパスの削除,直接削除してください.

動作環境
VOCALOID3, VOCALOID3 Job Pluginが動作する環境

出力したExtendScriptファイルの動作環境
Adobe After Effects CS4以上

出力したXMLファイルの動作環境
ft-MarkerExporter v1.0の対応しているバージョン

使用方法
一つのトラック内の一つ以上のノートを含むパートを選択し,「ジョブ→Jobプラグインを実行」から実行してください.
ファイル名を入力し,ファイル形式を選択してOKを押すと,vsqxファイルと同じディレクトリ(フォルダー)内に「vsqxファイル名.vsqx_入力ファイル名.選択拡張子名」のJファイルが生成されます.
デフォルトの場合は「vsqxファイル名.vsqx_パート名_VOCALOID3MarkerData.jsx」になっています.
複数のパートの同時書き出しには対応していません.一度に複数のパートで使用したい場合はパートを結合してください.

出力したExtendScriptファイルの使用方法
After Effects上でヌルレイヤーを生成したいコンポジションを選択し,「ファイル→スクリプト→スクリプトファイルの実行」からスクリプトを実行してください.
選択したコンポジション内に2つ「パート名 Lyric (BPM ※)」「パート名 Vowel (BPM ※)」というレイヤー名のヌルレイヤーが作成されます.※はBPM値

出力したXMLファイルの使用方法
ft-MarkerExporterのヘルプをご覧ください.

出力したJSONファイルの使用方法
ファイルの互換などにご利用ください.

母音情報について
「パート名 Vowel (BPM ※)」についたマーカーの母音情報は,以下の法則に基づいて付いています.
清音,濁音,半濁音,小文字の"ぁ,ぃ,ぅ,ぇ,ぉ,ゃ,ゅ,ょ,ゎ","ヶ"は,それぞれ対応した母音により「a」「i」「u」「e」「o」
小文字の"っ",長音符,踊り字は一つ前のノートの母音
"ん"は,「n」
複数で構成される文字(きゃ)などは促音から判定
それ以外のものは,ノートに入力された文字がそのままマーカーのメモになります.
スライダー制御エフェクトのキーフレームの値は以下の法則に基づいて記入されています.
a = 1, i = 2, u = 3, e = 4, o = 5, n = 6, other = 0.

バージョン情報
2013/03/14 Ver 6.0.0.0 Update 出力するExtendScriptファイルの処理速度の大幅な改善・軽量化.
ノートナンバーの出力. 内部処理の見直し.
AE日本語・英語以外にも対応. AEでの対応バージョンの変更(CS4以上).
2012/12/11 Ver 5.0.0.1 Update 出力するExtendScriptファイルの軽量化. 内部処理の見直し.
2012/09/20 Ver 5.0.0.0 Update 出力するExtendScriptファイルのUndo処理の追加・無名関数化・ファイルの軽量化. 母音情報のキーフレームのタイプをHOLDに変更.
母音情報をより正確に取得できるように変更. ExtendScript処理速度の改善. 内部処理の見直し.
2012/07/27 Ver 4.2.0.0 Update 英語版After Effectsに対応. 内部処理の見直し.
2012/07/20 Ver 4.1.0.0 Update カタカナ歌詞の対応. ExtendScript書き出し時のProgress barの追加,生成するヌルレイヤーのプロパティ変更.
2012/07/19 Ver 4.0.1.0 Update 内部処理の見直し.
2012/06/03 Ver 4.0.0.0 Update ft-MarkerExporterに準じたXMLファイルの書き出しに対応. JSONファイルの書き出しに対応. 処理の見直し. 出力するExtendScriptファイルの軽量化.
2012/06/01 Ver 3.2.0.0 Update Flashキューポイントのプロパティをセットする機能の追加.
2012/06/01 Ver 3.1.1.0 Update 歌詞が「ki」の時に母音情報が正しく入力されないバグの修正. 促音例外分岐の分岐追加. EULAの廃止. CS6の対応.
2012/03/31 Ver 3.1.0.0 Update AE上でプロジェクトパネルの一番上以外でのコンポジションで実行したときにVowel Dataを読めない問題の修正.
2012/03/26 Ver 3.0.0.0 Update ExtendScript処理速度の改善. 母音情報処理の変更. EULA処理の実装.
2012/03/26 Ver 2.2.1.1 Update バグの修正.
2012/03/14 Ver 2.2.1.0 Update pluginIDの修正, ExtendScript初回起動時のEULAの追加実験(2.2.1.0では未実装)
2012/02/10 Ver 2.2.0.0 Update VOCALOID3発音記号の正式対応, 歌詞に発音記号が直接入力されていた時にExtendScriptが実行不可になる問題に対応.
2012/01/18 Ver 2.1.1.0 Update ローマ字の正式対応.
2012/01/14 Ver 2.1.0.0 Update AE CS5以上での動作の改善.
2012/01/14 Ver 2.0.0.0 Update AEでの対応バージョンの変更(CS4以前の再対応).
2011/12/26 Ver 1.2.0.0 Update 母音情報からスライダ制御の追加. AEでの対応バージョンの変更(CS4以前の切り捨て).
2011/12/25 Ver 1.1.0.0 Update ExtendScriptに母音情報を含むマーカーのレイヤー生成機能の追加,ヘルプの追加
2011/12/24 Ver 1.0.1.0 Update 書き出すExtendScript内のコメントの更新, AEのバージョン判定の追加
2011/12/16 Ver 1.0.0.0 Release

プラグイン配布先 YAMAHA VOCALOID STORE
http://shop.vocaloidstore.com/index.php?gOo=goods_details.dwt&goodsid=5717

プラグイン配布先記事「音のデータとAfter Effects ~VOCALOID3と連携編~」
http://ae-users.com/jp/resources/2012/03/音のデータとAfter-Effects-~VOCALOID3と連携編~/

Q & A
Q1. パートを選択しているのにExtendScriptファイルが出力されません.
A1. 選択されているパートにノートを含んでいるか確認してください.選択されているパートとはMUSICAL EDITORでアクティブになっているパートのことです.
Q2. 出力したExtendScriptファイルの歌詞データ(マーカーのメモ)がおかしい.
A2. 作成されたExtendScriptファイルの歌詞情報はVOCALOID3上で実際にノートに入力されているデータを参照しています.
例えば,「カレーはおいしかった」という歌詞だと,一例として「かれえわおいしかた」といったように,VOCALOIDに正しく歌わせるために入力された歌詞になっています.
Q3. 日本語以外の歌詞の母音情報が正しく入力されていない.
A3. 母音情報は歌詞が日本語・ローマ字の時にのみ有効です.
]]