TMPGEnc Project Creator

(ティーエムペグエンク プロジェクトクリエイター)

 
XML定義一覧
定義項目名 属性定義 詳細説明
タスクヘッダ
Task (必須) 複数の処理を一度に記述する場合に複数指定できます。
一般項目ヘッダ
General (必須) 以下のSaveCreateProjectFile,BatchRegist,BatchStart は<General/General> 内に記述します。
SaveCreateProjectFile overwrite すでに同名ファイルがあった場合の処理
0=上書きしないでエラー
1=上書き
XML定義ファイルから作成したプロジェクトをファイルとして保存するかを指定。保存する場合は、フルパスファイル名を記述する。記述が無い場合、またはファイル名として不適切な場合は保存されません。
BatchRegist (必須) バッチエンコーダーへ登録するかを指定。
0: 登録しない
1: 登録する
0指定で保存プロジェクト名の記述が無い場合、作成したプロジェクトは捨てられます。
BatchStart バッチに登録されたジョブを開始するかを指定します。
0: 何もしない
1: バッチ開始
バッチエンコードツールのバッチジョブを上から順にエンコードを開始します。今回登録したプロジェクトのみがエンコードされるわけではありません。
ColorManagement
(for TVMW7 のみ)
enable カラーマネジメントの有効・無効を指定できます。
0 = カラーマネジメント無効 (初期値)
1 = カラーマネジメント有効
記載例:
<ColorManagement enable="1">

