Merge - Revision history

Reel.Deal at 05:23, 18 September 2022

2022-09-18T05:23:10Z

← Older revision		Revision as of 07:23, 18 September 2022
Line 1:		Line 1:
	~~__TOC__~~

	<div {{BlueBox2\|40\|0\|3px solid purple}} >		<div {{BlueBox2\|40\|0\|3px solid purple}} >
	{{AvsPlusFullname}}<br>		{{AvsPlusFullname}}<br>
Line 6:		Line 4:
	</div>		</div>


			__TOC__

	== Usage ==		== Usage ==

Reel.Deal: add link to avs+ documentation

2022-09-16T23:26:08Z

add link to avs+ documentation

← Older revision		Revision as of 01:26, 17 September 2022
Line 1:		Line 1:
	__TOC__		__TOC__

			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/merge.html https://avisynthplus.readthedocs.io]
			</div>


	== Usage ==		== Usage ==
	<div style="max-width:62em" >		<div style="max-width:62em" >

Raffriff42: formatting

2016-02-28T09:25:40Z

formatting

← Older revision		Revision as of 11:25, 28 February 2016
Line 1:		Line 1:
	__TOC__		__TOC__
	== Usage ==		== Usage ==
			<div style="max-width:62em" >
	{{FuncDefH4\|Merge}}		{{FuncDefH4\|Merge}}
	{{FuncDef		{{FuncDef
Line 6:		Line 7:
	}}		}}

	~~''This filter merges~~ pixels from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''		Merges pixels from one videoclip into another.<br>
			There is an optional weighting, so a percentage between the two clips can be specified.

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
Line 29:		Line 31:
	}}		}}

	~~''This filter merges~~ the ''chroma'' from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''		Merges the ''chroma'' from one videoclip into another.<br>
			There is an optional weighting, so a percentage between the two clips can be specified.

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
Line 54:		Line 57:
	}}		}}

	''~~This filter merges the~~ luma from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''		Merges the ''luma'' from one videoclip into another.<br>
			There is an optional weighting, so a percentage between the two clips can be specified.

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
Line 71:		Line 75:
	*Clips must have the same pixel-type and be [[YUV]] only.		*Clips must have the same pixel-type and be [[YUV]] only.
	*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.		*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.
			</div>


	== Examples ==		== Examples ==
			<div style="max-width:62em" >
	<div {{BoxWidthIndent\|46\|0}} >		<div {{BoxWidthIndent\|46\|0}} >
	# Blur the Luma channel.		# Blur the Luma channel.
Line 109:		Line 115:
	vid2 = AviSource("main2.avi")		vid2 = AviSource("main2.avi")
	Merge(vid1, vid2)		Merge(vid1, vid2)
			</div>
	</div>		</div>

Admin: changed wording a bit

2016-01-31T18:54:24Z

changed wording a bit

← Older revision		Revision as of 20:54, 31 January 2016
Line 6:		Line 6:
	}}		}}

	''~~Merge (blend)~~ one ~~video clip~~ into another.''		''This filter merges pixels from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
			::The clip that has the pixels merged into (the base clip).
	:{{Par2\|clip2\|clip\|(required)}}		:{{Par2\|clip2\|clip\|(required)}}
	::~~Base~~ clip, overlay clip.		::The clip from which the pixel data is taken (the overlay clip).

	:{{Par2\|weight\|float\|0.5}}		:{{Par2\|weight\|float\|0.5}}
	::~~Strength of effect~~. Range is 0.0–1.0.		::Defines how much influence the new clip should have. Range is 0.0–1.0.
	::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.		::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.
	::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} completely.		::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} completely.
	::*Default is 0.5; output is average of {{FuncArg\|clip1}} and {{FuncArg\|clip2}}.		::*Default is 0.5; output is average of {{FuncArg\|clip1}} and {{FuncArg\|clip2}}.

	*Clips must ~~be in~~ the same ~~[[Convert\|colorspace]]~~.		*Clips must have the same pixel-type.
	*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.		*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.

