UM:Edl Import And Conform
--import-edl <path> |
Import EDL or AAF from given path |
--new --add --mark |
Required (one of)
--new : Create a new composition --add : Operate on existing composition --mark : Mark existing composition |
Additional Options :
--track-type <v|a|l|r|m> |
Specify video, audio, left, right or mono track Default : v |
--merge-from N |
After import, merge grades from track number N Requires : --match |
--match <source|record|clip> |
When merging grades using --merge-from, specify what to match when merging : source timecode, record timecode or clip name |
--track-target N |
Specify target track number N |
--import-material |
Import EDL or AAF referenced material |
--conform-material |
Conform material to composition |
--autoconform |
Import and conform EDL or AAF referenced material in one step |
--conform-record-tc |
Conform to record timecode (default is source timecode) |
--no-translate |
Do not use any EDL tapename translation table |
--strip-extension |
Strip clip name extensions (e.g. .mov etc.) |
--lut-layers |
Import ASC LUT's and create a CDL base layer |
--cdl-layers |
Create an ASC CDL and CDL base layer |
--import-bookmarks |
Import bookmarks ("locator" markers) to the timeline |
Note : track numbers are indexed from 1.
|
Use the --help-import option to the application to see some basic usage for the EDL import functionality. |
Importing
--import-edl <path> < --new | --add | --mark >
To import an EDL or AAF list, use the --import-edl option with the path to the file.
Requirements :
| • | One of the options --new, --add or --mark is required to fully specify the operation. See below. |
|
You can use --import-edl with AAF files but most other options in this chapter relate to EDL import only. |
Creating a New Composition
--import-edl <path> --new
This imports the file and creates a new composition in the library with tracks created as required.
|
No media is imported or linked to a composition automatically. See the --import-material and conform options below. |
Command : |
$ nucoda_film_master --project "PROJ1" \ --import-edl S:\edl\ttt.edl --new INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO ttt.edl imported. |
Naming the Composition
By default, the composition name (material name) is taken from the EDL "TITLE:" line.
Use the --name option to name the composition created explicitly.
Command : |
$ nucoda_film_master --project "PROJ1" \ --import-edl S:\edl\ttt.edl --new \ --name compname INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO ttt.edl imported. |
Adding to an Existing Composition
--import-edl <path> --add
The --add option will import the named EDL and add it to the named composition.
Requirements :
| • | Name the composition we are operating on using the --composition option. |
Command : |
$ nucoda_film_master --project "PROJ1" --composition "compname" \ --import-edl S:\edl\ttt-extra.edl --add INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO Opening composition "compname". INFO ttt-extra.edl imported. |
Target Track
--track-target N
Use this option to add the imported EDL to the specified track. If this option is not given, the EDL is added to the next available track (which will be created).
|
The imported EDL will overwrite the target track. |
Marking an Existing Composition
--import-edl <path> --mark --track-target N
The --mark option imports the named EDL and places "marks" (scene edits) on the track specified. We place the edits on the target track as per the EDL In/Out record timecode (for each EDL event).
Requirements :
| • | The --composition option is required |
| • | The --track-target option is required to specify the target track we mark |
Command : |
$ nucoda_film_master --project "PROJ1" --composition "compname" \ --import-edl S:\edl\ttt-mark.edl \ --mark --track-target 1 INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO Opening composition "compname". INFO ttt-mark.edl marked. |
|
The target track must exist. |
Importing Media and Conforming
--import-material
--conform-material
--autoconform
--conform-record-tc
Importing an EDL creates the basic composition but does not import or link media to the composition. The options described here import actual media to the project library and conform (link) it to the imported EDL.
|
These options work on --import-edl only and assume a command-line that includes :
--import-edl <path> < --new | --add | --mark > |
Importing Media
--import-material
Imports any material referenced when importing the EDL.
Command : |
$ nucoda_film_master --project "PROJ1" \ --import-edl S:\edl\ttt.edl --new \ --import-material INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO ttt.edl imported. |
Material paths are specified per EDL event using a "FROM FILE" syntax as shown below :
TITLE: comptest 001 tape-1 V C 05:04:46:13 05:04:56:03 01:03:16:04 01:03:25:19 * FROM FILE: S:\media\images\mazda-2k\OE5012A\438877.dpx |
Each referenced clip is imported into the project library from the specified file path.
Conforming
--conform-material
Conform (link) any material referenced when importing the EDL. The material is assumed to be in the project library unless the option --import-material is also used.
Command : |
$ nucoda_film_master --project "PROJ1" \ --import-edl S:\edl\ttt.edl --new \ --import-material --conform-material INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO ttt.edl imported. |
Import and Conform in One Step
--autoconform
This will import EDL referenced material into the library and conform (link) it to the composition at the same time.
Command : |
$ nucoda_film_master --project "PROJ1" \ --import-edl S:\edl\ttt.edl --new \ --autoconform INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO ttt.edl imported. |
|
The --autoconform option is equivalent to :
--import-material --conform-material |
Conforming to Record Timecode
--conform-record-tc
When conforming composition events, use the record timecode when doing the match.
Merging Grades
--merge-from < N | mixdown >
--match < source | record | clip >
Use these options to import and add a new EDL to an existing composition, preserving existing grades where shots match. You must specify the track you take the grades from and also how to match the shots (thus selecting the correct grades to merge over).
|
To ensure that any EDL referenced material is imported and conformed, you will also need to use some combination of the conform options above e.g. --autoconform |
Requirements :
| • | The --composition option is required to specify the current composition we merge from. |
| • | The --match option is required to specify how to match the shots. |
| • | Use a conform option (e.g. --autoconform) to link referenced material. |
Choosing Source Track
--merge-from < N | mixdown >
This selects the source track containing the grades to merge or "mixdown" to select the mixed down grades (the "sum" of the grades over all source tracks).
Match Method
--match < source | record | clip >
Required when using --merge-from.
This selects the method to use when matching shots when merging over the grades.
Name |
Method |
source |
Match via source timecode |
record |
Match via record timecode |
clip |
Match using clip name |
Command : |
$ nucoda_film_master --project "PROJ1" \ --composition compname \ --import-edl S:\edl\ttt-merge.edl --add \ --autoconform \ --merge-from 1 \ --match record INFO Opening project "PROJ1" from "D:\Nucoda\2014_1\projects\PROJ1". INFO Opening composition "compname". INFO ttt-merge.edl imported. |
Other Options
Tapename Translation
--no-translate
This option disables the automatic tapename translation on import.
Some EDL files contain a tapename translation table. This table can be used to translate illegal tapenames (e.g. containing spaces) to legal ones (e.g. spaces replaced with underscores). Normally we use this translation table to create correct tapenames once imported.
We support two types of translation table : Avid and Final Cut Pro style.
| Translation Table Type | EDL Line Pattern |
| Avid Style : | >>> SOURCE |
| Apple Final Cut Style : | FINAL CUT PRO REEL: |
Example
TITLE: comptest 001 tape_daily_10 V C 05:04:46:13 05:04:56:03 01:03:16:04 01:03:25:19 * FROM FILE: S:\media\images\mazda-2k\OE5012A\438877.dpx FINAL CUT PRO REEL: tape daily 10 REPLACED BY: tape_daily_10 |
Stripping Clipname Extensions
--strip-extensions
Remove file extensions on any EDL clipnames (e.g. .mov) before processing EDL.
LUT Layers
--lut-layers
If the EDL contains any ASC LUT definitions, this option will enable processing and creation of a CDL base layer.
CDL Layers
--cdl-layers
If the EDL contains any CDL (Color Decision List) definitions, this option will enable processing and creation of a CDL base layer.
Import Bookmarks
| From Release : | 2018.1 |
--import-bookmarks
This will enable the loading of any bookmarks ("LOC" items) from the EDL.
LOC markers are defined in an EDL using the following format :
*LOC: TIMECODE COLOUR DESCRIPTION
Example :
*LOC: 01:00:01:11 CYAN 4th Shot
We support the following colours :
- Red
- Green
- Blue
- Cyan
- Yellow
- Magenta
- Black
- White
We support Timeline Bookmarks only.
Colour names are case-insensitive.
