[FFmpeg-devel] [PATCH] avfilter/elbg: Extend filter to include alpha values in the quantization procedure

[Soft Works]

> -----Original Message-----
> From: ffmpeg-devel <ffmpeg-devel-bounces at ffmpeg.org> On Behalf Of
> Paul B Mahol
> Sent: Tuesday, 28 September 2021 19:35
> To: FFmpeg development discussions and patches <ffmpeg-
> devel at ffmpeg.org>
> Subject: Re: [FFmpeg-devel] [PATCH] avfilter/elbg: Extend filter to
> include alpha values in the quantization procedure
> 
> On Tue, Sep 28, 2021 at 7:16 PM Soft Works <softworkz at hotmail.com>
> wrote:
> 
> >
> >
> > > -----Original Message-----
> > > From: ffmpeg-devel <ffmpeg-devel-bounces at ffmpeg.org> On Behalf Of
> > > Paul B Mahol
> > > Sent: Tuesday, 28 September 2021 18:05
> > > To: FFmpeg development discussions and patches <ffmpeg-
> > > devel at ffmpeg.org>
> > > Subject: Re: [FFmpeg-devel] [PATCH] avfilter/elbg: Extend filter
> to
> > > include alpha values in the quantization procedure
> > >

[..]

> > > Are you audio engineer? Follow documentation.
> >
> > Accidentally, I'm quite familiar with audio production and studio
> > technology, that's why I'm sure that even for audio engineers it's
> > not always clear what the filters are doing. The documentation is
> > often too minimal and it would be nice when it would include
> > example use cases and example command lines.
> > Same as for the elbg filter, I don't mean it in a negative way.
> > What I mean is that it's somewhat unfortunate to put so much effort
> > in developing those filters, when their benefits remain to be
> invisible
> > for the majority of users.
> >
> 
> Give examples, propose improvements, elbg is not only filter.

It's not my current focus, but I think it would be a good idea 
in general when the .texi docs would include at least one working
example for each filter that demonstrates the provided capability
at its best.
By 'working example', I mean a command line that is not just using
placeholders (like '-I INPUT') but specific public streams like 
from https://streams.videolan.org/ffmpeg/ 

I've done that for the new subtitle filters and I think it would
be very helpful for users to better understand a filter's benefits
when there's an example that can be run and allows to look at 
the results.

Kind regards,
softworkz