Miscellaneous OFX / OpenFX / Open Effects plugins.
These plugins were primarily developped for Natron, but may be used with other OpenFX hosts.
More information about OpenFX Hosts, OpenFX Plugins (commercial or free), and OpenFX documentation can be found at http://devernay.free.fr/hacks/openfx/.
Below is a short description of each plugin. The title of each section is the plugin grouping (the OpenFX host may classify plugins by grouping).
- ConstantOFX: Generator for an image with a uniform color
-
RotoOFX: Create masks and shapes. Requires a host with mask editing capabilities (such as Natron).
-
NoiseOFX: Generate noise
- TimeOffsetOFX: Move the input clip forward or backward in time.
- ShuffleOFX: Rearrange channels from one or two inputs, and convert to a different bit depth (on hosts that support it)
-
ColorCorrectOFX: Adjusts the saturation, constrast, gamma, gain and offset of an image.
-
GradeOFX: Modify the tonal spread of an image from the white and black points.
-
InvertOFX: Inverse the selected channels
-
RGBLutOFX: Apply a parametric lookup curve to each channel
separately.
-
ChromaKeyerOFX: Apply chroma keying, as described in "Video Demystified" by Keith Jack.
-
DifferenceOFX: Produce a rough matte from the difference of two images.
-
MergeOFX: Pixel-by-pixel merge operation between the two inputs.
-
PreMultOFX/UnpremultOFX: Multiply/divide the selected channels by alpha (or another channel)
-
SwitchOFX: Lets you switch between any number of inputs.
-
TransformOFX and TransformMaskedOFX: Translate / Rotate / Scale a 2D image.
-
CornerPinOFX and CornerPinMaskedOFX: Fit an image to another in translation, rotation, scale, and shear
-
CropOFX: Remove everything outside from the image of a rectangle.
-
TrackerPM: Point tracker based on pattern matching using an exhaustive search within an image region.
These plugin use the Sony Vegas multiview extension (they don't work with Nuke).
-
JoinViewsOFX: JoinView inputs to make a stereo output.
-
OneViewOFX: Takes one view from the input.
-
Stereo/AnaglyphOFX: Make an anaglyph image out of the two views of the input.
-
Stereo/MixViewsOFX: Mix two views together.
-
Stereo/ReConvergeOFX: Shift convergence so that a tracked point appears at screen-depth.
-
Stereo/SideBySideOFX: Put the left and right view of the input next to each other.
- NoOpOFX: Copies the input to the ouput. Useful for inspecting the properties of input and output clips.
If you use the Roto plugin in any other host than Natron, you will notice that it doesn't do much. It's role is just to provide an entry point for a host-based rotoscoping tool, which provides a roto mask to this plugin.
The plugins using parametric parameters (RGBLut, ColorCorrect) don't work in Nuke 8 on OS X, and maybe on other platforms. The plugins cannot be instanciated, nothing seems to happen, and the following message appears on the console:
Exception thrown
basic_string::_S_construct NULL not valid
The same happens with other plugins using parametric parameters, such as TuttleHistogramKeyer.
Parametric parameters seem to work in older versions of Nuke (at least up to Nuke 6).
These plugins are distributed precompiled with each version of Natron.
If you want to compile the plugins from source, you may either use the provided Unix Makefile, the Xcode project, or the Visual Studio project.
To fetch the latest sources from github, execute the following commands:
git clone https://github.com/devernay/openfx-misc.git
cd openfx-misc
git submodule update -i -r
In order to get a specific tag, corresponding to a source release, do git tag -l
to get the list of tags, and then git checkout tags/<tag_name>
to checkout a given tag.
To compile an optimized version for a 64-bits machine: open a shell in the toplevel directory, and type
make DEBUGFLAG=-O3 BITS=64
Without the DEBUGFLAG flag, a debug version will be compiled, and use BITS=32 to compile a 32-bits version.
The compiled plugins will be placed in subdiecories named after the
configuration, for example Linux-64-realease for a 64-bits Linux
compilation. In each of these directories, you will find a *.bundle
file, which has to be moved to the proper place (/usr/OFX/Plugins
on
Linus, or /Library/OFX/Plugins
on OS X), using a command like:
sudo mv //*.bundle /usr/OFX/Plugins
The plugins may be compiled by compiling the Xcode project called
Misc.xcodeproj
in the toplevel directory. The bundles produced by
this project have to be moved to /Library/OFX/Plugins
.
Alternatively, you can compile from the command-line using:
xcodebuild -project Misc.xcodeproj -configuration Release install
sudo mkdir /Library/OFX/Plugins
sudo mv /tmp/Misc.dst/Library/OFX/Plugins/Misc /Library/OFX/Plugins
Compile using the provided Misc.vcxproj
project found in the Misc
directory.
32-bits plugins should be installed in the directory c:\Program Files (x86)\Common Files\OFX\Plugin
, 64-bits plugins should be installed in
c:\Program Files\Common Files\OFX\Plugins
.
The stereoscopic plugins Anaglyph, JoinViews, MixViews, OneView, ReConverge, SideBySide are by Frederic Devernay.
RGBLut, Switch, TimeOffset, ChromaKeyer, Difference, Constant, Shuffle are by Frederic Devernay.
Merge, ColorCorrect, Grade, Roto, Crop, CopyRectangle are by Alexandre Gauthier.
Transform and CornerPin are by Frederic Devernay and Alexandre Gauthier.