UM:Cli Importing Folders

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

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Darrow-up.png     Previous Next

Importing Folders

--import-folder <path>

Import clips found in named folder (and all sub-folders)

--filter-format <fmt>

Filter clips we import by file format

--filter-res <w> <h>

Filter clips we import by image resolution

--splice-order <file|timecode>

Splice clips found to composition in specified order

--timecode-header [1|2]

Take timecodes from file headers

--timecode-filename

Take timecodes from file names/paths

--tapename-header

Take tapenames from file headers

--tapename-filename <level>

Take tapenames from file names/paths

 

These options control the import of supported image sequences recursively from a specified folder path.

Importing a Folder

--import-folder <start folder path>

 

This command imports all supported image files found in the specified folder and any sub-folders (recursively).

 

Command :

$ film_master --project code2 \

  --import-folder Z:\scans\reel4\

INFO Opening project "code2" from ...

INFO Batch ... importing directory 0 of 1 (0)

INFO Batch ... importing directory 1 of 5 (20)

...

INFO Batch Import (completed) ... 6 of 6 (100)

 

The command shown above has imported the given folder into the specified project "code2". This is a total of six folders searched, the specified folder itself and five sub-folders :

 

z:\scans\reel4\
z:\scans\reel4\0008H\
z:\scans\reel4\0006\
z:\scans\reel4\0005\
z:\scans\reel4\0002\
z:\scans\reel4\0002\high\

Filtering

We can filter the sequences the command selects to import on image resolution (e.g. choose only HD sequences) and image format (e.g. choose only TIFF sequences).

Filter on Resolution

--filter-res <width> <height>

 

This option will select only images that match the given resolution (width x height) in pixels.

 

Command :

$ film_master --project code2 \

  --import-folder z:\scans\reel4\ \

  --filter-res 2048 1556

INFO Opening project "code2" from ...

INFO Batch ... importing directory 0 of 1 (0)

INFO Batch ... importing directory 1 of 5 (20)

...

...

INFO Batch Import (completed) ... 6 of 6 (100)

 

Shots that match the resolution specified will be loaded into the project library.

 

Filter on Image Format

--filter-format <extension>

 

This option will select only image sequences that match the specified file format, given as the common format extension.

 

Command :

$ film_master --project code2 \

  --import-folder z:\scans\reel4\ \

  --filter-format dpx

 

dv_note

For a list of supported formats and recognised extensions, see File Format Support.

Tapename

--tapename-header

--tapename-filename <level>

 

These options override the source of the tapename field we extract when importing each sequence found.

 

dv_note

If you do not specify these options, the default settings will be used as set up in your preferences.

 

Command :

$ film_master --project code2 \

  --import-folder z:\scans\reel4\ \

  --filter-format tif --tapename-filename 1

INFO Opening project "code2" from ...

INFO Batch ... importing directory 0 of 1 (0)

INFO Batch ... importing directory 1 of 5 (20)

...

...

INFO Batch Import (completed) ... 6 of 6 (100)

Timecode

--timecode-header [1|2]

--timecode-filename

 

These options override the source of the timecode we extract when importing each sequence found.

 

Using --timecode-header will attempt to extract the sequence timecode from the file header. If this does not exist (e.g. the format does not support header timecode), then the filename numerics are used to calculate the timecode.

 

dv_note

If you do not specify these options, the default settings will be used as set up in your preferences.

First and Second Timecode

This is a Red R3D file specific option argument.

 

The --timecode-header option takes an optional argument 1 or 2. This allows us to specify whether to use the first or second timecode from an R3D file. With no argument, we default to 1.

 

Command :

$ film_master --project code2 \

  --import-folder z:\scans\episode5\ \

  --filter-format r3d --timecode-header 2

INFO Opening project "code2" from ...

INFO Batch ... importing directory 0 of 1 (0)

INFO Batch ... importing directory 1 of 5 (20)

...

...

INFO Batch Import (completed) ... 6 of 6 (100)

Splicing to a Composition

--splice-order <file|timecode>

 

This option imports the shots found from the folder import and also splices them to a named composition.

 

dv_alert

The composition must be specified via the --composition option.

 

A splice order (file or timecode) is required

file

This splices the found shots to the timeline in the order they are found.

 

dv_note

Note that shots are currently spliced from timecode 00:00:00:00.

timecode

This splices the shots to the timeline in their timecode order.

 

Command :

$ film_master --project code2 --composition comp1 \

  --import-folder z:\scans\episode5\ \

  --filter-format dpx --splice-order timecode

INFO Opening project "code2" from ...

INFO Opening composition "comp1".

 

Darrow-up.png     Previous Next