oxideav-sub-image

Pure-Rust bitmap-subtitle codecs and containers:

• PGS (HDMV / Blu-ray .sup) — decode + encode, standalone .sup container.
• DVB subtitles (ETSI EN 300 743) — decode only, no standalone container (DVB subs ride inside MPEG-TS).
• VobSub / DVD SPU (.idx+.sub) — decode only, container reads the .idx text index + matched .sub payload (MPEG-PS pack + PES private_stream_1 or raw SPU-length-prefixed form).

All three decoders emit RGBA oxideav_core::VideoFrame values — one frame per display-set. The stream's media kind is Subtitle even though the frame kind is Video, matching ffmpeg's convention for bitmap-based subtitle codecs.

Part of the oxideav framework but usable standalone. Zero C dependencies.

Installation

[dependencies]
oxideav-core = "0.1"
oxideav-codec = "0.1"
oxideav-container = "0.1"
oxideav-sub-image = "0.0"

Quick use

Decoding a .sup file

use oxideav_codec::CodecRegistry;
use oxideav_container::ContainerRegistry;
use oxideav_core::Frame;

let mut codecs = CodecRegistry::new();
let mut containers = ContainerRegistry::new();
oxideav_sub_image::register(&mut codecs, &mut containers);

let input: Box<dyn oxideav_container::ReadSeek> = Box::new(
    std::io::Cursor::new(std::fs::read("subs.sup")?),
);
let mut dmx = containers.open("pgs", input)?;
let stream = &dmx.streams()[0];
let mut dec = codecs.make_decoder(&stream.params)?;

loop {
    match dmx.next_packet() {
        Ok(pkt) => {
            dec.send_packet(&pkt)?;
            while let Ok(Frame::Video(vf)) = dec.receive_frame() {
                // vf.format == PixelFormat::Rgba
                // vf.planes[0].data is the composed subtitle canvas.
            }
        }
        Err(oxideav_core::Error::Eof) => break,
        Err(e) => return Err(e.into()),
    }
}
# Ok::<(), Box<dyn std::error::Error>>(())

Encoding PGS

use oxideav_core::{CodecId, CodecParameters, Frame, MediaType, PixelFormat};

let mut params = CodecParameters::video(CodecId::new("pgs"));
params.media_type = MediaType::Subtitle;
params.pixel_format = Some(PixelFormat::Rgba);

let mut enc = codecs.make_encoder(&params)?;
enc.send_frame(&Frame::Video(rgba_frame))?;
let packet = enc.receive_packet()?;
// packet.data is one complete PGS display-set (PCS + WDS + PDS + ODS + END).

Each send_frame call produces one packet. The encoder quantises the frame's RGBA pixels into a ≤ 255-entry palette (index 0 is reserved for fully-transparent). When the input has more than 255 distinct RGBA colours the encoder falls back to a 3/3/2/2 (R/G/B/A) bucketed reduction; otherwise the quantisation is lossless up to the BT.601 RGB↔YCbCr round-trip PGS does in the palette. The composition always places a single object covering the full frame at (0, 0).

Codec / container IDs

Why PGS encode only?

DVB subs are carried inside MPEG-TS PES packets, so emitting a valid standalone stream requires a TS-aware muxer upstream. VobSub similarly requires the .idx text index and .sub binary to be written in lock-step, which this crate doesn't yet expose through the encoder trait. Both decoders read the preformatted payloads the container/TS demuxer delivers; adding encoders waits on the container layer growing the muxer counterparts.

License

MIT — see LICENSE.