UM:Cli Cli Export

From DigitalVision
Revision as of 11:10, 15 October 2014 by Alastair (talk | contribs) (Text replacement - "Platform:" to "UM:")

Jump to: navigation, search

Darrow-up.png     Previous Next

Exporting Shots

--export <path>

Export/render supplied composition to specified path

--export-mode <single|multi>

Choose mode of export (single or multi). Required.

--multi-mode 

<visible-src|tracks-src|

visible-rec|tracks-rec>

Set export mode.

Required when using multi mode export.

 

--frame-padding <N>

Set with of numeric padding on filenames on export. This will be zero-padded.

--export-handles <N>

Export each shot with specified handles

Required when using multi mode export.

--smpte-level-clip <true|false>

Clip the exported shot colourspace to SMPTE video levels

Exporting a Composition

--export <path>

--export-mode <single|multi> REQUIRED

 

This command will render and export the specified composition (given by the --composition parameter) to the specified path.

 

dv_note

The <path> argument should be the full path, including the drive letter, filename and extension.

 

The export mode option is required.

 

Command :

$ film_master --project PROJ1 --composition COMP1 \

  --export-mode single \

  --export Z:\jobs\001\graded_m.dpx

INFO Opening project "PROJ1".

INFO Opening composition "COMP1".

INFO export ... exported 0 frames of 60 (0%)

...

INFO export ... exported 60 frames of 60 (100%)

 

dv_note

Exporting shots on the command line will not generate caches. This is different behaviour to the GUI where you have a choice of caching behaviour when exporting media.

Export Variables

The export path specified with --export can contain export variables such as $o, $f etc.

 

dv_note

See section Export Variables for a description of available variables.

Example

--export S:\exports\$o\$c_graded..dpx \

 --export-mode single

 

Producing a single file sequence named from the clip name, in a folder named from composition :

 

GRADED_MASTER\approved.090000.dpx ... approved.092421.dpx

Exporting Numeric Files

To export files with numeric filenames only, use the $f (frame number) variable :

 

--export S:\exports\$e\$f.tiff

 

Produces numeric files in event folders e.g.

 

0045\008331.tiff

Export Modes

--export-mode <single|multi> REQUIRED

--multi-mode <visible-src|visible-rec|tracks-src|tracks-rec>

--export-handles <N>

 

You can export your composition as a single contiguous clip (single), in multiple shot chunks (multi), using source timecode (src) or using record timecode (rec).

 

There is one single mode and four types of multi mode, each multi mode laying out the exported shots slightly differently. The four multi modes are :

 

--multi-mode visible-src
--multi-mode visible-rec
--multi-mode tracks-src
--multi-mode tracks-rec

 

dv_alert

Because shots might be overwritten if they have overlapping timecodes, you should consider the use of an event folder variable ($e) when exporting.

 

dv_note

See the Exporting chapter for a fuller description of Export Modes.

Example

dv_note

The following examples are split over two lines using a line continuation character. In reality, the command would be on a single line only.

 

--export S:\export\$e\$c..dpx --export-mode multi \

 --multi-mode visible-rec --export-handles 20

 

Producing multiple event folders, each containing one shot with record order timecodes :

 

0001/NOCLIP.090000.dpx ...

0002/fixed.0090078.dpx ...

etc.

Frame Number Padding

--frame-padding <N>

 

This sets the numeric padding on exported filenames.

 

dv_note

Numbers are zero padded i.e. 008999.dpx is frame padding of six.

Shot Handles

--export-handles <N>

 

In multi-mode export, set how many handles to export per shot. This is required in multi-mode.

SMPTE Level Clip

--smpte-level-clip <true|false>

 

This setting will clip the exported shot to a SMPTE video level (i.e. 64-940 for 10 bit data).

 

dv_note

This is only applicable to SMPTE colourspace projects.

 

Darrow-up.png     Previous Next