BestAudioSource

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m
(r1 update, remove dead links)
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
{{FilterCat|External_filters|Plugins_x64|Source_filters}}
+
{{FilterCat4|External_filters|Plugins|Plugins_x64|Source_filters}}
 
{{Filter3
 
{{Filter3
 
|1={{Author/Myrsloik}}
 
|1={{Author/Myrsloik}}
|2=test6
+
|2=r1
|3=[https://www.dropbox.com/s/qjr2fs8k0t7uqw0/BestAudioSource-test6.7z?dl=1 BestAudioSource-test6.7z]
+
|3=[https://github.com/vapoursynth/bestaudiosource/releases bas-r1.7z]
 
|4=Source filters  
 
|4=Source filters  
|5=Open source
+
|5=[https://github.com/vapoursynth/bestaudiosource/blob/master/COPYING MIT]
 
|6=[https://forum.doom9.org/showthread.php?t=177337 Doom9 Thread]}}
 
|6=[https://forum.doom9.org/showthread.php?t=177337 Doom9 Thread]}}
  
 
== Description ==
 
== Description ==
A new sample accurate but somewhat slow FFmpeg based audio source filter for AviSynth+. No indexing required and only available in 64-bit.
+
A new sample accurate but somewhat slow FFmpeg based audio source filter for AviSynth. No indexing is required.
 
<br>
 
<br>
 
<br>
 
<br>
  
 
== Requirements ==
 
== Requirements ==
* [x64] [[AviSynth+]]
+
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
 +
* [x64]: [[AviSynth+]]
  
 
<br>
 
<br>
  
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|BestAudioSource (string "source", int "track", int "adjustdelay", bool "exactsamples", string "varprefix")}}
+
:{{Template:FuncDef|BestAudioSource (string "source", int "track", int "adjustdelay", bool "exactsamples", bool "enable_drefs", bool "use_absolute_path", float "drc_scale", string "varprefix")}}
 
<br>
 
<br>
 
::{{Par2|source|string| }}
 
::{{Par2|source|string| }}
Line 32: Line 33:
 
::{{Par2|exactsamples|bool|false}}
 
::{{Par2|exactsamples|bool|false}}
 
:::Set to true if you want opening files to be really slow but for some reason need a completely sample exact length.
 
:::Set to true if you want opening files to be really slow but for some reason need a completely sample exact length.
 +
<br>
 +
::{{Par2|enable_drefs|bool|false}}
 +
:::Enable loading of external tracks, disabled by default.
 +
<br>
 +
::{{Par2|use_absolute_path|bool|false}}
 +
:::Allows loading of external tracks via absolute paths, disabled by default.
 +
<br>
 +
::{{Par2|drc_scale|float|0.0}}
 +
:::Dynamic Range Scale Factor. The factor to apply to dynamic range values from the AC-3 stream. This factor is applied exponentially.
 +
:::The default value is 0. There are 3 notable scale factor ranges:
 +
:::*<code>drc_scale == 0</code> <br> DRC disabled. Produces full range audio.
 +
:::*<code>0 < drc_scale <= 1</code> <br> DRC enabled. Applies a fraction of the stream DRC value. Audio reproduction is between full range and full compression.
 +
:::*<code>drc_scale > 1</code> <br> DRC enabled. Applies drc_scale asymmetrically. Loud sounds are fully compressed. Soft sounds are enhanced.
 
<br>
 
<br>
 
::{{Par2|varprefix|string|""}}
 
::{{Par2|varprefix|string|""}}
Line 40: Line 54:
  
 
== Examples ==
 
== Examples ==
  BestAudioSource("blah.mp4", track=-1, adjustdelay=-1, exactsamples=false, varprefix="")
+
  BestAudioSource("blah.mp4", track=-1, adjustdelay=-1, exactsamples=false, enable_drefs=false, use_absolute_path=false, drc_scale=0)
 
<br>
 
<br>
  
 
== Changelog ==
 
== Changelog ==
 
  Version        Date            Changes<br>
 
  Version        Date            Changes<br>
 +
r1            2021/09/11      - First release. Everything except automatic delay adjustment implemented.
 +
test8          2021/08/17      - Updated with several new options, including drc_scale.
 +
test7          2020/08/02      - VapourSynth: update for V4 api again; fixed all known bugs and should be fairly stable
 
  test6          2020/06/23      - Fixes clips with more than 2^31 samples in VS and adds 24 bit output to AviSynth.
 
  test6          2020/06/23      - Fixes clips with more than 2^31 samples in VS and adds 24 bit output to AviSynth.
 
  test5          2020/06/13      - Properly export the number of bits per sample
 
  test5          2020/06/13      - Properly export the number of bits per sample
Line 60: Line 77:
 
!!width="200px"| Mirror
 
!!width="200px"| Mirror
 
|-
 
|-
!test6
+
!test8
|[https://www.dropbox.com/s/qjr2fs8k0t7uqw0/BestAudioSource-test6.7z?dl=1 BestAudioSource-test6.7z]
+
|[https://www.dropbox.com/s/6a65wt49r7fck15/BestAudioSource-test8.7z?dl=1 BestAudioSource-test8.7z]
 
|
 
|
|-
 
!test5
 
|[https://www.dropbox.com/s/wz3nbdz3kjjxqmy/BestAudioSource-test5.7z?dl=1 BestAudioSource-test5.7z]
 
|
 
|-
 
!test4
 
|[https://www.dropbox.com/s/bwkys1kukuv5ant/bestaudiosource-test4.7z?dl=1 bestaudiosource-test4.7z]
 
|
 
|-
 
!test3
 
|[https://www.dropbox.com/s/cl5nudu1bud2nct/bestaudiosource-test3.7z?dl=1 bestaudiosource-test3.7z]
 
|[https://web.archive.org/web/20200523045527if_/https://files.videohelp.com/u/223002/bestaudiosource-test3.7z bestaudiosource-test3.7z]
 
 
|}
 
|}
<!--test 3 source code: [https://web.archive.org/web/20200523045802if_/https://files.videohelp.com/u/223002/bestaudiosource-master.zip bestaudiosource-master.zip] -->
 
 
<br>
 
<br>
 +
 
== External Links ==
 
== External Links ==
 
*[https://github.com/vapoursynth/bestaudiosource GitHub] - Source code repository.
 
*[https://github.com/vapoursynth/bestaudiosource GitHub] - Source code repository.

Latest revision as of 05:15, 12 September 2021

Abstract
Author Myrsloik
Version r1
Download bas-r1.7z
Category Source filters
License MIT
Discussion Doom9 Thread

Contents

[edit] Description

A new sample accurate but somewhat slow FFmpeg based audio source filter for AviSynth. No indexing is required.

[edit] Requirements


[edit] Syntax and Parameters

BestAudioSource (string "source", int "track", int "adjustdelay", bool "exactsamples", bool "enable_drefs", bool "use_absolute_path", float "drc_scale", string "varprefix")


string  source =
Path to audio file. Path can be omitted if the script is in the same folder as the audio file.


int  track = -1
Positive track numbers refer to the FFmpeg given stream number. Negative numbers refer to the nth audio track with -1 being the first.


int  adjustdelay = -1
Delay adjustment; not yet implemented.


bool  exactsamples = false
Set to true if you want opening files to be really slow but for some reason need a completely sample exact length.


bool  enable_drefs = false
Enable loading of external tracks, disabled by default.


bool  use_absolute_path = false
Allows loading of external tracks via absolute paths, disabled by default.


float  drc_scale = 0.0
Dynamic Range Scale Factor. The factor to apply to dynamic range values from the AC-3 stream. This factor is applied exponentially.
The default value is 0. There are 3 notable scale factor ranges:
  • drc_scale == 0
    DRC disabled. Produces full range audio.
  • 0 < drc_scale <= 1
    DRC enabled. Applies a fraction of the stream DRC value. Audio reproduction is between full range and full compression.
  • drc_scale > 1
    DRC enabled. Applies drc_scale asymmetrically. Loud sounds are fully compressed. Soft sounds are enhanced.


string  varprefix = ""
Works the same as FFMS2.
  • "BASCHANNEL_LAYOUT"
  • "BASVALID_BITS"


[edit] Examples

BestAudioSource("blah.mp4", track=-1, adjustdelay=-1, exactsamples=false, enable_drefs=false, use_absolute_path=false, drc_scale=0)


[edit] Changelog

Version        Date            Changes
r1 2021/09/11 - First release. Everything except automatic delay adjustment implemented. test8 2021/08/17 - Updated with several new options, including drc_scale. test7 2020/08/02 - VapourSynth: update for V4 api again; fixed all known bugs and should be fairly stable test6 2020/06/23 - Fixes clips with more than 2^31 samples in VS and adds 24 bit output to AviSynth. test5 2020/06/13 - Properly export the number of bits per sample test4 2020/06/09 - Update for latest audio api revision test3 2020/01/26 - Fixes the channel mask variable that was previously almost always wrong in AviSynth. - Also add VapourSynth support. test2 2020/01/08 - Fixed output and new parameter "exactsamples" test1 2020/01/07 - Initial release


[edit] Archived Downloads

Version Download Mirror
test8 BestAudioSource-test8.7z


[edit] External Links

  • GitHub - Source code repository.




Back to External Filters

Personal tools