ResampleAudio
From Avisynth wiki
(Difference between revisions)
Raffriff42 (Talk | contribs) m (remove unclear section on fractional resampling) |
(add link to avs+ documentation) |
||
(2 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
<div style="max-width:62em" > | <div style="max-width:62em" > | ||
+ | <div {{BlueBox2|40|0|3px solid purple}} > | ||
+ | {{AvsPlusFullname}}<br> | ||
+ | Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/resampleaudio.html https://avisynthplus.readthedocs.io] | ||
+ | </div> | ||
+ | |||
+ | |||
High-quality change of audio sample rate. | High-quality change of audio sample rate. | ||
* Accepts any number of channels. | * Accepts any number of channels. | ||
* The conversion is skipped if the sample rate is already at the given rate. | * The conversion is skipped if the sample rate is already at the given rate. | ||
* Supports ''fractional'' resampling (where {{FuncArg|new_rate_denominator}} ≠ 1). | * Supports ''fractional'' resampling (where {{FuncArg|new_rate_denominator}} ≠ 1). | ||
− | * Note, internal rounding may affect [[Clip_properties|AudioDuration]] | + | * Note, internal rounding may affect [[Clip_properties|AudioDuration]] slightly – see [[#Examples|example]] below. |
</div> | </div> | ||
Line 13: | Line 19: | ||
|ResampleAudio(clip ''clip'', ''int new_rate_numerator'' [, int ''new_rate_denominator'' ] ) | |ResampleAudio(clip ''clip'', ''int new_rate_numerator'' [, int ''new_rate_denominator'' ] ) | ||
}} | }} | ||
+ | |||
+ | :{{Par2|clip |clip|}} | ||
+ | ::Source clip. Supported [[ConvertAudio|audio sample types]]: 16-bit integer and [[Float|32-bit floating-point]]. | ||
+ | ::Other sample types (8-, 24- and 32-bit integer) are automatically converted to floating-point. | ||
:{{Par2|new_rate_numerator|int|}} | :{{Par2|new_rate_numerator|int|}} |
Latest revision as of 06:39, 18 September 2022
AviSynth+
Up-to-date documentation: https://avisynthplus.readthedocs.io
High-quality change of audio sample rate.
- Accepts any number of channels.
- The conversion is skipped if the sample rate is already at the given rate.
- Supports fractional resampling (where new_rate_denominator ≠ 1).
- Note, internal rounding may affect AudioDuration slightly – see example below.
[edit] Syntax and Parameters
ResampleAudio(clip clip, int new_rate_numerator [, int new_rate_denominator ] )
- clip clip =
- Source clip. Supported audio sample types: 16-bit integer and 32-bit floating-point.
- Other sample types (8-, 24- and 32-bit integer) are automatically converted to floating-point.
- int new_rate_numerator =
- Set the numerator for the new sample rate.
- int new_rate_denominator = 1
- Set the denominator for the new sample rate. Default 1.
[edit] Examples
- Resample audio to 48 kHz:
source = WavSource("c:\audio.wav") return ResampleAudio(source, 48000)
- Exact 4% speed up for PAL telecine:
Nfr_num = 25 Nfr_den = 1 AviSource("C:\Film.avi") # 23.976 fps, 44100Hz Ar = AudioRate # intermediate sample rate: ResampleAudio(Ar*FramerateNumerator*Nfr_den, FramerateDenominator*Nfr_num) # final sample rate: AssumeSampleRate(Ar) AssumeFPS(Nfr_num, Nfr_den, false)
In the example above, the intermediate sample rate needs to be
- (AudioRate*FramerateNumerator*Nfr_den=1)/(FramerateDenominator*Nfr_num=25)
- or (44100 * 24000 * 1) / (1001 * 25) = 42293.706294...
but because audio sample rates are always integers, 42293.706294 must be rounded to 42294,
which results in a time slippage of about 30ms per hour.
[edit] Changes
v2.56 | Added new_sample_rate=float. |