Skip to main content

SubtitleFilter

Struct SubtitleFilter 

Source
pub struct SubtitleFilter { /* private fields */ }
Expand description

Burns ASS/SRT subtitles onto video frames inside a frame pipeline.

Build one with SubtitleFilter::builder, then attach it to an output (recommended: subtitles are rendered against the final, post-filter-graph geometry) via a frame pipeline:

use ez_ffmpeg::filter::frame_pipeline_builder::FramePipelineBuilder;
use ez_ffmpeg::subtitle::SubtitleFilter;
use ez_ffmpeg::{AVMediaType, FfmpegContext, Output};

let filter = SubtitleFilter::builder()
    .ass_content(ass_script)
    .build()?;
let pipeline: FramePipelineBuilder = AVMediaType::AVMEDIA_TYPE_VIDEO.into();
FfmpegContext::builder()
    .input("input.mp4")
    .output(Output::from("output.mp4")
        .add_frame_pipeline(pipeline.filter("subtitles", Box::new(filter))))
    .build()?.start()?.wait()?;

Timing comes from each frame’s pts × time_base (the scheduler keeps both valid on either pipeline side), so subtitle timestamps line up with the post-filter-graph timeline exactly like FFmpeg’s own subtitles filter.

Implementations§

Source§

impl SubtitleFilter

Source

pub fn builder() -> SubtitleFilterBuilder

Starts configuring a subtitle filter.

Trait Implementations§

Source§

impl Debug for SubtitleFilter

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl FrameFilter for SubtitleFilter

Source§

fn media_type(&self) -> AVMediaType

Returns the media type this filter operates on. Read more
Source§

fn filter_frame( &mut self, frame: Frame, _ctx: &FrameFilterContext<'_>, ) -> Result<Option<Frame>, String>

Processes a single frame through the filter. Read more
Source§

fn uninit(&mut self, _ctx: &FrameFilterContext<'_>)

Cleans up the filter. Read more
Source§

fn init(&mut self, ctx: &FrameFilterContext<'_>) -> Result<(), String>

Initializes the filter. Read more
Source§

fn request_frame( &mut self, _ctx: &FrameFilterContext<'_>, ) -> Result<Option<Frame>, String>

Requests a frame from the filter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WasmNotSend for T
where T: Send,