Difference between revisions of "UM:Cli Cli Format Spec Definition"

From DigitalVision
Jump to: navigation, search
m (Text replacement - "|Platform:" to "|UM:")
 
(One intermediate revision by the same user not shown)
Line 5: Line 5:
 
{{Template:M-Title|Project Format Specification}}
 
{{Template:M-Title|Project Format Specification}}
  
−
<p class="p_DVBodyText"><span class="f_DVBodyText">A project is defined using a </span><span class="f_DVBodyText" style="font-style: italic;">project format specification</span><span class="f_DVBodyText"> file. This file is of the following format :</span></p>
+
A project is defined using a project '''format specification''' file.
−
<p class="p_DVBodyText"><span class="f_DVBodyText"> </span></p>
+
 
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 0px;"><table bgcolor="#ddeeff" border="0" cellpadding="0" cellspacing="0" style="background-color: #ddeeff; border: none; border-spacing:0px;" width="80%">
+
The format is as follows :
−
<tr style="text-align:left;vertical-align:top;">
+
 
−
<td valign="top"><p class="p_CodeExample"><span class="f_CodeExample">&lt;Global Parameters&gt;</span></p>
+
<pre>
−
<p class="p_CodeExample"><span class="f_CodeExample"># one or more output sections</span></p>
+
<Global Parameters>
−
<p class="p_CodeExample"><span class="f_CodeExample">[output]</span></p>
+
# one or more output sections
−
<p class="p_CodeExample"><span class="f_CodeExample">key=value</span></p>
+
[output]
−
<p class="p_CodeExample"><span class="f_CodeExample">...</span></p>
+
key=value
−
<p class="p_CodeExample"><span class="f_CodeExample"># zero or more source sections</span></p>
+
...
−
<p class="p_CodeExample"><span class="f_CodeExample">[source]</span></p>
+
# zero or more source sections
−
<p class="p_CodeExample"><span class="f_CodeExample">key=value</span></p>
+
[source]
−
<p class="p_CodeExample"><span class="f_CodeExample">...</span></p>
+
key=value
−
</td>
+
...
−
</tr>
+
</pre>
−
</table>
+
 
−
</div>
+
{{M-Note|Note that :
−
<p class="p_DVHeader3"><span class="f_DVHeader3">Data Types</span></p>
+
* The ''keys'' (e.g. ''convertFilter'') are '''case-sensitive'''.
−
<p class="p_DVBodyText"><span class="f_DVBodyText">The various data types we can use in the specification are as shown in the table below.</span></p>
+
* The ''values'' are case-insensitive.
−
<p class="p_DVBodyText"><span class="f_DVBodyText"> </span></p>
+
** So "SMPTE" can be written "smpte", "FilmLog" as "filmlog" etc.
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="2" cellspacing="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
+
}}
−
<tr style="text-align:left;vertical-align:top;">
+
 
−
<th bgcolor="#c0c0c0" style="width:207px; background-color:#c0c0c0; border: solid 1px #000000;" valign="top" width="207"><p class="p_DVTableTextHeader"><span class="f_DVTableTextHeader">Data Type</span></p>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
</th>
+
<!-- /// Data Types
−
<th bgcolor="#c0c0c0" style="width:423px; background-color:#c0c0c0; border: solid 1px #000000;" valign="top" width="423"><p class="p_DVTableTextHeader"><span class="f_DVTableTextHeader">Description</span></p>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
</th>
+
 
−
<th bgcolor="#c0c0c0" style="width:358px; background-color:#c0c0c0; border: solid 1px #000000;" valign="top" width="358"><p class="p_DVTableTextHeader"><span class="f_DVTableTextHeader">Examples</span></p>
+
{{M-Heading1|Data Types}}
−
</th>
+
 
−
</tr>
+
The various data types we can use in the specification are as shown in the table below.
−
<tr style="text-align:left;vertical-align:top;">
+
 
