avif-rs 26.6.0

Encode AVIF images with SVT-AV1 and decode with dav1d, via statically-linked libavif.
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

//! Small helpers shared by the encoder and decoder for talking to libavif's C API.

use std::ffi::CStr;

use crate::sys;

/// Turn a non-OK [`avifResult`](sys::avifResult) into its human-readable message via
/// `avifResultToString`. Returns the empty string for `AVIF_RESULT_OK`.
pub(crate) fn result_message(result: sys::avifResult) -> String {
    // SAFETY: `avifResultToString` always returns a pointer to a static, NUL-terminated
    // C string for any input (including unknown codes).
    unsafe {
        let ptr = sys::avifResultToString(result);
        if ptr.is_null() {
            String::new()
        } else {
            CStr::from_ptr(ptr).to_string_lossy().into_owned()
        }
    }
}

/// `true` when the result is `AVIF_RESULT_OK`.
pub(crate) fn is_ok(result: sys::avifResult) -> bool {
    result == sys::avifResult_AVIF_RESULT_OK
}