UM:Cli Cli Capture Conform
--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
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)).
|
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. |
--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.
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.
--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.
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.
|
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 :
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
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... |