−
<td style="width:207px; border: solid 1px #000000;" valign="top" width="207"><p class="p_DVTableText"><span class="f_DVTableText">&lt;bool&gt;</span></p>
+
{| class="wikitable" width="75%"
−
</td>
+
 
−
<td style="width:423px; border: solid 1px #000000;" valign="top" width="423"><p class="p_DVTableText"><span class="f_DVTableText">A boolean true/false</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
!Data Type
−
<td style="width:358px; border: solid 1px #000000;" valign="top" width="358"><p class="p_DVTableText"><span class="f_DVTableText">true, false</span></p>
+
!Description
−
</td>
+
!Example
−
</tr>
+
 
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:207px; border: solid 1px #000000;" valign="top" width="207"><p class="p_DVTableText"><span class="f_DVTableText">&lt;int&gt;</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="15%"|
−
<td style="width:423px; border: solid 1px #000000;" valign="top" width="423"><p class="p_DVTableText"><span class="f_DVTableText">Integer number</span></p>
+
<bool>
−
</td>
+
|width="40%"|
−
<td style="width:358px; border: solid 1px #000000;" valign="top" width="358"><p class="p_DVTableText"><span class="f_DVTableText">1556</span></p>
+
A boolean true/false
−
</td>
+
|
−
</tr>
+
true, false
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:207px; border: solid 1px #000000;" valign="top" width="207"><p class="p_DVTableText"><span class="f_DVTableText">&lt;float&gt;</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|
−
<td style="width:423px; border: solid 1px #000000;" valign="top" width="423"><p class="p_DVTableText"><span class="f_DVTableText">Floating point number</span></p>
+
<int>
−
</td>
+
|
−
<td style="width:358px; border: solid 1px #000000;" valign="top" width="358"><p class="p_DVTableText"><span class="f_DVTableText">29.97</span></p>
+
An integer number
−
</td>
+
|
−
</tr>
+
1556
−
</table>
+
<!-- ----------------------------------------------------- -->
−
</div>
+
|- style="vertical-align:top;"
−
<p class="p_DVHeader1"><span class="f_DVHeader1">Global Parameters</span></p>
+
|
−
<p class="p_DVBodyText"><span class="f_DVBodyText">These parameters appear </span><span class="f_DVBodyText" style="font-weight: bold;">outside</span><span class="f_DVBodyText"> an </span><span class="f_DVBodyText" style="font-style: italic;">output</span><span class="f_DVBodyText"> or </span><span class="f_DVBodyText" style="font-style: italic;">source</span><span class="f_DVBodyText"> section, at the start of the file. We </span><span class="f_DVBodyText" style="text-decoration: underline;">underline</span><span class="f_DVBodyText"> required options.</span></p>
+
<float>
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">colourScaling</span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
A floating point number
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
29.97
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">SMPTE CGR FilmLog VideoLog</span></p>
+
<string>
−
</td>
+
|
−
</tr>
+
A string
−
<tr style="text-align:left;vertical-align:top;">
+
|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
This is a string<br/>
−
</td>
+
NOTE: quotes should not be used.
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
<!-- ----------------------------------------------------- -->
−
</td>
+
|}
−
</tr>
+
 
−
</table>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
</div>
+
<!-- /// GLOBAL SECTION
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Project colour scaling mode.</span></p>
+
 
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
{{M-Heading1|Global Parameters}}
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">outputClip</span></p>
+
 
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
These parameters appear outside an output or source section, at the start of the file.
−
<tr style="text-align:left;vertical-align:top;">
+
 
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
{{M-Note|Required options are in '''bold'''.}}
−
</td>
+
 
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;bool&gt;</span></p>
+
 