以下の ColorPrimaries,TransferCharacteristics,
ColorToneMap, TargetMaxLuminanceLevel,
LUT は <ColorManagement/ColorManagement> 内に記述します。
ColorPrimaries (必須)
(for TVMW7 のみ)
カラーマネジメント有効時の作業色空間 (原色) を指定します。
設定値:2~19 (設定値の詳細はこちら
記載例:
<ColorPrimaries>2</ColorPrimaries>
TransferCharacteristics (必須)
(for TVMW7 のみ)
カラーマネジメント有効時の作業色空間 (転送特性) を指定します。
設定値:2~28 (設定値の詳細はこちら
記載例:
<TransferCharacteristics>8</TransferCharacteristics>
ColorToneMap
(for TVMW7 のみ)
カラーマネジメント有効時のトーンマッピングを指定します。
設定値:None, HardClip, SoftClip_50, SoftClip_60,
SoftClip_70, SoftClip_80, SoftClip_90
記載例:
<ColorToneMap>SoftClip_60</ColorToneMap>
TargetMaxLuminanceLevel
(for TVMW7 のみ)
カラーマネジメント有効時のクリッピング最大輝度を指定します。
設定値:0 ~10000
記載例:
<TargetMaxLuminanceLevel>800</TargetMaxLuminanceLevel>
LUT
(for TVMW7 のみ)
カラーマネジメント有効時の LUT を適用します。
以下の FileName,ColorPrimaries,TransferCharacteristics は <LUT/LUT> 内に記載します。
FileName LUT ファイル名をフルパスで記述します。
記載例:
<FileName><![CDATA[D:\sample.cube]]></FileName>
ColorPrimaries LUT 適用後の色空間 (原色) を指定します。
設定値:1~19 (設定値の詳細はこちら
記載例:
<ColorPrimaries>2</ColorPrimaries>
TransferCharacteristics LUT 適用後の色空間 (転送特性) を指定します。
設定値:1~28 (設定値の詳細はこちら
記載例:
<TransferCharacteristics>8</TransferCharacteristics>
入力設定ヘッダ
InputSetting (必須) inputmode 現在は 0 を指定してください。
記載例:
<InputSetting inputmode="0">
Clip (必須) Clip は 映像素材、フィルターテンプレートなどを指定する箇所となります。
XML 内に複数の指定が可能となっています。
以下の SourceFileName,KeyframeFileName,VideoSourceFileName,
AudioSourceFileName,Range,SourceVideoProperties,FilterTemplateFileName は<Clip/Clip> 内に記載します。
clipname clipname は自動で設定されるクリップ名を変更する場合のみ記述してください。(最大255文字)
'\/:*?"<>|の各文字は使用できません。
記載例:
<Clip clipname="クリップ1">
keyframefromsource 0 = ソースからキーフレームは読み込みません(デフォルト)
1 = ソースファイル(または映像ソースファイル)内にキーフレームがあれば読み込みます
SourceFileName ファイル名 フルパスで指定。
KeyframeFileName キーフレームファイル ( .keyframe ) を指定。
ファイル名 フルパスで指定。
VideoSourceFileName 入力素材の映像と音声を別々に指定する際に使用します。ファイル名 フルパスで指定。
SourceFileNameが指定されている場合には使用されません。
AudioSourceFileName 入力素材の映像と音声を別々に指定する際に使用します。ファイル名 フルパスで指定。
SourceFileNameが指定されている場合には使用されません。
Range 映像素材から任意の開始点終了点を抽出して出力します。指定範囲は1つのみとなります。
starttime 素材のどの時間からのデータを使用するかを決める範囲指定の開始時間が指定可能です。
表記方法[HH:MM:SS.99]
* 末尾の99は秒の小数点表記となりタイムコードではありません。

記載例:(1分30秒77の場合)
<Range starttime="00:1:30.77" />
endtime 素材のどの時間までのデータを使用するかを決める範囲指定の終了時間が指定可能です。
表記方法[HH:MM:SS.99]
* 末尾の99は秒の小数点表記となりタイムコードではありません。
* endtrim とは排他指定となります。

記載例:(17分18秒23の場合)
<Range endtime="00:17:18.23" />
endtrim
(for TVMW7 のみ)
素材のどの時間までのデータを使用するかを決める範囲指定の終了時間を末端からの相対時間で指定可能です。
表記方法[HH:MM:SS.99]
* 末尾の99は秒の小数点表記となりタイムコードではありません。
* endtime とは排他指定となります。

記載例:(17分18秒23の場合)
<Range endtrim="00:17:18.23" />
SourceVideoProperties
(for TVMW7 のみ)
ソースの映像プロパティを指定します。
以下の VideoType,VideoFieldOrder,VideoAspectRatio,
VideoFrameRate,ColorPrimaries,TransferCharacteristics, MatrixCoefficients, NominalRange, LUT は <SourceVideoProperties/SourceVideoProperties> 内に記述します。
* クリップによっては反映されない場合があります。その場合は、実行時に警告が表示され、その項目をスキップして処理が継続されます。
* ソース情報に変更が無い場合は指定の必要はありません。
VideoType
(for TVMW7 のみ)
映像タイプ(Progressive または Interlace)を記述します。
記載例:
<VideoType>Progressive</VideoType>
VideoFieldOrder
(for TVMW7 のみ)
フィールドオーダー(TopFieldFirst または BottomFieldFirst)を記述します。
記載例:
<VideoFieldOrder>TopFieldFirst</VideoFieldOrder>
VideoAspectRatio
(for TVMW7 のみ)
アスペクト比率を記述します。
表記方法:[dar:xxx:yyy] または[sar:xxx:yyy]
* dar:画面アスペクト比、sar:ピクセルアスペクト比
* xxx, yyy には整数のみ指定可能です。
記載例:
<VideoAspectRatio>dar:16:9</VideoAspectRatio>
VideoFrameRate
(for TVMW7 のみ)
フレームレートを記述します。
表記方法:分数形式
記載例:
<VideoFrameRate>24/1</VideoFrameRate>
ColorPrimaries
(for TVMW7 のみ)
色空間 (原色) を指定します。
設定値:1~19 (設定値の詳細はこちら
記載例:
<ColorPrimaries>2</ColorPrimaries>
TransferCharacteristics
(for TVMW7 のみ)
色空間 (転送特性) を指定します。
設定値:1~28 (設定値の詳細はこちら
記載例:
<TransferCharacteristics>8</TransferCharacteristics>
MatrixCoefficients
(for TVMW7 のみ)
色空間 (マトリクス係数) を指定します。
設定値:0~12 (設定値の詳細はこちら
記載例:
<MatrixCoefficients>7</MatrixCoefficients>
NominalRange
(for TVMW7 のみ)
カラー値範囲を指定します。
設定値:0~2 (設定値の詳細はこちら
記載例:
<NominalRange>1</NominalRange>
LUT
(for TVMW7 のみ)
LUT を適用します。
以下の FileName,ColorPrimaries,TransferCharacteristics は <LUT/LUT> 内に記載します。
FileName LUT ファイル名をフルパスで記述します。
記載例:
<FileName><![CDATA[D:\sample.cube]]></FileName>
ColorPrimaries LUT 適用後の色空間 (原色) を指定します。
設定値:1~19 (設定値の詳細はこちら
記載例:
<ColorPrimaries>2</ColorPrimaries>
TransferCharacteristics LUT 適用後の色空間 (転送特性) を指定します。
設定値:1~28 (設定値の詳細はこちら
記載例:
<TransferCharacteristics>8</TransferCharacteristics>
FilterTemplateFileName 登録Clipに映像フィルターを使用する場合に指定します。ファイル名はフルパスで指定。未記入の場合はデフォルトフィルターテンプレートが使用されます。
出力設定ヘッダ
OutputSetting (必須) outputmode "0" を指定します。
識別ヘッダ
OutputTarget (必須) target "file" を指定します。
出力ファイル名を指定します。ファイル名はフルパスで指定。
EncodeTemplateFileName (必須) 出力設定テンプレートを指定します。ファイル名はフルパスで指定。
Metadata メタデータ設定ヘッダ
出力フォーマットにより全く反映されない場合、一部しか反映されない場合があります。エンコードテンプレートファイル内ですでに指定されている場合、上書きされます。
Title 出力ファイルのメタデータにタイトルを記述します。
Author 出力ファイルのメタデータに作者名を記述します。
Copyright 出力ファイルのメタデータに著作権情報を記述します。
Comment 出力ファイルのメタデータにコメントを記述します。
 
ColorPrimaries 対応リスト *for TVMW7 のみ
設定値 色空間 (原色)
1 PassThrough
2 ITU-R BT.709
3 ITU-R BT.470 System M
4 ITU-R BT.470 System B, G
5 SMPTE 170M
6 SMPTE 240M
7 GenericFilm
8 ITU-R BT.2020
9 SMPTE ST 428-1
10 SMPTE RP 431-2 (DCI-P3 Theater)
11 SMPTE EG 432-1 (DCI-P3 D65)
12 EBU Tech. 3213-E
13 Adobe RGB
14 S-Gamut
15 S-Gamut3.Cine
16 V-Gamut
17 Canon Cinema Gamut
18 ACES
19 ROMM RGB (ProPhoto RGB)
 
TransferCharacteristics 対応リスト *for TVMW7 のみ
設定値 色空間 (転送特性)
1 PassThrough
2 ITU-R BT.709
3 SMPTE 170M
4 ITU-R BT.2020
5 ITU-R BT.470 System M
6 ITU-R BT.470 System B, G
7 SMPTE 240M
8 Linear
9 Logarithmic 100:1
10 Logarithmic 316.22777:1
11 IEC 61966-2-4 (xvYCC)
12 ITU-R BT.1361
13 IEC 61966-2-1 (sRGB / sYCC)
14 ITU-R BT.2100 PQ
15 SMPTE ST 428-1
16 ITU-R BT.2100 HLG
17 Adobe RGB
18 S-Log
19 S-Log2
20 S-Log3
21 V-Log
22 Canon Log
23 Canon Log 2
24 Canon Log 3
25 ROMM RGB (ProPhoto RGB)
26 ITU-R BT.1886
27 IEC 61966-2-2 (scRGB)
28 F-Log
 
MatrixCoefficients 対応リスト *for TVMW7 のみ
設定値 色空間 (マトリクス係数)
0 Unspecified
1 ITU-R BT.709
2 FCC
3 SMPTE 170M
4 ITU-R BT.470 System B, G
5 SMPTE 240M
6 YcgCo
7 ITU-R BT.2020 Non-Constant
8 ITU-R BT.2020 Constant
9 SMPTE ST 2085
10 Chromaticity-Derived Non-Constant
11 Chromaticity-Derived Constant
12 ITU-R BT.2100 ICtCp
 
NominalRange 対応リスト *for TVMW7 のみ
設定値 カラー値範囲
0 Unspecified
1 FullRange
2 CompressedRange

XML定義コードサンプル
以下の内容をXML定義ファイルに記載したサンプル
1つ目のタスク(サッカーの映像をモバイル用低解像度で)
  • 保存するプロジェクトファイル名その1[ProjectFile5.tvmw5]
  • 映像ソースその1(元素材)[soccer.mpg]
  • 素材その1のキーフレーム情報[soccer.keyframe]
  • 映像ソースの開始位置 (時:分:秒)[00:05:00.00]
  • 使用するフィルターテンプレート[soccer.tvmw5f]
  • 出力ファイル名[soccer2011_Low.mp4]
  • 使用するエンコード設定 [soccerLowQuality.tvmw5e]

2つ目のタスク (サッカーの映像をハイビジョン高解像度で)
  • 保存するプロジェクトファイル名その2 [ProjectFile6.tvmw5]
  • 映像ソースその1 (元素材) [soccer.mpg]
  • 素材その1のキーフレーム情報 [soccer.keyframe]
  • 映像ソースの開始位置 (時:分:秒) [00:17:30.00]
  • 使用するフィルターテンプレート [soccer.tvmw5f]
  • 出力ファイル名 [soccer2011_High.mp4]
  • 使用するエンコード設定 [soccerHighQuality.tvmw5e]

<?xml version="1.0" encoding="UTF-8"?>
<TMPGEncVMWImportData version="7.0.0">
<Task>
<General>
<SaveCreateProjectFile overwrite="1"><![CDATA[C:\TVMW7\ProjectFile.tvmw7]]></SaveCreateProjectFile>
<BatchRegist>1</BatchRegist>
<BatchStart>1</BatchStart>
</General>
<InputSetting inputmode="0">
<Clip clipname="クリップ1">
<SourceFileName><![CDATA[C:\movie\soccer.mpg]]></SourceFileName>
<KeyframeFileName><![CDATA[C:\movie\soccer.keyframe]]></KeyframeFileName>
<Range starttime="00:11:25.00" />
<FilterTemplateFileName><![CDATA[C:\Users\user\Documents\TMPGEnc Video Mastering Works 7\Template\Filter\soccer.tvmw7f]]></FilterTemplateFileName>
</Clip>
</InputSetting>
<OutputSetting outputmode="0">
<OutputTarget target="file"><![CDATA[D:\output\soccer2020_Low.mp4]]></OutputTarget>
<EncodeTemplateFileName><![CDATA[C:\Users\user\Documents\TMPGEnc Video Mastering Works 7\Template\Export\soccerLowQuality.tvmw7e]]></EncodeTemplateFileName>
<MetaData>
<Title><![CDATA[Soccer Season1]]></Title>
</MetaData>
</OutputSetting>
</Task>
<Task>
<General>
<SaveCreateProjectFile overwrite="1"><![CDATA[C:\TVMW7\ProjectFile2.tvmw7]]></SaveCreateProjectFile>
<BatchRegist>1</BatchRegist>
<BatchStart>1</BatchStart>
</General>
<InputSetting inputmode="0">
<Clip clipname="クリップ1">
<SourceFileName><![CDATA[C:\movie\soccer.mpg]]></SourceFileName>
<KeyframeFileName><![CDATA[C:\movie\soccer.keyframe]]></KeyframeFileName>
<Range starttime="00:11:25.00" />
<FilterTemplateFileName><![CDATA[C:\Users\user\Documents\TMPGEnc Video Mastering Works 7\Template\Filter\soccer.tvmw7f]]></FilterTemplateFileName>
</Clip>
</InputSetting>
<OutputSetting outputmode="0">
<OutputTarget target="file"><![CDATA[D:\output\soccer2020_High.mp4]]></OutputTarget>
<EncodeTemplateFileName><![CDATA[C:\Users\user\Documents\TMPGEnc Video Mastering Works 7\Template\Export\soccerHighQuality.tvmw7e]]></EncodeTemplateFileName>
<MetaData>
<Title><![CDATA[Soccer Season1]]></Title>
</MetaData>
</OutputSetting>
</Task>
</TMPGEncVMWImportData>