OMFInput

Plugin for AviSynth 2.5
Version 0.1 - December 11, 2005
by Josh Harris
latest version
source code

About

This plugin can import some types of video OMF files. It currently handles:
    1:1 Uncompressed YUY2 (CDCI)
    Mpeg2 I frame only (via libmpeg2)
    DV25 (via Cedocida DV Codec )
    Mjpeg (2:1, 15:1, etc.) (via jpegsrc6b)

But there are many OMF features not yet (and possibly never to be) implemented, such as:
    RGBA, TIFF and DV50 compressed video data.
    Audio data
    Reference Files
    Composition Mobs and most of the fancy OMF features that an AVID uses for export and effect rendering

There are still quite a few bugs and quite a few types of OMFs that it cannot open, but I have been using it in a production environment for a few weeks and it does most of what I need it to do...which is open and process OMF files captured on an AVID Adrenaline system and on an AVID Xpress Pro system. It is almost guaranteed to have problems, though, if you try to open an OMF file that was created by an effect render or by exporting a timeline sequence.

It turns out that the world of OMF is a very dark and secretive place, where even the creators of the format (AVID) rarely follow its rules and the SDK is years out of date. This has made it practically impossible to create a universal OMF reader (atleast for me). And since I only have OMF files from AVID systems and After Effects renders, I cannot guarantee any compatibility with OMFs created by other software.

Requirements:

OMFToolkit.dll must be somewhere in your system path, this is the dll made available by AVID that contains the OMF reading functions. This dll is part of the OMF developer libraries, OMF.zip which are found on the AAF Association download page.

Usage

OMFInput("FileName.omf", order = -1, levels = 0, info = 0)
OMFInput("FileName.omf")

1:1 Uncompressed, Mjpeg, and DV25 video are output as YUY2
Mpeg2 is output as YV12

Parameters:

clip - input clip
order - field order: 0 is BFF, 1 is TFF. -1 indicates that the plugin should make a guess (default = -1)
    Occasionally the filter guesses the wrong field order so you can use this to change it
    But it only works on Mjpeg and 1:1 Uncompressed files.
    You cannot change the field order of DV25 or Mpeg2 files.
levels - 0 = Off, 1= On (default = 0)
    OMF files contain info about Black and White reference Levels
    If set to 1, this filter applies a levels adjustment to expand video levels back to RGB (0-255)
       It applies levels(BlackRef, 1.0, WhiteRef, 0, 255), where BlackRef and WhiteRef are values read from the OMF file
    Not really useful at the moment, it is left over from a previous version that could output RGB video
info - 0 = Off, 1= On (default = 0)
    This is only useful if you want to see the structure of the OMF file.
    It creates a text file, called "FileName.omf_avs_Info.txt," in the same directory as the avs script file.
    It contains detailed info about the OMF file structure.

Version changes:

Plans:

License:

This program is freeware, but WITHOUT ANY WARRANTY.