−
</td>
+
{| class="wikitable" width="100%"
−
</tr>
+
 
−
<tr style="text-align:left;vertical-align:top;">
+
|- style="vertical-align:top;"
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
!Name
−
</td>
+
!Values
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText">false</span></p>
+
!Default
−
</td>
+
!Note
−
</tr>
+
<!-- ----------------------------------------------------- -->
−
</table>
+
|- style="vertical-align:top;"
−
</div>
+
|width="25%"|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
'''colourScaling'''
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Project output clipping.</span></p>
+
|width="30%"|
−
<p class="p_DVHeader1"><span class="f_DVHeader1">Output Section Parameters</span></p>
+
SMPTE, CGR, FilmLog, VideoLog, ACES
−
<p class="p_DVBodyText"><span class="f_DVBodyText">These parameters appear inside an </span><span class="f_DVBodyText" style="font-style: italic;">output</span><span class="f_DVBodyText"> section.</span></p>
+
|
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">width</span></p>
+
-
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
ACES from <span class="m-new">[2011.2.094]</span>
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
<!-- ----------------------------------------------------- -->
−
<tr style="text-align:left;vertical-align:top;">
+
|- style="vertical-align:top;"
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|width="25%"|
−
</td>
+
outputClip
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;int&gt;</span></p>
+
|width="30%"|
−
</td>
+
<bool>
−
</tr>
+
|
−
<tr style="text-align:left;vertical-align:top;">
+
-
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|
−
</td>
+
 
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
<!-- ----------------------------------------------------- -->
−
</td>
+
|- style="vertical-align:top;"
−
</tr>
+
|width="25%"|
−
</table>
+
outputScaling
−
</div>
+
|width="30%"|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
none, tosdi, tosmpte, <bool>
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">The width (x resolution)of the output format in pixels.</span></p>
+
|
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">height</span></p>
+
none<br/>
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
'''Note:''' tosmpte if ''colourScaling'' is CGR
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
Whether to perform output colour scaling.<br/><span class="m-new">[2015.2]</span>
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="25%"|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;int&gt;</span></p>
+
stereo
−
</td>
+
|width="30%"|
−
</tr>
+
<bool>
−
<tr style="text-align:left;vertical-align:top;">
+
|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
false
−
</td>
+
|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
<span class="m-new">[2011.2.094]</span>
−
</td>
+
<!-- ----------------------------------------------------- -->
−
</tr>
+
|- style="vertical-align:top;"
−
</table>
+
|width="25%"|
−
</div>
+
previewTransform
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|width="30%"|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">The height (y resolution)of the output format in pixels.</span></p>
+
none, dolby_pq
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">fps</span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
-
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
Valid for ''colourScaling'' '''ACES''' only.<br/>If not set, we use Gamma 2.2.<br/><span class="m-new">[2012.1.054]</span>
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="25%"|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;float&gt;</span></p>
+
contentMappingID
−
</td>
+
|width="30%"|
−
</tr>
+
DolbyCM
−
<tr style="text-align:left;vertical-align:top;">
+
|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
-
−
</td>
+
|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
<span class="m-new">[2014.2.020]</span>
−
</td>
+
<!-- ----------------------------------------------------- -->
−
</tr>
+
|- style="vertical-align:top;"
−
</table>
+
|width="25%"|
−
</div>
+
AcesVersion
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|width="30%"|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">The frames per second. If no decimal point set, we add a .0 automatically e.g. 29.97, 25</span></p>
+
1, 2, 3
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">aspectRatio</span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
-
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
Valid for ''colourScaling'' '''ACES''' only.<br/>
−
<tr style="text-align:left;vertical-align:top;">
+
* 1 = ACES version 0.1
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
* 2 = 0.1.1
−
</td>
+
* 3 = 1.0.1
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;int&gt;/&lt;int&gt;</span></p>
+
<span class="m-new">[2015.3.038]</span>
−
</td>
+
|- style="vertical-align:top;"
−
</tr>
+
|width="25%"|
−
<tr style="text-align:left;vertical-align:top;">
+
cacheStages
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|width="30%"|
−
</td>
+
Source, InputFx, Layer, Output<br/>
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
'''Also :''' All, None, ToLayers
−
</td>
+
|
−
</tr>
+
-
−
</table>
+
|
−
</div>
+
'''Supercedes "Output / cacheOutput" setting'''
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
* "All" is equivalent to : Source,InputFx,Layer,Output
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">The output format image aspect ratio. Specify as M/N e.g. 1316/1000</span></p>
+
* "ToLayers" is equivalent to : Source,InputFx,Layer
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">dropFrame</span></p>
+
<span class="m-new">[2017.1]</span>
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
<!-- ----------------------------------------------------- -->
−
<tr style="text-align:left;vertical-align:top;">
+
|}
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
 
