Expand description
Bitmap-native subtitle formats for oxideav.
These subtitle formats don’t carry text — each cue is a picture that
overlays the video. The decoders in this crate therefore produce
oxideav_core::Frame::Video values holding an RGBA canvas sized to
the subtitle’s display context (either the declared video frame size
or the bitmap’s own size, depending on format), not
oxideav_core::Frame::Subtitle.
| Format | Codec id | Container name | Extensions |
|---|---|---|---|
| PGS | pgs | pgs | .sup |
| DVB sub | dvbsub | (none) | rides MPEG-TS |
| VobSub | vobsub | vobsub | .idx+.sub |
§Scope
- PGS supports both decode and encode.
- DVB subtitles and VobSub are decode-only for now. DVB subs need a
TS-aware muxer upstream; VobSub needs the
.idx+.subpair written in lock-step which this crate doesn’t yet expose. - One RGBA
oxideav_core::VideoFrameis emitted per display-set (cue change) — either the full video-canvas-sized frame (PGS/DVB) or the bitmap’s own rectangle (VobSub). - Output pixel format is always
oxideav_core::PixelFormat::Rgba. ptson the emitted frame matches the cue start time (in the packet’soxideav_core::TimeBase). Duration is carried on theoxideav_core::Packetthe container emits.
See per-module docs for format-specific limitations.
Modules§
- composite
- Alpha-aware RGBA compositing primitives shared by the bitmap-subtitle decoders.
- dvbsub
- DVB subtitle decoder (ETSI EN 300 743).
- pgs
- PGS / HDMV / Blu-ray
.supparser, container, and decoder. - vobsub
- VobSub / DVD SPU parser, container (
.idx+.sub), and decoder.
Constants§
- DVBSUB_
CODEC_ ID - Codec id for DVB subtitle streams (ETSI EN 300 743).
- PGS_
CODEC_ ID - Codec id for PGS / HDMV / Blu-ray
.supstreams. - VOBSUB_
CODEC_ ID - Codec id for VobSub / DVD SPU streams.
Functions§
- register
- Unified registration entry point — installs PGS / DVB / VobSub
codecs into the codec sub-registry and the PGS + VobSub containers
into the container sub-registry of the supplied
RuntimeContext. - register_
codecs - Register decoders for PGS, DVB subtitles, and VobSub.
- register_
containers - Register the PGS (
.sup) and VobSub (.idx+.sub) containers.