Clone from the Lumiera Master-Repo (as Test for Forgejo) https://git.lumiera.org/
Find a file
Ichthyostega 92bc044e9e Library: consider how to handle randomness in tests
Using random or pseudo-random numbers as input for tests
can be a very effective tool to spot unintended behaviour in
corner cases, and also helps writing more principled test verifications.
However, investigating failures in randomised tests can be challenging.

A well-proven solution is to exploit the **determinism** of pseudo-random-numbers
by documenting a randomly generated seed, that can be re-injected for investigation.

Up to now, most tests rely on the old library function `rand()`, while
at some places already the C++ standard framework for random number generation
is used, packaged into a custom wrapper. Adding adequate support for
documented seed values seems to be easy to achieve, after switching
existing usages of `rand()` to a suitable drop-in replacement.

After some consideration, I decided ''against'' wiring random generator instances
explicitly, while allowing to do so on occasion, when necessary. Thus
the planned seeding mechanism will rather re-seed a ''implicit default''
generator, which could then be used to construct explicit generator instances
when required (e.g. for multithreaded tests)

As a starting point, this changeset replaces the `randomise()` API call
by a direct access to the ''reseeding functionality'' exposed by the
C++ framework and all default generators. Since we already provide a
dedicated static instance of the plattform entropy source, re-randomisation
can be achieved by seeding from there.

NOTE: there was extended debate in the net, questioning the viability
of the `std::random_seq` -- these arguments, while valid from a theoretical
point of view, seem rather moot when placed into a practical context,
where even 2^32 different generation-paths(cycles) are more than enough
to provide sufficient diffusion of results (unless the goal is really to
engage into Monte-Carlo simulations for scientific research or large model
simulations).

Notable most of the more catchy reprovals raised by Melissa O'Neill
have been refuted by experts of the field, even while being still propagated
at various places in the net, often combined with promoting PCG-Random.
2024-11-10 03:25:45 +01:00
admin Library: integrate into the Lumiera code base 2024-03-11 17:38:30 +01:00
data Icon: variants turning the hand up/down 2022-10-14 20:26:49 +02:00
doc Invocation: capture idea for sharpened invocation structure 2024-05-12 17:27:07 +02:00
po release prep: remove defunct autotools buildsystem 2013-10-29 03:47:50 +01:00
research Library: reorder some pervasively used includes 2024-03-21 19:57:34 +01:00
src Library: consider how to handle randomness in tests 2024-11-10 03:25:45 +01:00
target update some DIR_INFO entries 2011-04-05 00:44:30 +02:00
tests Library: consider how to handle randomness in tests 2024-11-10 03:25:45 +01:00
uml DOC: update and rework documentation regarding command access 2021-04-16 18:14:33 +02:00
wiki Library: consider how to handle randomness in tests 2024-11-10 03:25:45 +01:00
.gitignore Doxygen: adjust ignores 2015-08-17 01:14:33 +02:00
AUTHORS Pre-release 0.pre.03 2015-11-02 22:19:26 +01:00
COPYING we need the usual README, INSTALL, AUTHORS, and LICENSE file 2007-09-06 18:16:45 +02:00
DIR_INFO update some DIR_INFO entries 2011-04-05 00:44:30 +02:00
INSTALL Pre-release 0.pre.02 2013-10-30 02:35:20 +01:00
LICENSE ability to pick up the attribute type from the closure/functor 2015-05-03 05:24:06 +02:00
README Pre-release 0.pre.03 2015-11-02 22:19:26 +01:00
SConstruct Global-Layer-Renaming: fix handling of GuiResources in the build 2018-11-16 18:18:33 +01:00

Lumiera -- the video NLE for Linux
====================================
Version: 0.pre.03
:Date: 11/2015

*************************************************************
Lumiera is a non-linear video editing and compositing tool.

The Application will allow to edit footage in the common
multimedia formats (quicktime, ogg, mkv, avi) and audio/video
stream codecs (dv, mpeg1/2/4, h264 ...)

Lumiera features non-destructive 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/2015, Lumiera is in early development stage;
it is not usable yet. The above describes the Lumiera project
vision, which will need years to implement. This preview Release
installs a current development snapshot in pre-alpha stage.

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


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

**This source tree doesn't yet contain a working video editing application** +
Rather, it contains the framework and technology core
of the envisioned Application ``Lumiera''.

See http://issues.lumiera.org/roadmap[Project roadmap]

As of _11/2015_ (0.pre.03)::
a lot of long standing maintennance work has been done. The Project switched
to C++11 and in the end even to C++14 and Debian/Jessie as reference platform,
followed by clean-up of now obsolete workarounds. On the GUI side, we largely
made the transition to GTK-3, which lead to rework of our timeline widget, not
finished yet. This work also spured an effort the connection and communication
between Proc and the UI, which is expected to be asynchroneous. Due to the
limited developer resources, work on the Engine and Player part is stalled.

As of _10/2013_ (0.pre.02)::
the data models have been elaborated and some significant parts of the session
are finished. Work has continued with time handling, a draft of the output
connection framework, a draft of the player subsystem and interfaces to the
engine and processing network. Unfortunately there was a considerable slowdown
and decrease in team size, yet still the code base is growing towards 90k LOC.
No tangible progress regarding the GUI and the backend.

As of _1/2011_ (0.pre.01)::
the project has created and documented a fairly consistent design,
partially coded up -- starting from the technical foundations and working up.
The code base is approaching 65k LOC. Roughly half of this is test code.
The Application can be installed and started to bring up a GTK GUI framework,
but the GUI is very preliminary and not connected to core functionality.
The video processing pipeline exists only in the blueprints.

As of _2/2008_::
the project has been separated completely from ``Cinelerra'', the parent project.
The Community, which at that time was largely identical to the Cinelerra-CV community,
choose the new project name ``Lumiera'' through a collaborative selection and vote.
The basic project infrastructure is up and running, and work on the new codebase
has started. We can show nothing beyond a test suite for some time to come.

As of _7/2007_::
we started with the backend and render engine draft, some example code
complemented by several unit tests. There is a TiddlyWiki with detailed
design considerations and developer documentation and a UML model



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

For building Lumiera, you'll need:

 * C99 / C++14 compiler GCC `>=4.9` or Clang `>=3.5`
 * Git Version management system
 * http://www.scons.org/[SCons build system]
 * http://www.boost.org/[Boost libraries]
 * http://gmerlin.sourceforge.net/[GAVL library]
 * http://nobug.pipapo.org/[NoBug library]
 * http://www.gtkmm.org/en/[GTKmm]
 * http://alsa-project.org[ALSA libasound2-dev]
 * http://cgit.freedesktop.org/xorg/lib/libXv[libXv]
 * https://wiki.gnome.org/LibRsvg[lib rSVG]
 * https://git.gnome.org/browse/gdl[lib GDL]

See the online documentation at http://Lumiera.org/download.html



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`