−
</td>
+
 
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;bool&gt;</span></p>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
</td>
+
<!-- /// OUTPUT SECTION
−
</tr>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
<tr style="text-align:left;vertical-align:top;">
+
 
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
{{M-Heading1|Output Section Parameters}}
−
</td>
+
 
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText">false</span></p>
+
These parameters appear inside an ''output'' section.
−
</td>
+
 
−
</tr>
+
{| class="wikitable" width="100%"
−
</table>
+
 
−
</div>
+
|- style="vertical-align:top;"
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
!Name
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Set if output format is drop-frame.</span></p>
+
!Values
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">videoOutput</span></p>
+
!Default
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
!Note
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="10%"|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;bool&gt;</span></p>
+
'''width'''
−
</td>
+
|width="15%"|
−
</tr>
+
<int>
−
<tr style="text-align:left;vertical-align:top;">
+
|width="10%"|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
-
−
</td>
+
|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText">false</span></p>
+
The width (x resolution) of the output format in pixels.
−
</td>
+
<!-- ----------------------------------------------------- -->
−
</tr>
+
|- style="vertical-align:top;"
−
</table>
+
|width="20%"|
−
</div>
+
'''height'''
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|width="10%"|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Specifies if Video Output is enabled on output format.</span></p>
+
<int>
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">fields</span></p>
+
|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
-
−
<tr style="text-align:left;vertical-align:top;">
+
|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
The height (y resolution) of the output format in pixels.
−
</td>
+
 
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">f2:f1 f1:f2 frames</span></p>
+
<!-- ----------------------------------------------------- -->
−
</td>
+
|- style="vertical-align:top;"
−
</tr>
+
|width="20%"|
−
<tr style="text-align:left;vertical-align:top;">
+
'''fps'''
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|width="10%"|
−
</td>
+
<float>
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">frames</span></p>
+
|
−
</td>
+
-
−
</tr>
+
|
−
</table>
+
The frames per second. If no decimal point set, we add a .0 automatically e.g. 29.97, 25
−
</div>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|- style="vertical-align:top;"
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Specifies if output format is field based and gives field order.</span></p>
+
|width="20%"|
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">channels</span></p>
+
'''aspectRatio'''
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
|width="10%"|
−
<tr style="text-align:left;vertical-align:top;">
+
<int>/<int>
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|
−
</td>
+
-
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">RGB RGBA</span></p>
+
|
−
</td>
+
The output format image aspect ratio. Specify as M/N e.g. 1316/1000
−
</tr>
+
<!-- ----------------------------------------------------- -->
−
<tr style="text-align:left;vertical-align:top;">
+
|- style="vertical-align:top;"
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|width="20%"|
−
</td>
+
name
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">RGB</span></p>
+
|width="10%"|
−
</td>
+
<string>
−
</tr>
+
|
−
</table>
+
-
−
</div>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
Give the output format a user-defined name e.g. TV Format 2.2.<br/><span class="m-new">[2013.1.027]</span>
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Colour channels</span></p>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">bitDepth</span></p>
+
|- style="vertical-align:top;"
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
|width="20%"|
−
<tr style="text-align:left;vertical-align:top;">
+
dropFrame
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|width="10%"|
−
</td>
+
<bool>
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">8,10,16,half</span></p>
+
|
−
</td>
+
false
−
</tr>
+
|
−
<tr style="text-align:left;vertical-align:top;">
+
Set if output format is drop-frame.
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
<!-- ----------------------------------------------------- -->
−
</td>
+
|- style="vertical-align:top;"
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">10</span></p>
+
|width="20%"|
−
</td>
+
cacheOutput
−
</tr>
+
|width="10%"|
−
</table>
+
<bool>
−
</div>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
false
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Output colour depth per colour channel, in bits per pixel.</span></p>
+
|
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">convertMode</span></p>
+
'''Deprecated from release 2017.1'''. See ''cacheStages'' setting above.<br/>
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
If ''cacheOutput'' appears in 2017.1 or newer :
−
<tr style="text-align:left;vertical-align:top;">
+
* If "true" - equivalent to ''cacheStages = All''
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
* If "false" - equivalent to ''cacheStages = ToLayers''
−
</td>
+
If there are multiple output sections with this directive, the last one will set the ''cacheStages'' state.
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">none fit crop center</span></p>
+
<!-- ----------------------------------------------------- -->
−
</td>
+
|- style="vertical-align:top;"
−
</tr>
+
|width="20%"|
−
<tr style="text-align:left;vertical-align:top;">
+
videoOutput
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|width="10%"|
−
</td>
+
<bool>
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">none</span></p>
+
|
−
</td>
+
false
−
</tr>
+
|
−
</table>
+
Specifies if ''Video Output'' is enabled on output format.
−
</div>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|- style="vertical-align:top;"
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Output format conversion from source.</span></p>
+
|width="20%"|
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">convertFilter</span></p>
+
fields
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
|width="10%"|
−
<tr style="text-align:left;vertical-align:top;">
+
f2:f1,f1:f2,frames
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|
−
</td>
+
frames
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">none box bilinear gaussian zom lanczos</span></p>
+
|
−
</td>
+
Specifies if output format is field based and gives field order.
−
</tr>
+
<!-- ----------------------------------------------------- -->
−
<tr style="text-align:left;vertical-align:top;">
+
|- style="vertical-align:top;"
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|width="20%"|
−
</td>
+
channels
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">zom</span></p>
+
|width="10%"|
−
</td>
+
RGB,RGBA
−
</tr>
+
|
−
</table>
+
RGB
−
</div>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
Colour channels.
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">What conversion filter to use on the source (if </span><span class="f_DVBodyTextIndent1" style="font-style: italic;">convertMode</span><span class="f_DVBodyTextIndent1"> not "none")</span></p>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">applyCms</span></p>
+
|- style="vertical-align:top;"
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
|width="20%"|
−
<tr style="text-align:left;vertical-align:top;">
+
bitDepth
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
|width="10%"|
−
</td>
+
8,10,16,half
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;bool&gt;</span></p>
+
|
−
</td>
+
10
−
</tr>
+
|
−
<tr style="text-align:left;vertical-align:top;">
+
Output colour depth per colour channel, in bits per pixel.
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
 
−
</td>
+
<!-- ----------------------------------------------------- -->
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText">false</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="20%"|
−
</tr>
+
convertMode
−
</table>
+
|width="10%"|
−
</div>
+
none,fit,crop,center
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Specifies if the </span><span class="f_DVBodyTextIndent1" style="font-style: italic;">Apply CMS</span><span class="f_DVBodyTextIndent1"> toggle is on or off.</span></p>
+
none
−
<p class="p_DVHeader1"><span class="f_DVHeader1">Source Section Parameters</span></p>
+
|
−
<p class="p_DVBodyText"><span class="f_DVBodyText">These parameters appear inside an </span><span class="f_DVBodyText" style="font-style: italic;">input</span><span class="f_DVBodyText"> section.</span></p>
+
Output format conversion from source.
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam" style="text-decoration: underline;">scale</span></p>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Required</span></p>
+
|- style="vertical-align:top;"
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|width="20%"|
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="5" cellspacing="0" style="border: none; border-spacing:0px;">
+
convertFilter
−
<tr style="text-align:left;vertical-align:top;">
+
|width="10%"|
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Values :</span></p>
+
none,box,bilinear,gaussian,zom,lanczos
−
</td>
+
|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVConfigParam"><span class="f_DVConfigParam">&lt;int&gt;</span></p>
+
zom
−
</td>
+
|
−
</tr>
+
What conversion filter to use on the source (if ''convertMode'' not "none").
−
<tr style="text-align:left;vertical-align:top;">
+
<!-- ----------------------------------------------------- -->
−
<td style="width:112px;" valign="top" width="112"><p class="p_DVTableText" style="text-align: right;"><span class="f_DVTableText" style="font-weight: bold;">Default :</span></p>
+
|- style="vertical-align:top;"
−
</td>
+
|width="20%"|
−
<td style="width:651px;" valign="top" width="651"><p class="p_DVTableText"><span class="f_DVTableText"> </span></p>
+
applyCms
−
</td>
+
|width="10%"|
−
</tr>
+
<bool>
−
</table>
+
|
−
</div>
+
false
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1"> </span></p>
+
|
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">Sets the scale of the source/proxy. This integer will divide the width and height to set the proxy size. A scale N gives an "N:1" proxy.</span></p>
+
Specifies if the Apply CMS toggle is on or off.
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">bitDepth</span></p>
+
 
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1">As output section above.</span></p>
+
<!-- ----------------------------------------------------- -->
−
<p class="p_DVHeaderParam"><span class="f_DVHeaderParam">convertFilter</span></p>
+
 
−
<p class="p_DVBodyTextIndent1"><span class="f_DVTableText">As outp</span><span class="f_DVBodyTextIndent1">ut section above.</span></p>
+
|}
−
<p class="p_DVBodyTextIndent1"><span class="f_DVBodyTextIndent1" style="font-weight: bold;">Only applicable if scale &gt; 1.</span></p>
+
 
