MixAudio

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (added category)
m (formatting)
Line 1: Line 1:
{{Template:FuncDef|MixAudio(clip ''clip1'', clip ''clip2'', float ''clip1_factor'', float ''clip2_factor'')}}
+
<div style="max-width:62em" >
 +
{{FuncDef
 +
|MixAudio(clip ''clip1'', clip ''clip2'', float ''clip1_factor'', float ''clip2_factor'')
 +
}}
  
Mixes audio from two clips. A volume for the two clips can be given, but is optional.  
+
Mixes audio from two clips. A ''volume factor'' for the two clips can be given, but is optional.  
  
Volume is given as a factor, where 0.0 is no audio from the desired channel, and 1.0 is 100% from the desired channel. Default is 0.5/0.5 - if only one factor is given, the other channel will be 1.0-(factor). If factor1 + factor2 is more than 1.0, you risk clipping your signal.  
+
:{{Par2|clip1, clip2|clip|}}
 +
::Source clips. Output video is copied from {{FuncArg|clip1}}.
  
The sample rate of the two clips needs to be the same (use [[ResampleAudio]] if necessary). Your clips need also to have the same number of channels (stereo/mono) - use [[ConvertToMono]] or [[MonoToStereo]] / [[MergeChannels]] if necessary.  
+
:{{Par2|clip1_factor, clip2_factor|float|(auto)}}
 +
::Set the volume of each clip's audio, where 0.0 is no audio from that clip, and 1.0 is 100% audio.
 +
::Default is 0.5/0.5; if only one factor is given, the other will be 1.0-(factor).  
 +
::If {{FuncArg|clip1_factor}}+{{FuncArg|clip2_factor}} > 1.0, you risk clipping your signal if sample type is not [[Float]].
  
'''Example:'''
+
The sample rate of the two clips needs to be the same &ndash; use [[ResampleAudio]] if necessary.
  
 +
Your clips need to have the same number of channels &ndash; use [[ConvertToMono]], [[MonoToStereo]] or [[MergeChannels]] if necessary.
 +
 +
 +
'''Example:'''
 +
<div {{BoxWidthIndent|56|0}} >
 
  # mixes two sources, with one source slightly lower than the other.
 
  # mixes two sources, with one source slightly lower than the other.
 
  video = AviSource("c:\movie.avi")
 
  video = AviSource("c:\movie.avi")
 
  Soundtrack = WavSource("c:\soundtrack.wav")
 
  Soundtrack = WavSource("c:\soundtrack.wav")
 
  Speak = WavSource("c:\speak.wav")
 
  Speak = WavSource("c:\speak.wav")
  audio = MixAudio(Soundtrack, Speak, 0.75, 0.25)  # The Expert may notice that the last 0.25 is actually redundant here.
+
  audio = MixAudio(Soundtrack, Speak, 0.75, 0.25)
 +
  # (the Expert may notice that the last 0.25 is actually redundant here)
 
  return AudioDub(video, audio)
 
  return AudioDub(video, audio)
 +
</div>
 +
</div>
  
  
 
[[Category:Internal filters]]
 
[[Category:Internal filters]]
 
[[Category:Audio_filters]]
 
[[Category:Audio_filters]]

Revision as of 11:46, 28 February 2016

MixAudio(clip clip1, clip clip2, float clip1_factor, float clip2_factor)

Mixes audio from two clips. A volume factor for the two clips can be given, but is optional.

clip  clip1, clip2 =
Source clips. Output video is copied from clip1.
float  clip1_factor, clip2_factor = (auto)
Set the volume of each clip's audio, where 0.0 is no audio from that clip, and 1.0 is 100% audio.
Default is 0.5/0.5; if only one factor is given, the other will be 1.0-(factor).
If clip1_factor+clip2_factor > 1.0, you risk clipping your signal if sample type is not Float.

The sample rate of the two clips needs to be the same – use ResampleAudio if necessary.

Your clips need to have the same number of channels – use ConvertToMono, MonoToStereo or MergeChannels if necessary.


Example:

# mixes two sources, with one source slightly lower than the other.
video = AviSource("c:\movie.avi")
Soundtrack = WavSource("c:\soundtrack.wav")
Speak = WavSource("c:\speak.wav")
audio = MixAudio(Soundtrack, Speak, 0.75, 0.25)  
# (the Expert may notice that the last 0.25 is actually redundant here)
return AudioDub(video, audio)
Personal tools