Skip to main content

Crate oxideav_sub_image

Crate oxideav_sub_image 

Source
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.

FormatCodec idContainer nameExtensions
PGSpgspgs.sup
DVB subdvbsub(none)rides MPEG-TS
VobSubvobsubvobsub.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+.sub pair written in lock-step which this crate doesn’t yet expose.
  • One RGBA oxideav_core::VideoFrame is 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.
  • pts on the emitted frame matches the cue start time (in the packet’s oxideav_core::TimeBase). Duration is carried on the oxideav_core::Packet the 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 .sup parser, 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 .sup streams.
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.