−
<p class="p_DVHeader1"><span class="f_DVHeader1">Notes</span></p>
+
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
−
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_DVBodyTextIndent1">The </span><span class="f_DVBodyTextIndent1" style="font-style: italic;">key</span><span class="f_DVBodyTextIndent1"> values are </span><span class="f_DVBodyTextIndent1" style="font-weight: bold;">case-sensitive</span><span class="f_DVBodyTextIndent1">.</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 40px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_DVBodyText" style="font-style: italic;">Values</span><span class="f_DVBodyText"> are </span><span class="f_DVBodyText" style="font-weight: bold;">case-insensitive</span><span class="f_DVBodyText"> (e.g. use "rgb" or "RGB").</span></td></tr></table></div><p class="p_DVBodyText"><span class="f_DVBodyText"> </span></p>
+
<!-- /// SOURCE SECTION
 +
<!-- ////////////////////////////////////////////////////////////////////////////////////////////////////////// -->
 +
 
 +
{{M-Heading1|Source Section Parameters}}
 +
 
 +
These parameters appear inside an ''input'' section.
 +
 
 +
{| class="wikitable" width="80%"
 +
 
 +
|- style="vertical-align:top;"
 +
!Name
 +
!Values
 +
!Default
 +
!Note
 +
<!-- ----------------------------------------------------- -->
 +
|- style="vertical-align:top;"
 +
|width="20%"|
 +
'''scale'''
 +
|width="10%"|
 +
<int>
 +
|
 +
-
 +
|
 +
Sets the scale of the source/proxy. This integer will divide the width and height to set the proxy size. A scale N gives an "N:1" proxy.
 +
<!-- ----------------------------------------------------- -->
 +
|- style="vertical-align:top;"
 +
|width="20%"|
 +
bitDepth
 +
|width="10%"|
 +
8,10,16,half
 +
|
 +
10
 +
|
 +
Output colour depth per colour channel, in bits per pixel.
 +
<!-- ----------------------------------------------------- -->
 +
|- style="vertical-align:top;"
 +
|width="20%"|
 +
convertFilter
 +
|width="10%"|
 +
none,box,bilinear,gaussian,zom,lanczos
 +
|
 +
zom
 +
|
 +
Only applicable if '''scale > 1'''.
 +
 
 +
<!-- ----------------------------------------------------- -->
 +
 
 +
|}
 +
 
 +
 
  
 
