[FFmpeg-devel] [PATCH 3/4] doc: document swr async

[Michael Niedermayer]

On Mon, Dec 24, 2012 at 12:47:28AM +0100, Stefano Sabatini wrote:
> On date Sunday 2012-12-23 19:34:54 +0100, Michael Niedermayer encoded:
> > On Sun, Dec 23, 2012 at 06:41:21PM +0100, Stefano Sabatini wrote:
> > > On date Sunday 2012-12-23 00:07:13 +0100, Michael Niedermayer encoded:
> > > > Signed-off-by: Michael Niedermayer <michaelni at gmx.at>
> > > > ---
> > > >  doc/filters.texi |    7 +++++++
> > > >  1 file changed, 7 insertions(+)
> > > > 
> > > > diff --git a/doc/filters.texi b/doc/filters.texi
> > > > index f456d03..45d85f9 100644
> > > > --- a/doc/filters.texi
> > > > +++ b/doc/filters.texi
> > > > @@ -428,6 +428,13 @@ timestamps, do a combination of both or do neither.
> > > >  The filter accepts the following named parameters:
> > > >  @table @option
> > > >  
> > > > + at item async
> > > > +simple 1 parameter audio sync to timestamps using stretching/squeezing/filling
> > > > +and trimming. Setting this to 1 will enable filling and trimming, larger
> > > > +values represent the maximum amount in samples that the data may be
> > > > +stretched or squeezed.
> > > 
> > > 1 == inconditional squeezing/trimming/filling?
> >
> > inconditional is no english word
> 
> I mean what's the difference between 1 (filling/trimming) and >1
> (squeezing/stretching)?
[...]
> What I'm not sure is if trimming/filling is equivalent to
> squeezing/stretching or has an entirely different meaning (which is
> not clear/specified in the docs).

trimming/filling is meant in the sense of removing samples or injecting
silence


> 
> > > 
> > > Amount in samples = samples per channel?
> > 
> > the stretching/squeezing/filling and trimming is applied to each
> > channel equally and independant of other channels
> > 
> > 
> > > 
> > > Also the amount in samples represents the maximum number of samples in
> > > the current samples frame?
> > 
> > I dont know what you mean by "samples frame"
> 
> I figured it out from your other post:
> 
> values represent the maximum amount in samples _for each second_ that
> the data may be stretched or squeezed.
> 

> > 
> > 
> > > 
> > > > +The default is disabled
> > > 
> > > 0 = no adjustements?
> > 
> > yes
> 
> I suggest:
> 
> Default value is 0, thus the synchronization compensation behavior is
> disabled.

i think this should be worded differently, it sounds kinda odd

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

It is dangerous to be right in matters on which the established authorities
are wrong. -- Voltaire
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20121224/394adc57/attachment.asc>