Haiku Media Editor
Copyright Zen Yes Pty Ltd 2019-2021
Released under Open Source MIT license.
Written by Zenja Solaja
Medo is a modern Media Editor built exclusively for the open source Haiku OS (aka the Media OS). Medo allows customisation using OpenGL based GLSL plugins, and allows 3rd party developers to create dynamically loaded Addons and Plugins.
There are many bundled media effects, including:
- Colour grading effects (Saturation/Exposure/Temperature etc)
- Colour correction curves and white balance.
- Support for Adobe LUT (Look Up Tables)
- Create masks and keyframes
- Several bundled transitions
- Several special effects (Blur, Night Vision, Chroma Key etc)
- Spatial tools to transform media (scale/rotate/position/crop)
- Multiple text effects, including 3D extruded fonts.
- Audio effects (20 band equaliser, fade)
Medo can edit UHD 4K videos, export to any Haiku supported codec, is optimised for many CPU-core systems, and has low system resource requirements. Medo is multilingual (currently supports 10 user languages), and is themable. The Medo.HPKG (Haiku package file) can fit on a floppy disk with no external dependancies other than what ships with a default Haiku release (it's less than 1.44Mb).
- Haiku development environment, 64 bit only (c++17 minimum standard)
- QtCreator as the IDE for code navigation and code completion
- ffmpeg development package
- cmake (optional)
- Clean all object files, remove temporary build directories
- Build the source (either with jam or cmake)
a) jam build (default primary build method), debug build (-g -O0)
jam -j16 (option -j16 is parallel build, replace 16 with number of CPU cores, eg. -j8)
b) cmake + make (optional secondary build method), debug build (-g -O0)
make -j16 (option -j16 is parallel build, replace 16 with number of CPU cores, eg. -j8)
- Setup attributes, file icon
- Build HPKG (release), which will build an installer package, (no debug code, -03)
The Medo.hpkg file will be created in the Package directory.
Source code layout
3rdparty/ - external 3rd party code
Actor/ - Actor programming model framework
AddOns/ - dynamically loaded add-ons. Each add-on must be compiled separately.
Docs/ - developer documentation
Editor/ - the core application
Effects/ - bundled effects
Gui/ - custom GUI widgets
Plugins/ - dynamically loaded GLSL plugins.
rapidjson/ - embedded library
Resources/ - application icons etc
Yarra/ - OpenGL based rendering library
The BeAPI is based on C++ pre-ISO/IEC 14882:1998 standard (published in 1998, ie. pre Standard Template Library). The API uses the Actor programming model (it's interesting that nowhere in the BeBook do they mention the term Actor, so it's quite likely that they independantly implemented the Actor model). Each BWindow object runs in its own thread with a dedicated message queue. Medo also incorporates a proper Actor library for parallel processing (eg. thumbnail generation, OpenGL rendering, audio buffer creation, exporting etc).
Medo is a 64 bit application, compiled with C++20 gcc compile flag (c++2a). Medo uses OpenGL 3.3 Core profile, with GLSL 330 for video effects rendering. An OpenGL wrapper called Yarra is used to abstract the raw OpenGL calls.
Users can implement custom GLSL shader effects by creating their own plugins. Effects from websites like ShaderToy can easily be converted to work with Medo (please use the developer guide in the Docs/ directory for more information). Please look at the Plugins/ directory for some simple examples.
Medo also supports external binary addons, which allows 3rd party developers to add complex audio and video effects. Please use the developer guide (Docs/ directory) and see the examples in the AddOns directory.
Media decoding uses the native Haiku MediaKit. As of Dec 2020, the MediaKit encoders still have stability issues, therefore, Medo also provides an ffmpeg Encoder based code path (which is the default encoder).