Merge - Revision history

Reel.Deal at 05:23, 18 September 2022

2022-09-18T05:23:10Z

Reel.Deal: add link to avs+ documentation

2022-09-16T23:26:08Z

add link to avs+ documentation

Raffriff42: formatting

2016-02-28T09:25:40Z

formatting

Admin: changed wording a bit

2016-01-31T18:54:24Z

changed wording a bit

Raffriff42: one more touch-up

2016-01-24T02:53:50Z

one more touch-up

Raffriff42: formatting, links, phrasing

2016-01-24T02:49:45Z

formatting, links, phrasing

Admin: 1 revision

2013-05-09T15:02:22Z

1 revision

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]]

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

@@ Line 1: / Line 1: @@
 __TOC__
 == Usage ==
 <div style="max-width:62em" >

@@ Line 1: / Line 1: @@
 __TOC__
 == Usage ==
 {{FuncDefH4|Merge}}
 {{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>
 :{{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>
 :{{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>
 :{{Par2|clip1|clip|(required)}}
@@ Line 71: / Line 75: @@
 *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.
 == Examples ==
 <div {{BoxWidthIndent|46|0}} >
   # Blur the Luma channel.
@@ Line 109: / Line 115: @@
   vid2 = AviSource("main2.avi")
   Merge(vid1, vid2)
 </div>

@@ 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|clip2|clip|(required)}}
-::Base clip, overlay clip.
+::The clip from which the pixel data is taken (the overlay clip).
 :{{Par2|weight|float|0.5}}
-::Strength of effect. Range is 0.0&ndash;1.0.
+::Defines how much influence the new clip should have. Range is 0.0&ndash;1.0.
 ::*At 0.0, {{FuncArg|clip2}} has no influence on the output.
 ::*At 1.0, {{FuncArg|clip2}} replaces {{FuncArg|clip1}} completely.
 ::*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.
@@ Line 24: / Line 25: @@
 {{FuncDefH4|MergeChroma}}
 {{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)
 }}
-''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|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|weight|float|1.0}}
-::Strength of effect. Range is 0.0&ndash;1.0.
+::Defines how much influence the new clip should have. Range is 0.0&ndash;1.0.
 ::*At 0.0, {{FuncArg|clip2}} has no influence on the output.
 ::*At 1.0, {{FuncArg|clip2}} replaces {{FuncArg|clip1}} chroma completely.
@@ Line 42: / Line 44: @@
 ::*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.
@@ Line 48: / Line 50: @@
 {{FuncDefH4|MergeLuma}}
 {{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)
 }}
-''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|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|weight|float|1.0}}
-::Strength of effect. Range is 0.0&ndash;1.0.
+::Defines how much influence the new clip should have.  Range is 0.0&ndash;1.0.
 ::*At 0.0, {{FuncArg|clip2}} has no influence on the output.
 ::*At 1.0, {{FuncArg|clip2}} replaces {{FuncArg|clip1}} luma completely.
@@ Line 66: / Line 69: @@
 ::*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.

@@ Line 1: / Line 1: @@
 __TOC__
+== Usage ==
 {{FuncDefH4|Merge}}
 {{FuncDef
@@ Line 71: / Line 71: @@
 == Examples ==
-<div {{BoxWidthIndent|56|2}} >
+<div {{BoxWidthIndent|46|0}} >
   # Blur the Luma channel.
   [[DGDecode/MPEG2Source|MPEG2Source]]("main.d2v")
@@ Line 78: / Line 78: @@
 </div>
-<div {{BoxWidthIndent|56|2}} >
+<div {{BoxWidthIndent|46|0}} >
   # Do a spatial smooth on the  chroma channel
   # that will be mixed 50/50 with the original image.
@@ Line 86: / Line 86: @@
 </div>
-<div {{BoxWidthIndent|56|2}} >
+<div {{BoxWidthIndent|46|0}} >
   # Run a temporal smoother and a soft spatial
   # smoother on the luma channel, and a more aggressive
@@ Line 101: / Line 101: @@
 </div>
-<div {{BoxWidthIndent|56|2}} >
+<div {{BoxWidthIndent|46|0}} >
   # Average two video sources.
   vid1 = [[AviSource]]("main.avi")
@@ Line 107: / Line 107: @@
   Merge(vid1, vid2)
 </div>
 == Changelog ==

@@ Line 1: / Line 1: @@
-{{Template:Func3Def|Merge(clip ''clip1'', clip ''clip2'' [, float ''weight''])|MergeChroma(clip ''clip1'', clip ''clip2'' [, float ''weight''])|MergeLuma(clip ''clip1'', clip ''clip2'' [, float ''weight''])}}
+__TOC__
-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.
+{{FuncDefH4|Merge}}
-''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.
+''Merge (blend) one video clip into another.''
-''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.
+:{{Par2|clip1|clip|(required)}}
-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.
+:{{Par2|weight|float|0.5}}
-The audio, framerate and framecount are taken from the first clip.
+*Clips must be in the same [[Convert|colorspace]].
-'''Examples:'''
+{{FuncDefH4|MergeChroma}}
- # Will only blur the Luma channel.
+''Merge ''chroma'' from one video clip into another.''
- mpeg2source("c:\apps\avisynth\main.d2v")
- lumvid = [[Blur]](1.0)
- MergeLuma(lumvid)
-  # This will do a Spatial Smooth on the Chroma channel
+:{{Par2|clip1|clip|(required)}}
   # that will be mixed 50/50 with the original image.
-  mpeg2source("c:\apps\avisynth\main.d2v")
+  MPEG2Source("main.d2v")
-  chromavid = SpatialSmoother(2,3)
+  clipC = [[SpatialSoften]](2,3)
-  MergeChroma(chromavid,0.5)
+  MergeChroma(clipC , 0.5)
-  # This will run a temporalsmoother and a soft spatial
+<div {{BoxWidthIndent|56|2}} >
-  # smoother on the Luma channel, and a more agressive
+  # Run a temporal smoother and a soft spatial
-  # spatial smoother on the Chroma channel.
+  # smoother on the luma channel, and a more aggressive
   # 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")
+  MPEG2Source("main.d2v")
-  luma = TemporalSmoother(2,3)
+  clipY = [[TemporalSoften]](2,3)
-  luma = luma.Spatialsmoother(3,10,10)
+  \       .SpatialSoften(3,10,10)
-  chroma = Spatialsmoother(3,40,40)
+  clipC = SpatialSoften(3,40,40)
-  MergeLuma(luma,0.75)
+  MergeLuma(clipY, 0.75)
-  MergeChroma(chroma)
+  MergeChroma(clipC)
-  # This will average two video sources.
+<div {{BoxWidthIndent|56|2}} >
-  [[AviSource]]("c:\apps\avisynth\main.avi")
+  # Average two video sources.
-  vid2 = AviSource("c:\apps\avisynth\main2.avi")
+  vid1 = [[AviSource]]("main.avi")
-  Merge(vid2)
+  vid2 = AviSource("main2.avi")
-'''Changelog:'''
+== Changelog ==
 {| border="1"
 |-
 | v2.60
-| Added alias "Weight" for "ChromaWeight" and "LumaWeight".
+| Added alias ''weight'' for ''chromaweight'' and ''lumaweight''.
 |-
 | v2.56
-| Added Merge.
+| Added ''Merge''.
 |}
 [[Category:Internal filters]]