Crate libde265_rs 

libde265-rs

Safe wrapper around the libde265-sys2 crate to decode H625 streams.

CHANGELOG

System dependencies

• libde265-dev >= 1.0

Linux

Crate libde265-sys2 uses pkg-confing command to find installed libde265.

You can also enable embedded-libde265 feature to compile libde265 from embedded into libde265-sys2 crate sources and then link it statically.

Windows

Crate libde265-sys2 uses vcpkg crate to find libde265 installed with help of vcpkg.

You can use cargo-vcpkg to install libde265 with help of cargo command:

cargo vcpkg -v build

cargo-vcpkg can fetch and build a vcpkg installation of required packages from scratch. It merges package requirements specified in the Cargo.toml of crates in the dependency tree.

Examples

Decode H265 stream

use std::fs::File;
use std::io::Read;

use libde265_rs::*;

#[test]
fn decode_h265() {
    let (mut input, mut output) = new_decoder().unwrap();

    let mut images_count = 0;
    let mut file = File::open("./data/girlshy.h265").unwrap();
    let mut buf = vec![0; 1024];
    loop {
        match input.decode() {
            Ok(DecodeResult::Done) => break,
            Ok(DecodeResult::CallAgain) | Err(DeError::ErrorImageBufferFull) => {
                while let Some(image) = output.next_picture() {
                    images_count += 1;
                    assert_eq!(image.width(Channel::Y), 316);
                    assert_eq!(image.height(Channel::Y), 240);
                    assert_eq!(image.chroma_format(), ChromaFormat::C420);
                    assert!(!image.full_range());
                    assert_eq!(image.bits_per_pixel(Channel::Y), 8);

                    let (plane_buf, stride) = image.plane(Channel::Y);
                    assert_eq!(stride, 320);
                    assert_eq!(plane_buf.len(), 320 * 240);
                }
            }
            Err(DeError::ErrorWaitingForInputData) => {
                match file.read(&mut buf).unwrap() {
                    0 => input.flush_data().unwrap(), // EOF
                    size => input.push_data(&buf[0..size], 0, 0).unwrap(),
                }
            }
            Err(err) => panic!("{:?}", err),
        }
    }

    assert_eq!(images_count, 75);
}

Structs

DecoderInput

Instance of this type is used to push input data for the decoder.

DecoderOutput

Instance of this type is used to receive decoded pictures.

Image

NalHeader

Enums

Acceleration

Sorted such that a large ID includes all optimizations from lower IDs

Channel

ChromaFormat

DeError

DecodeResult

ParamBool

ParamI32

Functions

disable_logging

get_error_text

new_decoder

Create a new decoder.

set_verbosity

version

Returns a version of a libde265 library as an array of version parts - [major, minor, maintenance].

Type Aliases

Result