Skip to content

Latest commit

 

History

History
159 lines (100 loc) · 6.35 KB

README.md

File metadata and controls

159 lines (100 loc) · 6.35 KB
Raw

Frei0r logo

frei0r frei0r

What frei0r is

The frei0r project is a collection of free and open source video effects plugins that can be used with a variety of video editing and processing software.

For an extensive introduction to frei0r please read this story.

The frei0r project welcomes contributions by people who are passionate about video effects, its collection consists of more than 100 plugins made to work on any target platform (GNU/Linux, Apple/OSX and MS/Win) without the need for special video hardware. These plugins can be used to add a wide range of effects to video, such as color correction, blurring, and distortion.

The frei0r project is a great resource for anyone interested in algorithms for video transformation and effects, as it provides a wide range of open source formulas available for free and can be easily integrated into a variety of software.

What frei0r is not

Frei0r itself is just a C/C++ header and a collection of small programs using it to accept an input frame, change it in any possible way and return an output frame.

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 GStreamer, MLT, FFmpeg and Pure Data do.

Links

Wikipedia page about frei0r: https://en.wikipedia.org/wiki/Frei0r

Some applications using frei0r, sorted in order of most recent activity

Downloads

Stable frei0r releases are built automatically and made available on

https://github.com/dyne/frei0r/releases

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

Build dependencies

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 BUILD file.

MS / Windows

We distribute official builds of frei0r plugins as .dll for the Win64 platform from the releases page.

BSD

Ports of frei0r are included in all major BSD distros:

GNU / Linux

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

Apple / OSX

A frei0r Brew formula is available.

Official builds of frei0r plugins as .dlsym for the Apple/OSX platform will be soon included in the releases page.

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. The doxyfied documentation is also available for browsing online.

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:

  #include <frei0r.hpp>
  
  typedef struct {
    int16_t w, h;
    uint8_t bpp;
    uint32_t size;
  } ScreenGeometry;
  
  class MyExample: public frei0r::filter {
  public:
    MyExample(int wdt, int hgt);
    ~MyExample();
    virtual void update();
  private:
    ScreenGeometry geo;
    void _init(int wdt, int hgt);
  }
  
  MyExample::MyExample() { /* constructor */ }
  MyExample::~MyExample() { /* destructor */ }
  
  void MyExample::_init(int wdt, int hgt) {
    geo.w = wdt;
    geo.h = hgt;
    geo.bpp = 32; // this filter works only in RGBA 32bit
    geo.size = geo.w*geo.h*(geo.bpp/8); // calculate the size in bytes
  }
  
  void MyExample::update() {
    // we get video input via buffer pointer (void*)in 
    uint32_t *src = (uint32_t*)in;
    // and we give video output via buffer pointer (void*)out
    uint32_t *dst = (uint32_t*)out;
    // this example here does just a copy of input to output
    memcpy(dst, src, geo.size);
  }
    
  frei0r::construct<MyExample>
          plugin("MyExample", "short and simple description for my example",
                 "Who did it", 1, 0);

Join us

To contribute your plugin please open a pull request.

For bug reporting please use our issue tracker.

You can get in touch with some developers over various dyne.org chat channels, for instance

https://t.me/frei0r

We also have an (old) mailing list open to subscription and we provide public archives of discussions, searchable and indexed online.

Acknowledgments

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