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

[Michael Niedermayer]

On Mon, Dec 24, 2012 at 04:07:18AM +0100, Michael Niedermayer wrote:
> 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

tried to reword and applied

feel free to improve ..

[...]

-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

When the tyrant has disposed of foreign enemies by conquest or treaty, and
there is nothing more to fear from them, then he is always stirring up
some war or other, in order that the people may require a leader. -- Plato
-------------- 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/20130106/91d21666/attachment.asc>