mediaway-encoder 0.2.1

Hardware-accelerated video/audio encoding (OS-native backends)
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
67
68
69
70
71
72
73
74
75
76

# mediaway-encoder

<p align="center">
  <a href="https://docs.rs/mediaway-encoder"><img src="https://img.shields.io/docsrs/mediaway-encoder" alt="docs.rs"></a>
  <a href="https://crates.io/crates/mediaway-encoder"><img src="https://img.shields.io/crates/v/mediaway-encoder.svg" alt="crates.io"></a>
  <a href="https://github.com/nyxways/mediaway"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue" alt="License"></a>
</p>

> **Status:** early development (`0.x`). Not recommended for production; public APIs may
> change without notice. Part of the [Mediaway](https://github.com/nyxways/mediaway)
> media stack.

Hardware-accelerated video and audio encoding: the `VideoEncoder` / `AudioEncoder`
traits, the `auto` selection layer (`AutoVideoEncodeConfig`, path classes from Zero-Copy
down to software), and per-platform backends — Windows WMF (H.264/AAC, DX11 Zero-Copy),
NVIDIA NVENC, Intel Quick Sync (via oneVPL), Vulkan Video, WebCodecs (wasm), and VA-API
on Linux. Feature-gated `audio` / `video` for slim builds.

## Quick start

```rust
use mediaway_common::{CodecKind, PixelFormat, Rational, VideoInputPreference};
use mediaway_encoder::{VideoEncoder, VideoEncoderConfig};
use mediaway_encoder::windows::WindowsVideoEncoder;

let config = VideoEncoderConfig {
    codec: CodecKind::H264,
    width: 1920, height: 1080,
    time_base: Rational::new(1, 30),
    bitrate_bps: 8_000_000,
    pixel_format: PixelFormat::Nv12,
    input: VideoInputPreference::CpuUploadOk,
    gpu_device: None,
};

let mut encoder = WindowsVideoEncoder::open(&config)?; // WMF session
encoder.push_frame(&nv12_frame)?;
while let Some(packet) = encoder.poll_packet()? { /* H.264 packets */ }
encoder.flush()?;
```

For Zero-Copy GPU input, set `input: VideoInputPreference::ZeroCopyGpu` and pass the
matching `gpu_device` — or use `mediaway::platform::AutoEncoder::open` to let Mediaway
pick the best path.

## Status

Status marks: ✅ first-class (tests for claimed scope) · ⚡ Zero-Copy path (no payload copy; implies ✅) · 🆗 best-effort / prototype · 🛠️ planned · ❌ attempted and genuinely blocked · 👻 not exercisable yet (no hardware / device / session available)

| Area | Status | Notes |
| ---- | ------ | ----- |
| `VideoEncoder` / `AudioEncoder` traits | ✅ | Streaming push/poll API |
| Windows WMF H.264 encode | ✅ | CPU upload + DX11 texture Zero-Copy (works on NVIDIA's async MFTs since 2026-09-18, ADR-0012); AAC encode. `hns` timestamps round-trip exactly and `dts` comes from the MFT (ADR-0013). Dropping an async hardware encoder waits 50 ms before releasing the MFT |
| `finish(self)` | ✅ | Flush and collect every remaining packet in one call; dropping an unflushed encoder silently discards in-flight frames (ADR-0006) |
| Capability probe `support` / `support_at` | ✅ | Support is resolution-dependent — probe at the size you will encode (ADR-0005) |
| NVIDIA NVENC | ✅ | Hardware-verified H.264 / HEVC / AV1 (CPU upload) |
| Intel Quick Sync (oneVPL) | ✅ | Hardware-verified H.264 / HEVC; AV1 not supported on tested iGPU |
| Vulkan Video encode | ✅ | Hardware-verified H.264 + HEVC; AV1 implemented, driver-blocked |
| WebCodecs encode (wasm32) | ✅ | CPU + `GPUTexture` Zero-Copy via WebGPU canvas |
| Linux VA-API H.264 (CPU upload) | 👻 | Implemented; zero real-hardware verification yet |
| `auto` readback / software path classes | 🛠️ | Policy bits recognized; honest `NoBackend` error today |

## Docs

- [`docs/roadmap.md`](docs/roadmap.md) — stages, deferred items, design decisions
- [`mediaway`](../mediaway/) — convenience pipeline (`EncodeSession`) over this crate
- Root [README](../../README.md) — codec support matrices (OS / GPU / vendor)

## Contributing

Contributions are welcome — open an issue or pull request at
[github.com/nyxways/mediaway](https://github.com/nyxways/mediaway).

## License

MIT OR Apache-2.0.