UM:Cli Cli Capture Conform

From DigitalVision
Jump to: navigation, search

Darrow-up.png     Previous Next

Capturing and Conforming

--capture <path>

Capture material from top-level path specified

--capture-list

Print out the internal capture list created.

--match-name <0|1>

Whether to use tapename, clipname or filmname when conforming.

--exact-timecode

When capturing, expect source clips to match the EDL timecode exactly.

--conform

Link timeline to "Found" library clips

--handle-length <N>

Capture N handles

Capture versus Conform

Capture

Searches for source material in specified locations (recursively), trying to match items referenced in the EDL/AAF composition and pulling them into the library. In general, whole clips are captured if present (not just the  event duration).

Conform

Links library items with the composition timeline (you may wish to use an EDL merely to load material into the library (capture only)).

 

dv_note

A conform will always attempt to link the latest library material to the timeline. This means if a later version of a clip is imported or captured, the conform will link to this new version.

Loading the List

--import <path>

 

When we perform a capture operation on a list file created composition, we attempt to match the composition timeline (which reflect the list "events") to actual source material.

 

Consider the following EDL:

 

TITLE: Test EDL

001 721A V  C  01:51:25:07 01:51:25:22 01:05:00:00 01:05:00:15

002 722A V  C  02:37:04:21 02:37:06:12 01:05:00:15 01:05:02:06

003 721A V  C  01:52:27:09 01:52:28:13 01:05:02:06 01:05:03:10

004 722A V  C  02:38:05:16 02:38:06:19 01:05:03:10 01:05:04:13

 

Load an EDL using the following command :

 

Command :

$ film_master --project PROJ1 \

  --import C:\edls\test.edl

INFO Opening project "PROJ1".

INFO /edl/test.edl imported.

 

Results in the composition title "Test EDL" from the EDL "TITLE" parameter.

 

ch-cli_comp

 

At this point, we will have a composition called "Test EDL" in the library. Making it active would show us a timeline consisting of four clips (as per EDL) on a single video track.

These clips will be Offline if we view them using the application monitor.

 

ch-cli_comp-timeline

Displaying the Capture List

--capture-list

 

With an EDL loaded, we can view its status using the --capture-list option :

 

Command :

$ film_master --project PROJ1 --composition "Test EDL" \

  --capture-list

INFO Opening project "PROJ1".

INFO Opening composition "Test EDL".

Clip                  | Start       | End         | Tape    | Status

------------------------+-------------+-------------+------------+----

 721A.[160447-160462] | 01:51:25:07 | 01:51:25:22 |    721A | Ready

 722A.[226197-226236] | 02:37:04:21 | 02:37:06:12 |    722A | Ready

 721A.[161937-161965] | 01:52:27:09 | 01:52:28:13 |    721A | Ready

 722A.[227656-227683] | 02:38:05:16 | 02:38:06:19 |    722A | Ready

 

This is our internal representation of the EDL and its current status "Ready".

Capturing

--capture <path>

--match-name <0|1>

--handle-length <N>

 

To perform the capture, use the --capture option, with an argument of a file path to search :

 

Command :

$ film_master --project PROJ1 --composition "Test EDL" \

  --capture Z:\server\shots

INFO Opening project "PROJ1".

INFO Opening composition "Test EDL".

Clip                  | Start       | End         | Tape    | Status

------------------------+-------------+-------------+------------+----

 721A.[160447-160462] | 01:51:25:07 | 01:51:25:22 |    721A | Found

 722A.[226197-226236] | 02:37:04:21 | 02:37:06:12 |    722A | Found

 721A.[161937-161965] | 01:52:27:09 | 01:52:28:13 |    721A | Found

 722A.[227656-227683] | 02:38:05:16 | 02:38:06:19 |    722A | Found

 

Our status changes to "Found" and we will have clips (four in this case) loaded into the library. These clips are still offline in the monitor however.

 

ch-cli_comp-capture

 

Normally, when searching for source material, we will look at both a clip timecode and its tapename field when attempting to identify a match to the EDL/composition.

Matching Names

--match-name <0|1>

The --match-name option lets you specify whether to take a "name" into account when searching for material to conform.

 

dv_note

The "name" we use is as set in the preferences - and might be clip name, tape name or film name. If we do not specify this option, the settings are taken from the preferences.

 

Our capture operation would then look like:

 

Command :

$ film_master --project PROJ1 --composition "Test EDL" \

  --capture Z:\server\shots \

  --match-name 0

INFO Opening project "PROJ1".

INFO Opening composition "Test EDL".

Clip                  | Start       | End         | Tape   | Status

------------------------+-------------+-------------+------------+----

 721A.[160447-160462] | 01:51:25:07 | 01:51:25:22 |   721A | Found

 722A.[226197-226236] | 02:37:04:21 | 02:37:06:12 |   722A | Found

 721A.[161937-161965] | 01:52:27:09 | 01:52:28:13 |   721A | Found

 722A.[227656-227683] | 02:38:05:16 | 02:38:06:19 |   722A | Found

Handles

--handle-length <N>

Use this option to specify how many head and tail handles to capture.

Capturing with Exact Timecode

--exact-timecode

 

If our EDL looks like the following:

 

TITLE: Test EDL

001 721A V C T1 T2 ....

 

where

 

T1 is the source in timecode
T2 is the source out timecode

 

And our source clip looks like :

 

ch-cli_clip_timecode

where

 

TS is the clip first frame timecode
TE is the clip last frame timecode

 

Then :

 

Normally, a capture operation would find a match for this source clip because our EDL source in/out timecode is completely enclosed within the clip.
Using --exact-timecode will only match during a capture if the EDL source in/out timecode exactly matches the source clip i.e.

T1 == TS AND T2 == TE

 

Command :

$ film_master --project PROJ1 --composition "Test EDL" \

  --capture Z:\server\shots \

  --exact-timecode

Conform

--conform

 

After the capture stage, we can do a conform. This will link captured material to the composition timeline where the capture status is Found.

 

Command :

$ film_master --project PROJ1 --composition "Test EDL" \

  --conform

INFO Opening project "PROJ1".

INFO Opening composition "Test EDL".

INFO Conforming material...

 

ch-cli_comp-timeline

 

Darrow-up.png     Previous Next