church_archive_script/Programs/doc/functions/audio/audiomix.html
2023-11-29 16:12:35 +00:00

171 lines
No EOL
12 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>AudioMix &mdash; VapourSynth R64 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="../../_static/jquery.js"></script>
<script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
<script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
<script src="../../_static/doctools.js"></script>
<script src="../../_static/sphinx_highlight.js"></script>
<script src="../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="AudioReverse" href="audioreverse.html" />
<link rel="prev" title="AudioLoop" href="audioloop.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../index.html" class="icon icon-home">
VapourSynth
</a>
<div class="version">
R64
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../installation.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../gettingstarted.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../pythonreference.html">Python Reference</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../functions.html">Function Reference</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../../functions.html#general-functions">General Functions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../functions.html#video-functions">Video Functions</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../../functions.html#audio-functions">Audio Functions</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="assumesamplerate.html">AssumeSampleRate</a></li>
<li class="toctree-l3"><a class="reference internal" href="audiogain.html">AudioGain</a></li>
<li class="toctree-l3"><a class="reference internal" href="audioloop.html">AudioLoop</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">AudioMix</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#std.AudioMix"><code class="docutils literal notranslate"><span class="pre">AudioMix()</span></code></a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="audioreverse.html">AudioReverse</a></li>
<li class="toctree-l3"><a class="reference internal" href="audiosplice.html">AudioSplice</a></li>
<li class="toctree-l3"><a class="reference internal" href="audiotrim.html">AudioTrim</a></li>
<li class="toctree-l3"><a class="reference internal" href="blankaudio.html">BlankAudio</a></li>
<li class="toctree-l3"><a class="reference internal" href="setaudiocache.html">SetAudioCache</a></li>
<li class="toctree-l3"><a class="reference internal" href="shufflechannels.html">ShuffleChannels</a></li>
<li class="toctree-l3"><a class="reference internal" href="splitchannels.html">SplitChannels</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../output.html">Output</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../applications.html">Applications and Libraries</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../apireference.html">VapourSynth C API Reference</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">VapourSynth</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="../../functions.html">Function Reference</a></li>
<li class="breadcrumb-item active">AudioMix</li>
<li class="wy-breadcrumbs-aside">
<a href="../../_sources/functions/audio/audiomix.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="audiomix">
<h1>AudioMix<a class="headerlink" href="#audiomix" title="Permalink to this heading"></a></h1>
<dl class="py function">
<dt class="sig sig-object py" id="std.AudioMix">
<span class="sig-prename descclassname"><span class="pre">std.</span></span><span class="sig-name descname"><span class="pre">AudioMix</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">anode[]</span> <span class="pre">clips</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">float[]</span> <span class="pre">matrix</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">int[]</span> <span class="pre">channels_out</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#std.AudioMix" title="Permalink to this definition"></a></dt>
<dd><p>AudioMix can mix and combine channels from different clips in the most
general way possible.</p>
<p>Most of the returned clips properties are implicitly determined from the
first clip given to <em>clips</em>.</p>
<p>The <em>clips</em> parameter takes one or more clips with the same format. If the clips
are different lengths theyll be zero extended to that of the longest.</p>
<p>The argument <em>matrix</em> applies the coefficients to each channel of each input clip where
the channels are in the numerical order of their channel constants. For example a stereo clip
will have its channels presented in the order FRONT_LEFT and then FRONT_RIGHT.</p>
<p>Output channels and order is determined by the <em>channels_out</em> array
between input index and output channel happens on the order of lowest output channel
identifier to the highest.</p>
<p>Below are some examples of useful operations.</p>
<p>Downmix stereo audio to mono:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">AudioMix</span><span class="p">(</span><span class="n">clips</span><span class="o">=</span><span class="n">clip</span><span class="p">,</span> <span class="n">matrix</span><span class="o">=</span><span class="p">[</span><span class="mf">0.5</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">],</span> <span class="n">channels_out</span><span class="o">=</span><span class="p">[</span><span class="n">vs</span><span class="o">.</span><span class="n">FRONT_CENTER</span><span class="p">])</span>
</pre></div>
</div>
<p>Downmix 5.1 audio:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">AudioMix</span><span class="p">(</span><span class="n">clips</span><span class="o">=</span><span class="n">clip</span><span class="p">,</span> <span class="n">matrix</span><span class="o">=</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mf">0.7071</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mf">0.7071</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mf">0.7071</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mf">0.7071</span><span class="p">],</span> <span class="n">channels_out</span><span class="o">=</span><span class="p">[</span><span class="n">vs</span><span class="o">.</span><span class="n">FRONT_LEFT</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">FRONT_RIGHT</span><span class="p">])</span>
</pre></div>
</div>
<p>Copy stereo audio to 5.1 and zero the other channels:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">AudioMix</span><span class="p">(</span><span class="n">clips</span><span class="o">=</span><span class="n">c</span><span class="p">,</span> <span class="n">matrix</span><span class="o">=</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">],</span> <span class="n">channels_out</span><span class="o">=</span><span class="p">[</span><span class="n">vs</span><span class="o">.</span><span class="n">FRONT_LEFT</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">FRONT_RIGHT</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">FRONT_CENTER</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">LOW_FREQUENCY</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">BACK_LEFT</span><span class="p">,</span> <span class="n">vs</span><span class="o">.</span><span class="n">BACK_RIGHT</span><span class="p">])</span>
</pre></div>
</div>
</dd></dl>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="audioloop.html" class="btn btn-neutral float-left" title="AudioLoop" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="audioreverse.html" class="btn btn-neutral float-right" title="AudioReverse" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2012-2023, Fredrik Mellbin.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>