shithub: sox

Download patch

ref: 3e264d195ae38ae281cec5c3cc3632a56bb9cb1c
parent: 0904a4c1387919d318adece40838564b0a96c5b6
author: Rob Sykes <robs@users.sourceforge.net>
date: Sat Aug 13 03:52:59 EDT 2011

the splice effect is easily misunderstood; hopefully, this diagram will help alleviate this

--- a/sox.1
+++ b/sox.1
@@ -3375,6 +3375,27 @@
 effect given with the position at which to perform the splice\*mthis is
 length of the first audio section (including the excess).
 .SP
+The following diagram uses the tape analogy to illustrate the splice
+operation.  The effect simulates the diagonal cuts and joins the two pieces:
+.EX
+
+      length1   excess
+    -----------><--->
+    _________   :   :  _________________
+             \\  :   : :\\     `         
+              \\ :   : : \\     `        
+               \\:   : :  \\     `       
+                *   : :   * - - *      
+                 \\  : :   :\\     `     
+                  \\ : :   : \\     `    
+    _______________\\: :   :  \\_____`____
+                      :   :   :     :
+                      <--->   <----->
+                      excess  leeway
+
+.EE
+where * indicates the joining points.
+.SP
 For example, a long song begins with two verses which start (as
 determined e.g. by using the
 .B play