EDL Enhancements - Layer and Matte additions


  • In order to simplify workflows where multiple mattes and layers are involved in a production we have added the ability to use extensions to our EDL format to allow the creation of colour and effects layers and to assign mattes to specific layers.

  • The purpose of the feature is to allow for the accurate and quick creation of named matte layers and to correctly assign matte sources inside the Nucoda layer stack. In addition to matte assignment the user will also be able to define and add User FX layers, colour layers and locators. 

  • The commands are added as comments after the main event and are processed automatically when importing the EDL.

  • Please note that line breaks are not supported


Matte Tool - Using mattes from multilayer EXR files


This update to the matte effect allows Nucoda to extract mattes from inside a multilayer EXR file. Mattes can be assigned automatically using the EDL. Please note, only the DataWindow display in the EXR is supported. Please see 2019.1 New Features for a full description of the new EXR Multi matte support


Syntax for EXR Layer additions to the EDL


        *NUCODA_LAYER [layer name] [-effect <effect-id>] [-matte.part.channel]


  • [layer name] - optional layer name - no spaces allowed
  • [-effect <effect-id>] - optionally add effect to layer on creation - see end of document  for effect ID list.     
  • [-matte part.channel ] - Set matte part and channel (this will depend on the EXR file)


This example EDL will:


  • Import and place the the main shot on the timeline

  • Add a layer called Shirts and set the Matte input to use the Part called CharMatte10 and channel R

  • There is no need to specify the filename - if there is no filename we will use the file that was imported to the timeline as the source.


TITLE: WIR Mattes

FCM: FILM


001  WIR V     C        00:00:00:01 00:01:07:05 01:00:00:00 01:01:07:04


*FROM FILE: S:\media\EXR-Mattes\wdasMultipartEXRtest\WIR_244.0_011.00_364_main.0001.exr

*NUCODA_LAYER Shirts -matte.part charMatte10.R

*NUCODA_LAYER Noses -matte.part charMatte3.B





Matte Tool - Using the Index Matte option


This update to the matte effect will let the user specify one or a range of grey scale colours in the image alpha channel to be used as a matte in a layer. Using grayscale index values from 0 to 255 allows the creation of multiple mattes in a single alpha channel.


Matte example - using the index


   This example EDL will:


  • Import and place the the main shot on the timeline

  • Create a colour layer named Primary

  • Add a blue segment bookmark with a comment “Graded”

  • Create six separate colour layers each with Mattes set as specified in the EDL using the index numbers and in the last case, a range of indexes to create the matte.


TITLE: Pxr

FCM: FILM


001  Alphafill V     C        00:00:00:01 00:00:00:07 03:00:00:01 03:00:00:07


*FROM FILE: H:\Pxr\AlphaFill.0000.exr

*NUCODA_LAYER Primary


*LOC 03:00:00:00 Blue Graded


*NUCODA_LAYER Index_0 -matte.i 0 0 H:\Pxr\AlphaFill.0000.exr

*NUCODA_LAYER Index_51 -matte.i 51 51 H:\Pxr\AlphaFill.0000.exr

*NUCODA_LAYER Index_153 -matte.i 153 153 H:\Pxr\AlphaFill.0000.exr


*NUCODA_LAYER Index_204 -matte.i 204 204 H:\Pxr\AlphaFill.0000.exr

*NUCODA_LAYER Index_255 -matte.i 255 255 H:\Pxr\AlphaFill.0000.exr

*NUCODA_LAYER Index_255 -matte.i 12 255 H:\Pxr\AlphaFill.0000.exr


Mattes can be created using a single index value or a range of values.

Fill.PNGAlpha.PNG

This EXR image has a colour fill and alongside is the alpha channel containing 5 bars of colour, the index values are 255, 204, 153, 102, 1 from top to bottom.


Index Range.PNG

In the matte effect, the image has been set as its own matte source, the Matte From selection is Index and a single index number or range is selected. Using 153 to 204 as a range results in the following image after being desaturated.


151-204.PNG

Additions were made to the Nucoda EDL format to facilitate setting the mattes.