{{Template:M-Navlinks-bottom|UM:Manual|UM:Cli_Cli_Project|UM:Cli_Attach_And_Detach_Project}}
 
{{Template:M-Navlinks-bottom|UM:Manual|UM:Cli_Cli_Project|UM:Cli_Attach_And_Detach_Project}}
Line 368: Line 417:
 
<!--
 
<!--
 
Originally processed and converted on 2014-06-20 20:09:21
 
Originally processed and converted on 2014-06-20 20:09:21
 +
Now re-formatted on 2017-07-31
 
-->
 
-->

Latest revision as of 16:58, 16 August 2017

Darrow-up.png     Previous Next

Project Format Specification

A project is defined using a project format specification file.

The format is as follows : 

<Global Parameters>
# one or more output sections
[output]
key=value
...
# zero or more source sections
[source]
key=value
...

Note that :

  • The keys (e.g. convertFilter) are case-sensitive.
  • The values are case-insensitive.
    • So "SMPTE" can be written "smpte", "FilmLog" as "filmlog" etc.


Data Types

The various data types we can use in the specification are as shown in the table below.

Data Type Description Example

<bool>

A boolean true/false

true, false

<int>

An integer number

1556

<float>

A floating point number

29.97

<string>

A string

This is a string
NOTE: quotes should not be used.


