LSMASHSource/LSMASHAudioSource

Revision as of 14:08, 2 June 2014

This function uses libavcodec as an audio decoder and L-SMASH as a demuxer. Recommended for MP4, MOV, ISO Base Media and its derived file formats.

One advantage of LSMASHAudioSource is that it doesn't need to create an index file for its supported formats.

LSMASHAudioSource (string source, int "track", bool "skip_priming", string "layout", int "rate")

string source =

The path to the source file; path can be omitted if the source file is in the same directory as the AviSynth script (*.avs).

int track = 0

The track number to open in the source file.

The value 0 means trying to get the first detected audio stream.

bool skip_priming = true

Whether skip priming samples or not.

Priming samples is detected from iTunSMPB or the first non-empty edit.

If any priming samples, do pre-roll whenever any seek of audio stream occurs.

string layout = ""

Output audio channel layout.

If unspecified, audio stream is output to the buffer from the decoder via the resampler at the channel layout

which is the first maximum number of channels in audio stream.

You can specify channel layout by combination of the name of a channel layout with separator (+) as follows.

- The name or mask of a single channel.

$ Example: standard ffmpeg based 5.1ch surround layout : FL+FR+FC+LFE+BL+BR = 0x3f
FL	(0x1)	=	Front Left
FR	(0x2)	=	Front Right
FC	(0x4)	=	Front Center
LFE	(0x8)	=	Low Frequency Effect
BL	(0x10)	=	Back Left
BR	(0x20)	=	Back Right
FLC	(0x40)	=	Front Left of Center
FRC	(0x80)	=	Front Right of Center
BC	(0x100)	=	Back Center
SL	(0x200)	=	Side Left
SR	(0x400)	=	Side Right
TC	(0x800)	=	Top Center
TFL	(0x1000)	=	Top Front Left
TFC	(0x2000)	=	Top Front Center
TFR	(0x4000)	=	Top Front Right
TBL	(0x8000)	=	Top Back Left
TBC	(0x10000)	=	Top Back Center
TBR	(0x20000)	=	Top Back Right
DL	(0x20000000)	=	Stereo Downmixed Left
DR	(0x40000000)	=	Stereo Downmixed Right
WL	(0x80000000)	=	Wide Left
WR	(0x100000000)	=	Wide Right
SDL	(0x200000000)	=	Surround Direct Left
SDR	(0x400000000)	=	Surround Direct Right
LFE2	(0x800000000)	=	Low Frequency Effect 2

- The name of a usual channel layout.

- Number of channels.

Note: the above listed notations are the present things.

In the future, they might be changed.

int rate = 0

Audio sampling rate or sampling frequency in units of Hz.

The value 0 means audio stream is output to the buffer via the resampler at the maximum sampling rate in audio stream.

Otherwise, audio stream is output to the buffer via the resampler at specified sampling rate.

LSMASHAudioSource with default settings:

LSMASHAudioSource(source="source.mov", track=0, skip_priming=true, layout="", rate=0)

Back to LSMASHSource ←

@@ Line 4: / Line 4: @@
 <br>
 == Description ==
-:This function uses [http://en.wikipedia.org/wiki/Libavcodec#Implemented_video_codecs libavcodec] as an audio decoder and [http://github.com/l-smash/l-smash L-SMASH] as a demuxer. Recommended for MP4, MOV, [http://en.wikipedia.org/wiki/ISO_base_media_file_format ISO Base Media] and its derived file formats.
+:This function uses [http://en.wikipedia.org/wiki/Libavcodec#Implemented_audio_codecs libavcodec] as an audio decoder and [http://github.com/l-smash/l-smash L-SMASH] as a demuxer. Recommended for MP4, MOV, [http://en.wikipedia.org/wiki/ISO_base_media_file_format ISO Base Media] and its derived file formats.
 :One advantage of LSMASHAudioSource is that it doesn't need to create an index file for its supported formats.
 <br>