Syntax for effect and matte additions to the EDL


 *NUCODA_LAYER [layer name] [-effect <effect-id>] [-matte.part.channel]


  • [-matte.r|g|b|a <matte file and path>] - Set matte file and specify image channel to use
  • [-effect <effect-id>] - optionally add effect to layer on creation - see  end of this doc for effect list. 
  • [-matte.i <lowindex> <highindex> <matte file and path>] - Use Index values - please note the both low and high index values must be present - if there is no range set them to equal
  • [-offset <frame-offset>] - optionally offset the matte (the importer will automatically offset the matte so it starts at the same frame as the clip, but you use this to add an additional offset)  
    This will work around the issue of Mattes starting at the wrong TC when using mixed down media with mattes.


   This example EDL will:

  • Import and place the the main shot on the timeline

  • Create a colour layer named Primary

  • Create a User FX layer called Matrix with Gamma Matrix effect in the layer

  • Create six separate colour layers each with Mattes set as specified in the EDL using the Red, Green and  Blue channels respectively.


   TITLE: A L-S3D-with-Mattes-DEMO001

   FCM: FILM


   003  Undead-S3D-LEFT V     C        03:00:08:15 03:00:17:20 03:00:08:15 03:00:17:20


   *FROM FILE: S:\Undead\Media\S3D\Left\Undead-S3D-LEFT_259407.dpx

   *NUCODA_LAYER Primary

   *NUCODA_LAYER Matrix -effect GammaMatrix


   *NUCODA_LAYER 6015_v002 -matte.r S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_003_le.0001.dpx

   *NUCODA_LAYER 6015_v002 -matte.g S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_003_le.0001.dpx

   *NUCODA_LAYER 6015_v002 -matte.b S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_003_le.0001.dpx


   *NUCODA_LAYER 6015_v002 -matte.r S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_004_le.0001.dpx

   *NUCODA_LAYER 6015_v002 -matte.g S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_004_le.0001.dpx

   *NUCODA_LAYER 6015_v002 -matte.b S:\Undead\Media\VFX\Mattes\mt_003\le\mos_reel03_scn0043_shot6015_v002_mt_004_le.0001.dpx


   *LOC: 03:00:08:15 RED RGB Left + Right Mattes



Syntax for LUT  additions to the EDL


   *NUCODA_LAYER [layer name] [-lut <path and LUT name>] 

  • [layer name] - optional layer name - no spaces allowed
  • [-lut <path and LUT name>]  - Adds a LUT Effect in an effects layer and sets the LUT


Example:

* NUCODA_LAYER LUT_Test -lut "D:\example.cms" 

* NUCODA_LAYER LUT_Test2 -lut D:\cool.cms -tetrahedral 

* NUCODA_LAYER LUT_Test3 -lut "Log to CGR - generic s-curve.cms" 

* NUCODA_LAYER LUT_Test3 -lut “f:\Extras\Log to CGR - generic s-curve.cms"


  • Quotes are not needed if the LUT filename has no spaces. 
  • If the filename doesn't contain an “x:\”  the path is taken relative to the ImportLutFolder preference, otherwise it's taken as an absolute path. 
  • You can optionally add -tetrahedral or -trilinear to force the interpolation mode (by default it will be "From Project"). 
  • The behavior with quotes and absolute/relative paths has also been added for the ASC_Inp and ASC_Out commands.



All available extensions in the EDL


* FROM FILE:  <file path and filename> to conform media


* LOC: <timecode> <locator color> [Locator information]  Note: This bookmark is a segment bookmark

    Locator colours:  BLUE | CYAN | MAGENTA | ORANGE | RED | WHITE | YELLOW


* 00:58:22:00 Timeline Bookmark  Note: This bookmark will always be red


* ASC_Inp  <LUT Name>    
LUT is added to Base or Master layer before the Channel Mixer - check colour preferences to choose
      Base or Saster layer


* ASC_Inp  <LUT Name>    
LUT is added to Base or Master layer before the Channel Mixer - check colour preferences to choose
Base or Saster layer

* ASC_Out  <LUT Name> 

LUT is added to Base or Master layer before the Router

* ASC_SAT <Saturation Value>
    If the ASC_SAT value is before the ASC_SOP values, the SAT values are placed in Saturation in the     

colour layer. Else it is placed in the HLS tool.

 * ASC_SOP <(Slope Values) (Offset values) (Power Values)>
    Up to 6 decimal places are supported


* NUCODA_LAYER [layer name] - optional layer name - no spaces allowed

Will add a named or unnamed Colour Layer to the clip



Import EDL...


On importing the EDL into Nucoda there are options to import locators and ASC LUT layers, if you need these, make sure to select the options.

The *NUCODA_LAYER options will be imported and created automatically if they are in the EDL, if the media required for the mattes is not available, layers will be created but mattes will not be assigned.



 Nucoda and Phoenix effect names 


Use the Effect ID as the identifier for adding effects to projects using the extended EDL functions


Effect Name


3:2 Add/Remove............................................