Global Parameters

These parameters appear outside an output or source section, at the start of the file.

Required options are in bold.


Name Values Default Note

colourScaling

SMPTE, CGR, FilmLog, VideoLog, ACES

-

ACES from [2011.2.094]

outputClip

<bool>

-

outputScaling

none, tosdi, tosmpte, <bool>

none
Note: tosmpte if colourScaling is CGR

Whether to perform output colour scaling.
[2015.2]

stereo

<bool>

false

[2011.2.094]

previewTransform

none, dolby_pq

-

Valid for colourScaling ACES only.
If not set, we use Gamma 2.2.
[2012.1.054]

contentMappingID

DolbyCM

-

[2014.2.020]

AcesVersion

1, 2, 3

-

Valid for colourScaling ACES only.

  • 1 = ACES version 0.1
  • 2 = 0.1.1
  • 3 = 1.0.1

[2015.3.038]

cacheStages

Source, InputFx, Layer, Output
Also : All, None, ToLayers

-

Supercedes "Output / cacheOutput" setting

  • "All" is equivalent to : Source,InputFx,Layer,Output
  • "ToLayers" is equivalent to : Source,InputFx,Layer

[2017.1]


Output Section Parameters

These parameters appear inside an output section.

Name Values Default Note

width

<int>

-

The width (x resolution) of the output format in pixels.

height

<int>

-

The height (y resolution) of the output format in pixels.

fps

<float>

-

The frames per second. If no decimal point set, we add a .0 automatically e.g. 29.97, 25

aspectRatio

<int>/<int>

-

The output format image aspect ratio. Specify as M/N e.g. 1316/1000

name

<string>

-

Give the output format a user-defined name e.g. TV Format 2.2.
[2013.1.027]

dropFrame

<bool>

false

Set if output format is drop-frame.

cacheOutput

<bool>

false

Deprecated from release 2017.1. See cacheStages setting above.
If cacheOutput appears in 2017.1 or newer :

  • If "true" - equivalent to cacheStages = All
  • If "false" - equivalent to cacheStages = ToLayers

If there are multiple output sections with this directive, the last one will set the cacheStages state.

videoOutput

<bool>

false

Specifies if Video Output is enabled on output format.

fields

f2:f1,f1:f2,frames

frames

Specifies if output format is field based and gives field order.

channels

RGB,RGBA

RGB

Colour channels.

bitDepth

8,10,16,half

10

Output colour depth per colour channel, in bits per pixel.

convertMode

none,fit,crop,center

none

Output format conversion from source.

convertFilter

none,box,bilinear,gaussian,zom,lanczos

zom

What conversion filter to use on the source (if convertMode not "none").

applyCms

<bool>

false

Specifies if the Apply CMS toggle is on or off.



Source Section Parameters

These parameters appear inside an input section.

Name Values Default Note

scale

<int>

-

Sets the scale of the source/proxy. This integer will divide the width and height to set the proxy size. A scale N gives an "N:1" proxy.

bitDepth

8,10,16,half

10

Output colour depth per colour channel, in bits per pixel.

convertFilter

none,box,bilinear,gaussian,zom,lanczos

zom

Only applicable if scale > 1.



Darrow-up.png     Previous Next

Retrieved from ‘http://www.digitalvision.tv/w/index.php?title=UM:Cli_Cli_Format_Spec_Definition&oldid=3875’