GetChannel - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T04:29:59Z

add link to avs+ documentation

← Older revision		Revision as of 06:29, 18 September 2022
Line 1:		Line 1:
	<div style="max-width:68em" >		<div style="max-width:68em" >
			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/getchannel.html https://avisynthplus.readthedocs.io]
			</div>


	{{Func4Def		{{Func4Def
	\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...] )		\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...] )

Raffriff42: one more touch-up

2016-02-15T12:49:34Z

one more touch-up

← Older revision		Revision as of 14:49, 15 February 2016
Line 114:		Line 114:

	==== Examples ====		==== Examples ====
	* ~~Remove right~~ channel ~~information~~, and ~~return as mono clip with only left channel~~:		* Get mono audio from left channel of a WAV file,
			<div {{ListItemContinue}} >
			and dub to video from AVI:
			</div>
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
	video = [[AviSource]]("c:\~~filename~~.avi")		video = [[AviSource]]("c:\video.avi")
	stereo = [[WavSource]]("c:\~~afx-ab3_t4~~.wav")		stereo = [[WavSource]]("c:\audio2ch.wav")
	mono = GetLeftChannel(stereo)		mono = GetLeftChannel(stereo)
	return [[AudioDub]](video, mono)		return [[AudioDub]](video, mono)
Line 124:		Line 127:
	* Do the same, alternate syntax:		* Do the same, alternate syntax:
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
	video = AviSource("c:\~~filename~~.avi")		video = AviSource("c:\video.avi")
	stereo = WavSource("c:\~~afx-ab3_t4~~.wav")		stereo = WavSource("c:\audio2ch.wav")
	mono = GetChannel(stereo, 1)		mono = GetChannel(stereo, 1)
	return AudioDub(video, mono)		return AudioDub(video, mono)
	</div>		</div>

	* ~~You could also obtain~~ the channels from the AVI file itself:		* Do the same with the audio channels from the AVI file itself:
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
	video = AviSource("c:\~~filename~~.avi")		video = AviSource("c:\video+audio2ch.avi")
	return GetChannel(video, 1)		return GetChannel(video, 1)
	</div>		</div>

	* Convert AVI with 5.1 audio to a stereo ~~signal~~		* Convert AVI with 5.1 audio to stereo (copy ''front left'' and ''front right'')
	<div {{ListItemContinue}} >		<div {{ListItemContinue}} >
	(But see ~~below~~ for channel ordering, and [http://forum.doom9.org/showthread.php?p=1243880#post1243880 here] for more complex downmix functions.)		(But see [[#Remarks\|Remarks]] for channel ordering, and examples below and [http://forum.doom9.org/showthread.php?p=1243880#post1243880 here] for more complex downmix functions.)
	</div>		</div>
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
	video = AviSource("c:\~~divx_51~~.avi")		video = AviSource("c:\video+audio6ch.avi")
	stereo = GetChannel(video, 1, 2)		stereo = GetChannel(video, 1, 2)
	return AudioDub(video, stereo)		return AudioDub(video, stereo)
	</div>		</div>

	* ~~Convert AVI with "uncompressed~~ 5.1 ~~wav" audio to a stereo signal~~:		* Get ''front left'' and ''front right'' audio from a 5.1 AVI:
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
	video = AviSource("c:\~~divx_wav~~.avi")		video = AviSource("c:\video+audio6ch.avi")
	audio = WavSource("c:\~~divx_wav~~.avi")		audio = WavSource("c:\video+audio6ch.avi")
	stereo = GetChannel(audio, 1, 2)		stereo = GetChannel(audio, 1, 2)
	return AudioDub(video, stereo)		return AudioDub(video, stereo)
	</div>		</div>

	* Mix 5.1 ~~AC3~~ to stereo - see discussion [http://forum.doom9.org/showthread.php?p=1735072#post1735072 here].		* Mix 5.1 to stereo - see discussion [http://forum.doom9.org/showthread.php?p=1735072#post1735072 here].
	<div {{ListItemContinue}} >		<div {{ListItemContinue}} >
	Note returned audio has sample type [[Float]].<br>		Note returned audio has sample type [[Float]].<br>
Line 160:		Line 163:
	</div>		</div>
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
			AviSource("c:\video+audio6ch.avi")
			DownMix
			[[Normalize]]
			[[ConvertAudioTo16bit]]
			return Last
	function DownMix(clip a,		function DownMix(clip a,
	\ float "centergain", float "surroundgain")		\ float "centergain", float "surroundgain")
	{		{
	a.ConvertAudioToFloat()		a.[[ConvertAudioToFloat]]

	## ~~AC3~~ channel layout:		## 5.1 WAV channel layout:
	fl = GetChannel(1)		fl = GetChannel(1)
	fr = GetChannel(2)		fr = GetChannel(2)
	fc = GetChannel(3)		fc = GetChannel(3)
	lf = GetChannel(4)		lf = GetChannel(4) ## (LFE not used)
	sl = GetChannel(5)		sl = GetChannel(5)
	sr = GetChannel(6)		sr = GetChannel(6)
Line 180:		Line 188:
	## add surround		## add surround
	gs = Default(surroundgain, 1.0) * 0.7071		gs = Default(surroundgain, 1.0) * 0.7071
	fl = MixAudio(fl, sl, 1.0, gs)		fl = [[MixAudio]](fl, sl, 1.0, gs)
	fr = MixAudio(fr, sr, 1.0, gs)		fr = MixAudio(fr, sr, 1.0, gs)

	return AudioDub(a, MergeChannels(fl, fr))		return [[AudioDub]](a, [[MergeChannels]](fl, fr))
	}		}
	</div>		</div>

Raffriff42: one more touch-up

2016-02-15T02:12:38Z

one more touch-up

← Older revision		Revision as of 04:12, 15 February 2016
Line 19:		Line 19:
	! colspan="2" style="text-align:left" \|  WAV, 2 channels (stereo)		! colspan="2" style="text-align:left" \|  WAV, 2 channels (stereo)
	\|-		\|-
	\| 1 \|\| left		\|style="width:2em"\| 1 \|\| left
	\|-		\|-
	\| 2 \|\| right		\| 2 \|\| right
Line 27:		Line 27:
	\|-		\|-
	! colspan="2" style="text-align:left" \|  WAV, 5.1 channels		! colspan="2" style="text-align:left" \|  WAV, 5.1 channels
	\|-\| 1 \|\| front left		\|-
			\|style="width:2em"\| 1 \|\| front left
	\|-		\|-
	\| 2 \|\| front right		\| 2 \|\| front right
Line 155:		Line 156:
	* Mix 5.1 AC3 to stereo - see discussion [http://forum.doom9.org/showthread.php?p=1735072#post1735072 here].		* Mix 5.1 AC3 to stereo - see discussion [http://forum.doom9.org/showthread.php?p=1735072#post1735072 here].
	<div {{ListItemContinue}} >		<div {{ListItemContinue}} >
	Note returned audio is [[Float]] ~~type~~. [[Normalize]] is recommended before [[ConvertAudio\|converting to 16-bit]] to avoid possible overload.		Note returned audio has sample type [[Float]].<br>
			[[Normalize]] is recommended before [[ConvertAudio\|converting to 16-bit]] to avoid possible overload.
	</div>		</div>
	<div {{BoxWidthIndent\|36\|2}} >		<div {{BoxWidthIndent\|36\|2}} >
Line 163:		Line 165:
	a.ConvertAudioToFloat()		a.ConvertAudioToFloat()

	## channel ~~layouts~~: ~~(AC3, the most common)~~		## AC3 channel layout:
	fl = GetChannel(1)		fl = GetChannel(1)
	fr = GetChannel(2)		fr = GetChannel(2)

Raffriff42: add example + one more touch-up

2016-02-15T02:09:11Z

add example + one more touch-up

Show changes

Raffriff42: one more touch-up

2016-02-15T01:02:25Z

one more touch-up

← Older revision		Revision as of 03:02, 15 February 2016
Line 1:		Line 1:
	<div style="max-width:68em" >		<div style="max-width:68em" >
	{{~~Func3Def~~		{{Func4Def
	\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...] )		\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...] )
			\|GetChannels(clip ''clip'', int ''ch1'' [, int ''ch2'', ...] )
	\|GetLeftChannel(clip ''clip'')		\|GetLeftChannel(clip ''clip'')
	\|GetRightChannel(clip ''clip'')		\|GetRightChannel(clip ''clip'')
Line 7:		Line 8:

	*'''GetChannel''' returns one or more channels of a multichannel signal.		*'''GetChannel''' returns one or more channels of a multichannel signal.
	*'''GetLeftChannel''' returns the left and '''GetRightChannel''' the right ~~channel from a stereo signal~~.		*'''GetLeftChannel''' returns the left channel from a stereo signal, and '''GetRightChannel''' returns the right.
	*'''GetChannels''' is an alias to '''GetChannel''' and can be used interchangeably.		*'''GetChannels''' is an alias for '''GetChannel''' and can be used interchangeably.

Raffriff42: formatting, links, phrasing

2016-02-15T00:59:59Z

formatting, links, phrasing

Show changes

Raffriff42: added category

2015-11-08T15:27:10Z

added category

← Older revision		Revision as of 17:27, 8 November 2015
Line 129:		Line 129:

	[[Category:Internal filters]]		[[Category:Internal filters]]
			[[Category:Audio_filters]]

Reel.Deal: /* Remarks */ fix dead links

2015-04-05T00:47:48Z

Remarks: fix dead links

← Older revision		Revision as of 02:47, 5 April 2015
Line 75:		Line 75:
	\| rear right channel		\| rear right channel
	\|-		\|-
	\| [http://www.atsc.org/standards/a_52a.pdf 5.1 AC3]		\| [https://web.archive.org/web/20051108165008/http://www.atsc.org/standards/a_52a.pdf 5.1 AC3]
	\| front left channel		\| front left channel
	\| front center channel		\| front center channel
Line 83:		Line 83:
	\| LFE		\| LFE
	\|-		\|-
	\| [http://~~webapp~~.etsi.org/~~action%5CPU~~/~~20020827~~/ts_102114v010101p.pdf 5.1 DTS]		\| [http://www.etsi.org/deliver/etsi_ts/102100_102199/102114/01.01.01_60/ts_102114v010101p.pdf 5.1 DTS]
	\| front center channel		\| front center channel
	\| front left channel		\| front left channel
Line 91:		Line 91:
	\| LFE		\| LFE
	\|-		\|-
	\| [http://www.hydrogenaudio.org/index.php?showtopic=10986 5.1 AAC]		\| [http://web.archive.org/web/20070830151620/http://www.hydrogenaudio.org/forums/index.php?showtopic=10986 5.1 AAC]
	\| front center channel		\| front center channel
	\| front left channel		\| front left channel
Line 99:		Line 99:
	\| LFE		\| LFE
	\|-		\|-
	\| [http://preserve.harvard.edu/standards/Audio%20IFF%20Specification%201%203.pdf 5.1 AIFF]		\| [http://web.archive.org/web/20030817071619/http://preserve.harvard.edu/standards/Audio%20IFF%20Specification%201%203.pdf 5.1 AIFF]
	\| front left channel		\| front left channel
	\| rear left channel		\| rear left channel

Raffriff42: Make section headings; add internal link to Remarks section

2013-07-28T19:33:47Z

Make section headings; add internal link to Remarks section

← Older revision		Revision as of 21:33, 28 July 2013
Line 1:		Line 1:
	{{Template:Func3Def\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...])\|GetLeftChannel(clip ''clip'')\|GetRightChannel(clip ''clip'')}}		{{Template:Func3Def\|GetChannel(clip ''clip'', int ''ch1'' [, int ''ch2'', ...])\|GetLeftChannel(clip ''clip'')\|GetRightChannel(clip ''clip'')}}

	~~Prior to v2.5 GetLeftChannel returns the left and GetRightChannel the right channel from a stereo signal.~~ GetChannel is present starting from v2.5 and it returns one or more channels of a multichannel signal. GetChannels is an alias to GetChannel and they can be used interchangeably.		GetChannel is present starting from v2.5 and it returns one or more channels of a multichannel signal. Prior to v2.5 GetLeftChannel returns the left and GetRightChannel the right channel from a stereo signal. GetChannels is an alias to GetChannel and they can be used interchangeably.
	The ordering of the channels is determined by the ordering of the input file, because AviSynth doesn't assume any ordering. In case of stereo 2.0 WAV and 5.1 WAV files the ordering should be as follows:
			The ordering of the channels is determined by the ordering of the input file, because AviSynth doesn't assume any ordering (see [[GetChannel#Remarks\|Remarks]]). In case of stereo 2.0 WAV and 5.1 WAV files the ordering should be as follows:

	'''WAV, 2 channels (stereo):'''		'''WAV, 2 channels (stereo):'''
Line 26:		Line 27:
	\|}		\|}

	~~'''~~Examples~~:'''~~
			===Examples===

	<code>		<code>
Line 58:		Line 60:
	</code>		</code>

	~~'''Remark1:'''~~		===Remarks===

	Every file format has a different internal channel ordering. The following table gives this internal ordering for some formats (useful for plugin writers), but it is a decoder task supply to AviSynth the expected channel order (like WAV), if you use decoders like NicAudio/BassAudio or ffdshow/AC3_filter you don't need to worry about this:		Every file format has a different internal channel ordering. The following table gives this internal ordering for some formats (useful for plugin writers), but it is a decoder task supply to AviSynth the expected channel order (like WAV), if you use decoders like NicAudio/BassAudio or ffdshow/AC3_filter you don't need to worry about this:

Admin: 1 revision

2013-05-09T15:02:20Z

1 revision

← Older revision	Revision as of 17:02, 9 May 2013
(No difference)