3:2 Auto Remove............................................

Balance..............................................................

Blend..................................................................

Blur......................................................................

Brightness Contrast (Bright Contrast)....

Brightness Regions (Bright Regions).......

Channel Align..................................................

Channel Combine..........................................

Channel Extract...............................................

Channel Mixer.................................................

Clone Colour....................................................

CMS.....................................................................

CMS Path...........................................................

Colour.................................................................

Colour Convert................................................

Colour Curves (Col Curves).........................

Composite.........................................................

Convert..............................................................

Dissolve..............................................................

DVO Alias..........................................................

DVO Aperture..................................................

DVO Brickwall.................................................

DVO Chroma...................................................

DVO Clarity......................................................

DVO Cross Colour..........................................

DVO Deinterlace............................................

DVO Dirt Map.................................................

DVO Dropout..................................................

DVO Dry Clean...............................................

DVO Dust GT...................................................

DVO Fix.............................................................

DVO Dust.........................................................

DVO Flicker......................................................

DVO Frame......................................................

DVO Grain GT.................................................

DVO Grain........................................................

DVO Line Sync................................................

DVO Noise.......................................................

DVO Pixel.........................................................

DVO Print Align (Seq)..................................

DVO Print Align.............................................

DVO Regrain RGB..........................................

DVO Regrain....................................................

DVO Scala (Demo)........................................

DVO Scratch Target......................................

DVO Sharpen..................................................

DVO Sharpen..................................................

DVO Speed Source........................................

DVO Speed......................................................

DVO Steady.....................................................

DVO Steady II.................................................

DVO Stereo Fix..............................................

DVO Three Two..............................................

DVO Twister....................................................

DVO Upscale...................................................

DVO Warp........................................................

DVO Zoom.......................................................

Fade Colour....................................................

Field Dom Correct.........................................

Field Remove.................................................

Field Swap.......................................................

Gamma Matrix...............................................

HLS Colour Correct (HLS)...........................

Hue Curves......................................................

Invert................................................................

Kelvin and Tint (Kelvin Tint)....................

Keyer.................................................................

Lens Distort....................................................

Levels................................................................

Lift Gamma Gain...........................................

Linear to Log..................................................

Log to Linear..................................................

Mesh Warper..................................................

Paint.................................................................

Pan and Scan (Pan Scan)...........................

PQ Matrix........................................................

Printer Lights (Printer)...............................

Quad Balance.................................................

Reflicker..........................................................

Reinterlace......................................................

Retime..............................................................

RGB Curves.....................................................

RGBA Over (Over).........................................

S3D Colour + Align.......................................

Saturation.......................................................

Slope Offset Power (SOP)...........................

Soft Clip...........................................................

Test Pattern....................................................

Warp 4..............................................................

Warp 9..............................................................





Effect ID


ThreeTwoPulldown

ThreeTwoRemove

Balance

Blend

Blur

BrightnessContrast

BrightnessRegions

ChannelAlign

ChannelCombine|

ChannelExtract

ChannelMixer

CloneColor

NucodaCMS

NucodaCMSPath

Color

ColourSpace

DiifferentialColorCorrect

Composite

Convert

Dissolve

DvoAlias

ApertureCorrection

DvoBrickwall

DvoChroma

DvoClarity

DvoCrossColour

DvoDeinterlace

DvoDirtMap

DvoDropout

DvoDust2

DvoDustO

Deblotch

ASC3

DvoDeflicker

DvoFrame

DvoGrainO

AGR4

DvoLineSync

DvoNoise

DvoPixel

DvoRgbAlign_Seq

DvoRgbAlign

DvoRegrainRGB

DvoRegrain

DvoSuperZoom

DvoScratchTarget

DvoSharpen

DvoSharpen2

DvoVariTimeSource

DvoVariTime

DvoSteady

DvoSteady2

S3DColourAlign2

DvoThreeTwo

DvoTwister

DvoUpscale

DvoDewarp

DvoZoom

Fade

FieldDomCorrect

FieldRemove

FieldSwap

GammaMatrix

HLSColorCorrect

HueCurves

Invert

KelvinTint

Keyer

LensDistort

RGBMLevels

LiftGammaGain

LinearToLog

LogToLinear

MeshWarper

Paint

PanAndScan

PQMatrix

PrinterLights

DvoQuadBalance

DvoReflicker

Reinterlace

Retime

RGBMCurves

RGBAover

S3DColourAlign

Saturation

SlopeOffsetPower

SoftClip

DvoTestPattern

Warper_4

Warper