video-toolbox-sys

FFI bindings and helpers for Apple VideoToolbox framework.

VideoToolbox is a low-level framework that provides direct access to hardware encoders and decoders on macOS and iOS. It provides services for video compression and decompression, and for conversion between raster image formats stored in CoreVideo pixel buffers.

Features

• Raw FFI bindings to VideoToolbox APIs
• Codec FourCC constants (H.264, HEVC, AAC, etc.)
• Error code to string conversion
• Optional high-level helpers (with helpers feature)

Installation

Add to your Cargo.toml:

[dependencies]
video-toolbox-sys = "0.2"

# Optional: Enable high-level helpers
video-toolbox-sys = { version = "0.2", features = ["helpers"] }

Usage

Basic FFI Usage

use video_toolbox_sys::codecs;
use video_toolbox_sys::compression::*;
use video_toolbox_sys::errors::vt_error_to_string;

// Use codec constants
let codec = codecs::video::H264;
let pixel_format = codecs::pixel::BGRA32;

With Helpers Feature

use video_toolbox_sys::helpers::CompressionSessionBuilder;
use video_toolbox_sys::codecs;

let session = CompressionSessionBuilder::new(1920, 1080, codecs::video::H264)
    .hardware_accelerated(true)
    .bitrate(8_000_000)
    .frame_rate(30.0)
    .build(|_, _, status, _, sample_buffer| {
        if status == 0 && !sample_buffer.is_null() {
            // Handle encoded frame
        }
    })
    .expect("Failed to create compression session");

Examples

See the examples/ directory for complete working examples:

• encode_dummy_image.rs - Encode synthetic frames to H.264
• camera_to_mp4.rs - Capture from camera and save to MP4
• av_record.rs - Record audio + video to MOV

Run an example:

cargo run --example encode_dummy_image

Requirements

• macOS 10.8+ or iOS 8.0+
• Rust 1.56+

License

MIT