Skip to content

Latest commit

 

History

History
72 lines (53 loc) · 4.32 KB

readme.md

File metadata and controls

72 lines (53 loc) · 4.32 KB

OpenFX image processing plug-in standard

The authoritative source for information about OFX is http://openeffects.org/

Why a Standard?

VFX plug-in vendors were frustrated for years because host application vendors created proprietary plug-in interfaces. As a result, each plug-in vendor had to port their plug-ins to all the different hosts and hosts couldn't use each other's plug-ins, limiting the selection of effects available to artists. The need for a standard interface was clear, so Bruno Nicoletti of The Foundry led the effort to develop a standard. That standard is OFX.

OFX is a win for artists because there is no waiting for plug-in vendors to port their cool effects to your application. Once a host compositing or editing application adopts OFX, all OFX plug-ins on the market instantly become available on that host.

And OFX is a win for plug-in vendors because they can concentrate on what they do best: making cool effects

OFX Terminology

Host

A video compositing or editing application, such as The Foundry Nuke, Assimilate Scratch, Sony Vegas, or FilmLight Baselight

Plug-in

Video software, such as GenArts Sapphire or RE:Vison Effects which adds a wider variety of effects to a host application.

Open Effects

A standardized software interface between VFX host applications and plug-ins (also known as OpenFX and OFX).

Editor

An application which allows you to manipulate a video timeline by adding, removing, and changing the in and out points of video clips. Effects, Generators, Transition, Compositors and Retiming effects are commonly used in editors.

Compositor

An application which allows you build a video clip by layering video clips, still images, and effects.

Contributing

Please read the Contribution Guidelines for how to submit pull requests for fixes and changes to the standard.

About the Open Effects Association

The Open Effects Association (OFX), a non-profit organization, develops and promotes open standards across the visual effects community. The founding members come from Assimilate, Autodesk, Digieffects, FilmLight, The Foundry, GenArts and RE:Vision FX. These are companies which have helped artists create ground-breaking VFX shots on nearly every blockbuster movie.

The Association's initial focus is to improve the OpenFX image processing plug-in standard. This goal of this standard is to reduce development effort and support needed for plug-ins across different compositing and editing host platforms.

Building Docs

Buildthedocs.io will auto-build whenever changes are pushed to master. But to build the docs yourself, e.g. to check that your updates look right, you can do your own doc build.

Right now building the docs is somewhat manual. The below assumes Linux, but Mac is similar.

Prerequisites

  • Install doxygen (Linux: sudo apt install doxygen)
  • Create a python3 virtualenv: python -mvenv ofx-docgen
  • Activate it: source ofx-docgen/bin/activate
  • Install the python requirements in that virtualenv: pip install -r Documentation/pipreq.txt

(Virtualenv is recommended, but not required; you could install the reqs into your system python if you like.)

Build:

  • Make sure your virtualenv above is activated: source ofx-docgen/bin/activate
  • Generate references: python Documentation/genPropertiesReference.py -i include -o Documentation/sources/Reference/ofxPropertiesReference.rst -r
  • Build the doxygen docs: cd include; doxygen ofx.doxy; cd - (you'll see some warnings)
  • Build the sphinx docs: cd Documentation; sphinx-build -b html sources build
  • Now open file:///path/to/your/ofx/openfx/Documentation/build/index.html in your browser; your changes should be there.