Official Documentation published on Lumiera website
Find a file
Ichthyostega 0760525ea5 Library: deep dive into type reconciliation and tuple handling
This commit is the aggregated result of extended research
that is only loosely related to current development topics.

One theme was the construction of nested data structures using tuples,
which faces some difficulties due to tuple manipulations being limited
almost entirely to compile-time processing. However, the barrier between
compile-time and runtime can be overcome with the help of a dispatcher
table -- which leads to the secondary problem to handle the diverse
tuple elements with a common, generic functor. Such a functor can be
constructed, if and only if those element types are ''reconcilable''

The STDLIB provides two metafunctions, `std::common_type` and
`std::common_refernce`, which however pose some challenges for the
task at hand, since they include additional processing. In the end,
a custom version of the ''basic type reconciliation'' was implemented
and tested, and then used as foundation to build a dispatcher table
for runtime-indexed access and iteration over tuples.

As an aside, several deeply hidden bugs in our library code were resolved,
and the tuple-helpers, tuple string rendering and associated utilities
were regrouped and modernised.

As result of this research work, the following components are provided:
- meta/common-result
- meta/fun-trampoline
- meta/tuple-index-adaptor
2026-04-07 06:32:23 +02:00
admin Merge branch 'rel/0.pre.04' into integration 2025-12-03 14:44:55 +01:00
data Merge branch 'rel/0.pre.04' into integration 2025-12-03 14:44:55 +01:00
doc BufferProvider: document the adapted structure in UML 2026-03-14 20:44:27 +01:00
po release prep: remove defunct autotools buildsystem 2013-10-29 03:47:50 +01:00
research Library: deep dive into type reconciliation and tuple handling 2026-04-07 06:32:23 +02:00
src Library: deep dive into type reconciliation and tuple handling 2026-04-07 06:32:23 +02:00
target update some DIR_INFO entries 2011-04-05 00:44:30 +02:00
tests Library: deep dive into type reconciliation and tuple handling 2026-04-07 06:32:23 +02:00
uml BufferProvider: document the adapted structure in UML 2026-03-14 20:44:27 +01:00
wiki Library: deep dive into type reconciliation and tuple handling 2026-04-07 06:32:23 +02:00
.gitignore Doxygen: adjust ignores 2015-08-17 01:14:33 +02:00
AUTHORS Release: compile authorship information 2025-11-24 00:52:47 +01:00
COPYING Release: check and update licensing information 2025-11-26 00:57:25 +01:00
DIR_INFO update some DIR_INFO entries 2011-04-05 00:44:30 +02:00
LICENSE Release: compile authorship information 2025-11-24 00:52:47 +01:00
NEWS Status: Release published -- now again in Development Phase 2025-12-11 05:11:55 +01:00
README DOC: normalise towards a single form of gitweb-URL 2026-02-15 23:02:52 +01:00
SConstruct Build: some further code clean-up and documentation 2025-11-27 18:21:22 +01:00

Lumiera -- the video NLE for Linux
==================================
Version: 0.pre.05~dev
:Date: 11/2025

*************************************************************
Lumiera is a non-linear video editing and compositing tool.
The Application will allow to edit footage using common
multimedia formats and audio/video stream codecs.

Lumiera features nondestructive editing, compositing tools,
a selection of effects plugins, processing in RGB, YUV and
RGB-float colour models and the ability to mix media with
differing sizes and framerates. Lumiera is especially well
suited for large and elaborate professional editing tasks
with lots of material, several scenes, nested sequences,
colour grading, 3D support, full fledged sound montage
and multiple edit versions prepared in parallel.

NOTE: as of 11/2025, Lumiera is in early development stage;
it is not usable yet. The above describes the Lumiera project
vision, the implementation of which will require many more years.

Visit https://Lumiera.org and join the mailing list
when interested in Lumiera planning and development.
****************************************************************


Lumiera pre-Alpha Versions
--------------------------

.This source tree doesn't contain a working video editing application yet.
Rather, it contains the framework and technology core of the envisioned
Application »Lumiera«. What we attempt to build here is innovative,
and we must engage in a series of integration steps to search for
suitable pathways towards our envisaged architecture.

Since 2024, the integration of the Render Engine takes centre stage,
in an effort to establish a steady state realtime processing and
display pipeline, still relying on generated video data rather
than using a library to read and playback a video file.

- https://Lumiera.org/documentation/design/governance/integration.html[Integration steps]
- See also https://issues.lumiera.org/roadmap[Project roadmap]




Build Requirements
------------------

For building Lumiera, you'll need:

 * C++23 compiler GCC >=14 (Clang fails atm)
 * Git Version management system
 * https://www.scons.org/[SCons build system]
 * https://www.boost.org/[Boost libraries]
 * https://github.com/bplaum/gavl[GAVL library]
 * https://www.alsa-project.org/[ALSA (libasound2-dev)]
 * https://nobug.pipapo.org/[NoBug library]
 * https://gtkmm.gnome.org/en/[gtkmm]
 * https://cgit.freedesktop.org/xorg/lib/libXv[libXv]
 * https://wiki.gnome.org/Projects/LibRsvg[lib rSVG]
 * https://git.lumiera.org/gitweb?p=debian/gdl;a=summary[lib GDL]
 * https://git.lumiera.org/gitweb?p=debian/gdlmm;a=summary[GDL-mm bindings]

Further information:

 * Online documentation at https://Lumiera.org/download.html[Build and install].
 * Documentation is also available in-tree in 'doc/user/tutorials/building.txt'
 * Source code can be retrieved with `git clone git://git.lumiera.org/LUMIERA`



Debian Package
--------------
Hermann Vosseler (aka Ichthyo) maintains a *Debian* packaging of the source tree

- the package definition can be pulled from `git://git.lumiera.org/debian/lumiera/`
- the package can be built by `git-buildpackage`