UM:Edl Import And Conform

From DigitalVision
Revision as of 17:19, 23 February 2018 by Alastair (talk | contribs)

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

Darrow-up.png     Previous Next

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.

dv_note

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.

dv_note

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.

dv_note

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).

dv_alert

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.

dv_note

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.

dv_note

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.

dv_note

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).

dv_note

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.


Darrow-up.png     Previous Next