Hacking

Installation

There are three main ways to hack with libobscura.

• write applications using it,
• add support for a new camera, and
• contribute to the internals.

Either way, you'll need to compile it, and for that, Rust is used. On Fedora:

sudo dnf -y install rust

Test application

When modifying libcamera, it's best to start with a working test application.

At the moment, this is the "glium_2.rs" example.

Check out the code and build it:

git clone https://codeberg.org/libobscura/libobscura.git
cargo run --example glium_2

Contribute to internals

The internals are documented throughout the code base, so refer to every file in the sources. Please report a bug if anything that's missing holds your understanding.

There's an old design document in libvidi describing the general goals of the architecture. It's a little outdated and stream-of-thought-like, but maybe it helps you understand the motivations.