Line 24:		Line 25:
	{{FuncDefH4\|MergeChroma}}		{{FuncDefH4\|MergeChroma}}
	{{Func2Def		{{Func2Def
	\|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''chromaweight'' ] )		\|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''chromaweight'' ] ) (depreciated since v2.60)
	\|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''weight'' ] ) (*v2.60 only)		\|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''weight'' ] ) (*v2.60 only)
	}}		}}

	''~~Merge~~ ''chroma'' from one ~~video clip~~ into another.''		''This filter merges the ''chroma'' from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
			::The clip that has the chroma pixels merged into (the base clip).
	:{{Par2\|clip2\|clip\|(required)}}		:{{Par2\|clip2\|clip\|(required)}}
	::~~Base~~ clip, chroma overlay clip.		::The clip from which the chroma pixel data is taken (the overlay clip).

	:{{Par2\|chromaweight\|float\|1.0}}		:{{Par2\|chromaweight\|float\|1.0}}
	:{{Par2\|weight\|float\|1.0}}		:{{Par2\|weight\|float\|1.0}}
	::~~Strength of effect~~. Range is 0.0–1.0.		::Defines how much influence the new clip should have. Range is 0.0–1.0.
	::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.		::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.
	::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} chroma completely.		::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} chroma completely.
Line 42:		Line 44:
	::*Alternate name ''weight'' added in AviSynth v2.60		::*Alternate name ''weight'' added in AviSynth v2.60

	*Clips must ~~be in~~ the same ~~[[Convert\|colorspace]]~~ and [[YUV]] only.		*Clips must have the same pixel-type and be [[YUV]] only.
	*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.		*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.

Line 48:		Line 50:
	{{FuncDefH4\|MergeLuma}}		{{FuncDefH4\|MergeLuma}}
	{{Func2Def		{{Func2Def
	\|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''lumaweight'' ] )		\|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''lumaweight'' ] ) (depreciated since v2.60)
	\|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''weight'' ] ) (*v2.60 only)		\|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''weight'' ] ) (*v2.60 only)
	}}		}}

	''~~Merge ''~~luma'' from one ~~video clip~~ into another.''		''This filter merges the luma from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified.''

	:{{Par2\|clip1\|clip\|(required)}}		:{{Par2\|clip1\|clip\|(required)}}
			::The clip that has the luma pixels merged into (the base clip).
	:{{Par2\|clip2\|clip\|(required)}}		:{{Par2\|clip2\|clip\|(required)}}
	::~~Base~~ clip, luma overlay clip.		::The clip from which the luma pixel data is taken (the overlay clip).

	:{{Par2\|lumaweight\|float\|1.0}}		:{{Par2\|lumaweight\|float\|1.0}}
	:{{Par2\|weight\|float\|1.0}}		:{{Par2\|weight\|float\|1.0}}
	::~~Strength of effect~~. Range is 0.0–1.0.		::Defines how much influence the new clip should have. Range is 0.0–1.0.
	::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.		::*At 0.0, {{FuncArg\|clip2}} has no influence on the output.
	::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} luma completely.		::*At 1.0, {{FuncArg\|clip2}} replaces {{FuncArg\|clip1}} luma completely.
Line 66:		Line 69:
	::*Alternate name ''weight'' added in AviSynth v2.60		::*Alternate name ''weight'' added in AviSynth v2.60

	*Clips must ~~be in~~ the same ~~[[Convert\|colorspace]]~~ and [[YUV]] only.		*Clips must have the same pixel-type and be [[YUV]] only.
	*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.		*Audio, [[Clip_properties\|FrameRate]] and [[Clip_properties\|FrameCount]] are taken from the first clip.

Raffriff42: one more touch-up

2016-01-24T02:53:50Z

one more touch-up

