LibBayer

About

LibBayer provides routines for demosaicing Bayer (raw) images.

The library supports 8-bit and 16-bit images.

Several demosaicing algorithms are available. See the src/demosaic directory for a list and their individual descriptions. Pixels on the border of the image are retained by replicating or mirroring the data in the neighbourhood.

LibBayer is written entirely in Rust. C bindings to the underlying algorithms are provided.

Examples

An example program is provided in the examples/ directory:

• showbayer - a simple Bayer file viewer.
• writebayer - converts an image to a raw Bayer image file.

To clone this repository, run:

git clone https://github.com/wangds/libbayer.git

Then build the library and run the example programs using Cargo.

cargo build --release --example showbayer

To display a Bayer file, run:

cargo run --release --example showbayer <width> <height> <depth> <example.raw>

Change the colour filter array (CFA) pattern and the demosaicing algorithm from inside the example program.

Basic Usage

Add LibBayer as a dependency to your project's Cargo.toml:

[dependencies]
bayer = "0.1"

Import the library in your project, e.g.:

extern crate bayer;

Open a Bayer file from disk.

let mut file = File::open(Path::new("example.raw")).unwrap();

This raw data contains the red, green, or blue values at each pixel only. There is no additional header data, so the image width and height, pixel depth, and CFA pattern must be provided from elsewhere.

Allocate the buffer to which we will decode the image.

let img_w = 320;
let img_h = 200;
let depth = bayer::RasterDepth::Depth8;
let bytes_per_pixel = 3;
let mut buf = vec![0; bytes_per_pixel * img_w * img_h];
let mut dst = bayer::RasterMut::new(img_w, img_h, depth, &mut buf);

Then run the demosaicing process:

let cfa = bayer::CFA::RGGB;
let alg = bayer::Demosaic::Linear;
bayer::run_demosaic(&mut file, bayer::BayerDepth:Depth8, cfa, alg, &mut dst);

Note that many cameras will capture 12-bits per pixel (channel), but store the data as 16-bits per pixel. These should be treated as 16-bits per pixel for the purposes of this library.

Documentation

• Documentation.

Author

David Wang