edanweis / frei0r Goto Github PK
View Code? Open in Web Editor NEWThis project forked from balint256/frei0r
My plugins for frei0r
License: GNU General Public License v2.0
This project forked from balint256/frei0r
My plugins for frei0r
License: GNU General Public License v2.0
___________ ._________ \_ _____/______ ____ |__\ _ \_______ | __) \_ __ \_/ __ \| / /_\ \_ __ \ | \ | | \/\ ___/| \ \_/ \ | \/ \___ / |__| \___ >__|\_____ /__| \/ \/ \/ Minimalistic plugin API for video effects v1.4 by the Piksel Developers Union Updated info on http://frei0r.dyne.org Introduction ~~~~~~~~~~~~~ What frei0r is =============== 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). Current status =============== 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). History ======== 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 and Flowblade among the others. Wikipedia page about frei0r: http://en.wikipedia.org/wiki/Frei0r [Piksel]: http://www.piksel.no [PureData]: http://www.artefacte.org/pd/ [Open Movie Editor]: http://openmovieeditor.sourceforge.net/ [DVEdit]: http://www.freenet.org.nz/dvedit [Gephex]: http://www.gephex.org/ [LiVES]: http://lives.sf.net [FreeJ]: http://freej.dyne.org [MøB]: http://mob.bek.no/ [VeeJay]: http://veejayhq.net [MLT]: http://www.mltframework.org/ [KDEnLive]: http://www.kdenlive.org/ [Flowblade]: http://code.google.com/p/flowblade/ Download ~~~~~~~~~ Source code ============ Stable frei0r releases are packaged periodically and distributed on http://files.dyne.org/frei0r We encourage the unauthorized mirroring of this source repository by all those interested, using the command rsync -Pr rsync.dyne.org::frei0r . 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 our revisioning system *GIT* git clone git://code.dyne.org/frei0r.git Some clones made by developers are also found on github, but basically we coalesce around this repository online to pack releases. Make sure to get in touch with our mailinglist if you like to see your code in there (see the section Communication below). 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 INSTALL file, short and to the point. GNU / Linux ============ Binary packages are mantained on various distributions. For an overview see http://oswatershed.org/pkg/frei0r-plugins Apple / OSX ============ 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. Microsoft / Windows ==================== Pre-compiled binaries are uploaded on our website. We encourage MS/Win application distributors to compile the plugins directly and to include frei0r within their bundle. 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, or the doxygen code documentation in doc/ API explanation ================ 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 documentation] online. [doxyfied documentation]: http://frei0r.dyne.org/codedoc/html C++ Filter example =================== 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); 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 [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]. [subscribe]: http://mailinglists.dyne.org/cgi-bin/mailman/listinfo/frei0r [public archives]: http://lists.dyne.org/lurker/list/frei0r.en.html [issue tracker]: http://bugs.dyne.org 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 http://frei0r.dyne.org
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.