← Older revision		Revision as of 04:53, 24 January 2016
Line 1:		Line 1:
	__TOC__		__TOC__
			== Usage ==
	{{FuncDefH4\|Merge}}		{{FuncDefH4\|Merge}}
	{{FuncDef		{{FuncDef
Line 71:		Line 71:

	== Examples ==		== Examples ==
	<div {{BoxWidthIndent\|56\|2}} >		<div {{BoxWidthIndent\|46\|0}} >
	# Blur the Luma channel.		# Blur the Luma channel.
	[[DGDecode/MPEG2Source\|MPEG2Source]]("main.d2v")		[[DGDecode/MPEG2Source\|MPEG2Source]]("main.d2v")
Line 78:		Line 78:
	</div>		</div>

	<div {{BoxWidthIndent\|56\|2}} >		<div {{BoxWidthIndent\|46\|0}} >
	# Do a spatial smooth on the chroma channel		# Do a spatial smooth on the chroma channel
	# that will be mixed 50/50 with the original image.		# that will be mixed 50/50 with the original image.
Line 86:		Line 86:
	</div>		</div>

	<div {{BoxWidthIndent\|56\|2}} >		<div {{BoxWidthIndent\|46\|0}} >
	# Run a temporal smoother and a soft spatial		# Run a temporal smoother and a soft spatial
	# smoother on the luma channel, and a more aggressive		# smoother on the luma channel, and a more aggressive
Line 101:		Line 101:
	</div>		</div>

	<div {{BoxWidthIndent\|56\|2}} >		<div {{BoxWidthIndent\|46\|0}} >
	# Average two video sources.		# Average two video sources.
	vid1 = [[AviSource]]("main.avi")		vid1 = [[AviSource]]("main.avi")
Line 107:		Line 107:
	Merge(vid1, vid2)		Merge(vid1, vid2)
	</div>		</div>


	== Changelog ==		== Changelog ==

Raffriff42: formatting, links, phrasing

2016-01-24T02:49:45Z

formatting, links, phrasing

Show changes

Admin: 1 revision

2013-05-09T15:02:22Z

1 revision

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

Wilbert at 18:14, 19 June 2011

2011-06-19T18:14:48Z

New page

{{Template:Func3Def|Merge(clip ''clip1'', clip ''clip2'' [, float ''weight''])|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''weight''])|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''weight''])}}

These filters make it possible to merge pixels (or, for YUV clips only, just the luma or chroma) from one videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified. Merge is present in v2.56.

''clip1'' is the clip that has the appropriate data merged INTO (based on which filter you use). In the case of MergeLuma or MergeChroma, that means that the OTHER channel (chroma or luma respectively) is completely untouched.

''clip2'' is the one from which the pixel data must be taken. In MergeChroma, this is where the Chroma will be taken from, and vice-versa for MergeLuma. It must be the same colorspace as clip1; i.e. you cannot merge from a YV12 clip into a YUY2 clip.

The weight defines how much influence the new clip should have. Range is 0.0 to 1.0, where 0.0 is no influence and 1.0 will completely overwrite the specified channel. The default is 0.5 for Merge and 1.0 for MergeChroma and MergeLuma. The filter will be slightly slower when a weight other than 0.0, 0.5 or 1.0 is specified.

The audio, framerate and framecount are taken from the first clip.

Nb, prior to v2.60 there was no ''weight'' argument for MergeChroma and MergeLuma: you needed to use ''ChromaWeight'' for MergeChroma() and ''LumaWeight'' for MergeLuma(). Since v2.60 you can also use the ''weight'' argument.

'''Examples:'''

# Will only blur the Luma channel.
mpeg2source("c:\apps\avisynth\main.d2v")
lumvid = [[Blur]](1.0)
MergeLuma(lumvid)

# This will do a Spatial Smooth on the Chroma channel
# that will be mixed 50/50 with the original image.
mpeg2source("c:\apps\avisynth\main.d2v")
chromavid = SpatialSmoother(2,3)
MergeChroma(chromavid,0.5)

# This will run a temporalsmoother and a soft spatial
# smoother on the Luma channel, and a more agressive
# spatial smoother on the Chroma channel.
# The original luma channel is then added with the
# smoothed version at 75%. The chroma channel is
# fully replaced with the blurred version.
mpeg2source("c:\apps\avisynth\main.d2v")
luma = TemporalSmoother(2,3)
luma = luma.Spatialsmoother(3,10,10)
chroma = Spatialsmoother(3,40,40)
MergeLuma(luma,0.75)
MergeChroma(chroma)

# This will average two video sources.
[[AviSource]]("c:\apps\avisynth\main.avi")
vid2 = AviSource("c:\apps\avisynth\main2.avi")
Merge(vid2)

'''Changelog:'''
{| border="1"
|-
| v2.60
| Added alias "Weight" for "ChromaWeight" and "LumaWeight".
|-
| v2.56
| Added Merge.
|}

[[Category:Internal filters]]