Frei0r plugins linux mint

Minimalistic plugin API for video effects, by the Piksel Developers Union

Frei0r is a minimalistic plugin API for video effects.

The main emphasis is on simplicity for an API that will round up the most common video effects into simple filters, sources and mixers that can be controlled by parameters.

It’s our hope that this way these simple effects can be shared between many applications, avoiding their reimplementation by different projects.

What frei0r is not

Frei0r is not meant as a competing standard to more ambitious efforts that try to satisfy the needs of many different applications and more complex effects.

It is not meant as a generic API for all kinds of video applications, as it doesn’t provides things like an extensive parameter mechanism or event handling.

Eventually the frei0r API can be wrapped by higher level APIs expanding its functionalities (for instance as GStreamer, MLT, FFmpeg and others do).

Developers are sporadically contributing and we are happy if more people like to get involved, so let us know about your creations! Code and patches are well accepted, get in touch with us on the mailinglist (see the section Communication below).

Frei0r has been around since 2004, born from yearly brainstormings held at the Piksel conference with the participation of various free and open source video software developers.

It works on all hardware platforms without the need for any particular hardware acceleration (GNU/Linux, Apple/OSX and MS/Win) and consists of more than 100 plugins. Among the free and open source video application supporting frei0r are: KDEnLive, FFmpeg, MLT, PureData, Open Movie Editor, DVEdit, Gephex, LiVES, FreeJ, VeeJay, Flowblade, and Shotcut among the others.

Stable frei0r releases are packaged periodically and distributed on

Frei0r sourcecode is released under the terms of the GNU General Public License and, eventually other compatible Free Software licenses.

The latest source for frei0r plugins can be attained using git on https://github.com/dyne/frei0r

Make sure to get in touch with our mailinglist if you like to contribute.

Frei0r can be built on GNU/Linux, M$/Windows and Apple/OSX platforms, possibly in even more environments like embedded devices.

For details see the INSTALL file.

Binary packages are mantained on various distributions, but they may not be completely up to date with latest release.

MacPorts provides packages for OSX: [MacPorts]: http://www.macports.org $ sudo port install frei0r-plugins

Pre-compiled binaries are also uploaded on our website.

We encourage Apple/OSX application distributors to compile the plugins directly and to include frei0r within their bundle.

Pre-compiled binaries are often provided by third-parties, but they may not to be up to date.

We encourage MS/Win application distributors to compile the plugins directly and to include frei0r within their bundle.

If you are new to frei0r (but not to programming) the best thing is probably to have a look at the frei0r header, which is quite simple and well documented. The doxyfied documentation is also available for browsing on-line.

C++ Filter example

You could find a tutorial filter here in the source code. A simple skeleton for a frei0r video filter looks like this:

MyExample(); virtual void update(); private: ScreenGeometry geo; void _init(int wdt, int hgt); > MyExample::MyExample() < /* constructor */ >MyExample::

You can get in touch with our developer community, send your new effects and share your intentions with us.

We have a free mailinglist open to subscription and we provide public archives of the discussions there that are also searchable and indexed online.

For bug reporting the mailinglist is preferred, but is also possible to use an issue tracker.

Frei0r is the result of a collective effort in coordination with several software developers meeting to find a common standard for video effect plugins to be used among their applications.

For a full list of contributors and the project history, see the file AUTHORS, the ChangeLog and the project web page: https://frei0r.dyne.org

About

A large collection of free and portable video plugins

Источник

Frei0r :: Free Video Effect Plugins

Frei0r is a minimalistic plugin API for video effects. The main emphasis is on simplicity for an API that will round up the most common video effects into simple filters, sources and mixers that can be controlled by parameters. It’s our hope that this way these simple effects can be shared between many applications, avoiding their reimplementation by different projects.

Video effects for whom?

Frei0r is not meant as a competing standard to more ambitious efforts that try to satisfy the needs of many different applications and more complex effects. It is not meant as a generic API for all kinds of video applications, as it doesn’t provides things like an extensive parameter mechanism or event handling. Eventually the frei0r API can be wrapped by higher level APIs expanding its functionalities (for instance as GStreamer, MLT, FFmpeg and others do).

