playa-ffmpeg 8.0.3

Safe FFmpeg wrapper with vcpkg integration for simplified cross-platform builds (FFmpeg 8.0, Rust 2024)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! Core utilities and data structures.
//!
//! This module provides fundamental types and utilities used throughout the library.
//! It wraps FFmpeg's `libavutil` library.
//!
//! # Main Components
//!
//! - [`frame`] - Raw audio/video frames (decoded data)
//! - [`error`] - Error types and error handling
//! - [`dictionary`] - Key-value metadata and options
//! - [`rational`] - Rational number representation for timestamps/framerates
//! - [`channel_layout`] - Audio channel layouts (stereo, 5.1, etc.)
//! - [`color`] - Color space and color primaries
//! - [`mod@format`] - Pixel and sample formats
//! - [`mathematics`] - Mathematical utilities (rescaling, rounding)
//! - [`time`] - Time representation and conversion
//! - [`mod@log`] - Logging configuration and levels

#[macro_use]
pub mod dictionary;
pub mod chroma;
pub mod color;
pub mod error;
pub mod format;
pub mod frame;
pub mod interrupt;
pub mod log;
pub mod mathematics;
pub mod media;
pub mod option;
pub mod picture;
pub mod range;
pub mod rational;
pub mod time;

#[cfg_attr(feature = "ffmpeg_7_0", path = "channel_layout.rs")]
#[cfg_attr(not(feature = "ffmpeg_7_0"), path = "legacy_channel_layout.rs")]
pub mod channel_layout;

use std::{ffi::CStr, str::from_utf8_unchecked};

use crate::ffi::*;

/// Returns the libavutil version number.
///
/// The version is encoded as `(major << 16) | (minor << 8) | micro`.
#[inline(always)]
pub fn version() -> u32 {
    unsafe { avutil_version() }
}

/// Returns the libavutil build configuration string.
///
/// Shows compile-time options used when building FFmpeg's utility library.
#[inline(always)]
pub fn configuration() -> &'static str {
    unsafe { from_utf8_unchecked(CStr::from_ptr(avutil_configuration()).to_bytes()) }
}

/// Returns the libavutil license string.
///
/// Typically "LGPL version 2.1 or later" unless built with GPL components.
#[inline(always)]
pub fn license() -> &'static str {
    unsafe { from_utf8_unchecked(CStr::from_ptr(avutil_license()).to_bytes()) }
}