Project Configuration File Keywords

 
 
 

Framerate

The Framerate keyword sets the default framerate for the project work session.

The Framerate keyword uses the following syntax

Framerate <frame_rate>

where <frame_rate> is 23.976, 24, 25, 29.97, 30, 50, 59.94 or 60 frames per second.

Example of use

Framerate 29.97

Timecode

The Timecode keyword sets the default timecode format used by the project.

The Timecode keyword uses the following syntax

Timecode <format>[, DF]

Where: Is:
<format> One of the following timecode formats: 23.976, 24, 25, 29.97, 30, 50, 59.94, or 60.
DF An optional parameter indicating drop-frame timecode for 29.97 or 59.94 fps timecode formats.
Examples of use
Timecode Format Keyword Example
30 fps Timecode 30
29.97 fps (drop frame) Timecode 29.97, DF

ColourSpace

The ColourSpace keyword defines how RGB/YUV conversions are handled. By default, for NTSC or PAL projects, the ITU-R BT.601-5 colour space is used. For DTV projects, the ITU-R BT.709-3 colour space is used.

The ColourSpace keyword uses the following syntax

ColourSpace <space_type>

where <space_type> is the colour space type used by the project.

Examples of use
Project Keyword Example
NTSC and PAL standard projects (ITU-R BT.601-5) ColourSpace 601
DTV standard projects (ITU-R BT.709-3) ColourSpace 709
1920x1035 projects (SMPTE-240M) ColourSpace 240

Hires

The Hires keyword sets the refresh rate of the graphics monitor. Note the following when setting the refresh rate:

The Hires keyword uses the following syntax

Hires [Custom,]<refresh_rate>

Where: Is:
Custom An optional parameter that overrides the application's refresh rate. For example, you may choose to override the 60-Hz refresh rate for an NTSC project by using the Custom option with a value of 30Hz.
<refresh_rate> The refresh rate of the graphics monitor. Append Hz for free-running configurations, Hzf for configurations that are fixed to an external sync source.
Examples of use
Project Resolution Keyword Example
NTSC Hires 60Hz
PAL Hires 50Hz
NTSC (external sync source) Hires 30Hzf
PAL (external sync source) Hires 25Hzf
Film Hires 48Hz
24p Multi-Master Editing Hires 60Hz
Custom Hires Custom, 30Hz

VideoPreviewWindow

The VideoPreviewWindow keyword is used when using a Miranda DVI-Ramp device. It locates a preview device that has a matching size and refresh rate in the VideoPreviewDevice list specified in the init.cfg configuration file. When you start the application or switch to another project from the application, the graphics-to-video display is mapped to the appropriate device according to the width, height, and refresh rate specified with this keyword.

The VideoPreviewWindow keyword uses the following syntax

VideoPreviewWindow <xsize>, <ysize>, <refresh_rate>

Where: Is:
<xsize>, <ysize> The horizontal and vertical size of the area of the image window output to the graphics-to-video display.
<refresh_rate> The refresh rate of the output.
Example of use

VideoPreviewWindow 720, 486, 30

ArchiveLibrary

Online HTML and ASCII tables of contents will be saved to the filesystem. You can specify the destination directory by setting this keyword. Its default value is /usr/discreet/archive. You can make the target directory relative to the project directory by prefixing the path with a tilde (e.g. ~/archive).

NoteThis keyword, if set, will take precedence over the ArchiveLibrary keyword in the init.cfg file.
The ArchiveLibrary keyword uses the following syntax

ArchiveLibrary <directory_path>

where <directory_path> is the path to which online HTML and ASCII tables of contents are saved.

Example of use

ArchiveLibrary /usr/discreet/archive

Environment Directory

Environment directory keywords specify the paths to directories containing resources for all projects. For example, the LUTs that Autodesk provides are located in the directory /usr/discreet/<product_home>/lut. You can place resource files in these directories that you want to be able to share between projects more easily.

Not all directories are relevant to the application. However, the inclusion of directories pertaining to other Visual Effects and Finishing products allows for cross-product project compatibility.

The ~ in the following table stands for /usr/discreet/<product_home>.

Resource Path Resource File Extension
Action ~/action .action
Audio ~/audio .audio
AudioDesk ~/audio .audiodesk
Audio ImpExp ~/audio .aiff
AutoMatte ~/automatte .automatte
AutoPaint ~/paint/autopaint .auto
Average ~/average .average
Axis ~/axis .dve
Batch ~/batch .batch
BatchClip ~/batchclip .clip
Blur ~/blur .blur
Burnin ~/burnin .burnin
ColourCurves ~/ccurves .ccurves
ColourFrame ~/colourframe .col
Colour Warper ~/colourwarper .cw
Composite ~/composite .composite
Compound ~/compound .compound
Correct ~/correct .correct
Cutout ~/paint/cutout .sgi
Deal ~/deal .deal
DeGrain ~/degrain .degrain
DeInterlace ~/deinterlace .deinterlace
Desktop ~/desktop .desk
Difference ~/difference .diff
Dissolve ~/dissolve .dissolve
Distort ~/distort .distort
Documentation ~/documentation .pdf
DVE ~/dve .dve
Edge ~/edge .edge
EDL ~/edl .edl
Export ~/export .export
ExprUserFun ~/expressions/userfun .expressions
FieldMerge ~/fieldmerge .fieldmerge
Filter ~/filter .filter
FilmCompress ~/filmcompress .compress
FilmExpand ~/filmexpand .expand
Flip ~/flip .flip
Geometry (Paint) ~/paint/geometry .geom
GMask ~/gmask .GMask
Guides ~/guides .guide
Histo2d ~/histo2d .histo2d
HotKey ~/hotkey .hotkey
Image ~/images See Image File Extensions.
Import ~/import .import
Interlace ~/interlace .interlace
Key ~/key .key
Keyer3d ~/keyer3d .key3d
LensDistort ~/lensDistort .lensDistort
Letterbox ~/letterbox .letterbox
LogicOp ~/logicop .logicop
Lumkey ~/lumkey .lumkey
Lut ~/lut .lut
Mask (Paint) ~/paint/mask .sgi
MasterKeyer ~/masterkeyer .mkeyer
Mix ~/mix .mix
Moncal ~/monitor .monitor
ModularKeyer ~/modularKeyer .modularKeyer
Mono ~/mono .mono
Morf ~/morf .morf
MotionAnalyse ~/motionAnalyse .motionAnalyse
MotionBlur ~/motionBlur .motionBlur
NormalMap ~/normalmap .normalmap
Note ~/note .note
Omf® ~/images .omf
Optics ~/optics .optics
Output ~/output .output
Paint ~/paint .paintnode.xml
Picture ~/paint/picture .sgi
Play ~/play N/A
Posterize ~/posterize .posterize
Pulldown ~/pulldown .pulldown
QComp ~/quickcomp .qcomp
ReGrain ~/regrain .regrain
Repeat ~/repeat .repeat
Resize ~/resize .resize
Restore ~/filmrestore .restore
Spark ~/sparks .spark
Stabilizer ~/stabilizer .stabilizer
Text ~/text .ttg
Timewarp ~/timewarp .timewarp
VectorViewer ~/vectorViewer .vectorViewer
Wipe ~/wipe .wipe