Frei0r has been developed with production video software in mind, not video players or desktop toys of sorts. For instance it can be used like GStreamer, but its different as it aims to be lighter, for instance allowing host application developers to avoid memcpy and other buffering operations. Also it doesn’t enforces dependency from GNOME and such desktop frameworks.

Current Status

Frei0r is mostly adopted on GNU/Linux and OSX platforms, counts more than 100 plugins and is used by several video software applications: FFMpeg, PureData, Open Movie Editor, DVEdit, Gephex, LiVES, FreeJ, VeeJay, MLT, KDEnLive, Shotcut and flowblade. Find our more on the Wikipedia page about Frei0r, where also contributions are welcome to complete our documentation.

For a quick glance of what is this project status, you can visit the Frei0r page on Ohloh and on Freecode. A more detailed overview on code activity is provided on code.dyne.org/frei0r.

We are happy if more people like to get involved, so let us know about your creations! Code and patches are well accepted, get in touch with us on the frei0r mailinglist.

History

Frei0r has been around since 2006, born from yearly brainstorms held at the Piksel conference with the participation of various free and open source video software developers. However, these meetings are not held anymore at Piksel and nowadays most of the discussion between developers is held online on the Frei0r mailinglist.

Downloads

Source code

Frei0r sourcecode is released under the terms of the GNU General Public License and, eventually other compatible Free Software licenses. The latest source for frei0r plugins can be attained using git at: githhub.com/dyne/frei0r

Auxiliary libraries

Optionally, frei0r can be built linking the following libraries:

Gavl – required for the scale0tilt and vectorscope filters
OpenCV – required for face detection filters
Cairo – required for some fine color blending mixers

GNU/Linux/BSD

Frei0r is packaged for all major GNU/Linux distributions, but it may be out-of-date.

Apple / OSX

MacPorts provides ready to install packages for OSX: in case you have this packaging system installed you just need to open a terminal and give the following command:

Also Brew and Fink have packages.

Miscro$oft / Windoz

Zeranoe kindly provides some solid builds of FFMpeg which also include a recent version of the Frei0r plugin collection.

Documentation

If you are new to frei0r (but not to programming) the best thing is probably to have a look at the frei0r header, which is quite simple and well documented. While the main source of documentation for the Frei0r API is the header, the sourcecode is well commented so you can study its full doxyfied documentationonline.

C++ filter example

A simple skeleton for a frei0r video filter looks like this:

MyExample(); virtual void update(); private: ScreenGeometry geo; void _init(int wdt, int hgt); > MyExample::MyExample() < /* constructor */ >MyExample::

Communication

You can get in touch with our developer community, send your new effects and share your intentions with us. We have a free mailinglist open to subscriptions. This mailinglist is new, since the old mailinglist maintainer went bonkers. However, we are currently migrating the infrastructure and the archive link will be updated soon. If you have a contribution and like using GitHub, you can also file a pull request on the Frei0r repository by ddennedy, still good to notice us on the mailinglist about it.

Acknowledgments

Frei0r is the result of a collective effort in coordination with several software developers meeting at Piksel between 2003 and 2005 to find a common standard for video effect plugins to be used among their applications: Andraz Tori (Cinelerra/CVS), Daniel Fischer (Pakt/GStreamet), Denis Jaromil Rojo (FreeJ/Dyne), Gabriel “Salsaman” Finch (LiVES), Kentaro Fukuchi (EffecTV), Niels Elburg (VeeJay), Øyvind Kolås (Gegl/Babl/Gimp), Tom Schouten (PDP/PureData), Georg Seidel, Martin Bayer and Phillip Promesberger (Gephex). We first aimed at the realisation of a comprehensive specification for dynamically loaded plugins named LiViDO, which then spawned two implementations: one being Frei0r, a minimalistic implementation contributed by the Gephex team and the other one being the WEED implementation by LiVES developer Salsaman, sporting more features for GUI integration and scriptability. Within the span of a few years, the minimalistic approach of frei0r has been widely adopted among more applications and became a de-facto standard. Maintenance and further refinements were contributed by Carlo Prelz (MøB/BEK), Richard Spindler (Open Movie Editor) and Dan Dennedy (MLT/KDEnLive), while Debian/Ubuntu packaging and build system standardization were taken care of by dyne.org developers Filippo Giunchedi and Luca Bigliardi. For a complete list of contributors, please refer to the AUTHORS file.