Weave - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T07:46:55Z

add link to avs+ documentation

Raffriff42: formatting

2016-02-28T10:48:54Z

formatting

Raffriff42: added category

2015-11-08T15:20:01Z

added category

Raffriff42: bold + note v2.60 added WeaveColumns and WeaveRows

2015-04-27T02:02:15Z

bold + note v2.60 added WeaveColumns and WeaveRows

Admin: clean up offline docs

2013-07-08T20:51:30Z

clean up offline docs

Admin: 1 revision

2013-05-09T15:02:24Z

1 revision

Wilbert at 14:37, 15 March 2013

2013-03-15T14:37:01Z

New page

{{Template:FuncDef|Weave(clip ''clip'')}}

Weave is the opposite of [[SeparateFields]]: it takes pairs of fields from the input video clip and combines them together to produce interlaced frames. The new clip has half the frame rate and frame count. Weave uses the frame-parity information in the source clip to decide which field to put on top. If it gets it wrong, use [[ComplementParity]] beforehand or [[SwapFields]] afterwards.

All AviSynth filters keep track of field parity, so Weave will always join the fields together in the proper order. If you want the other order, you'll have to use [[ComplementParity]] beforehand or [[SwapFields]] afterwards.

From verions v2.56 this filter raises an exception if the clip is already frame-based. You may want to use [[AssumeFieldBased]] to force weave a second time. Prior versions did a no-op for materials that was already frame-based.

{{Template:Func2Def|WeaveColumns(clip ''clip'', int ''period'')|WeaveRows(clip ''clip'', int ''period'')}}

WeaveColumns and WeaveRows are the opposite of [[SeparateColumns]] and [[SeparateRows]].

WeaveColumns weaves ''period'' frames into a new frame as columns. The number of frames of the new clip is the number of frames of the old clip divided by ''period'' (rounded down). The width of new the frame is ''period'' times the width of the old frame.

WeaveRows weaves ''period'' frames into a new frame as rows. The number of frames of the new clip is the number of frames of the old clip divided by ''period'' (rounded down). The height of new the frame is ''period'' times the height of the old frame.

WeaveRows(2) is the same as Weave().

'''Example:'''

# makes a black and white checkerboard (without changing the spatial position of the rows and columns)

BlankClip() # black

# frame 0 consists of the rows 0,2,4,... of the original frame 0
# frame 1 consists of the rows 1,3,5,... of the original frame 0
# frame 2 consists of the rows 0,2,4,... of the original frame 1
# frame 3 consists of the rows 1,3,5,... of the original frame 1
# etc ...
SeparateRows(2)

# E1 consists of even frames thus
# rows 0,2,4,... of the original frame 0
# rows 0,2,4,... of the original frame 1
# etc ...
E1 = SelectEven()

# O1 consists of the odd frames thus
# rows 1,3,5,... of the original frame 0
# rows 1,3,5,... of the original frame 1
# etc ...
O1 = SelectOdd()

# likewise for a white clip
BlankClip(color=$FFFFFF)
SeparateRows(2)
E2 = SelectEven()
O2 = SelectOdd()

# rows 0,2,4,... of the original black frame 0
# rows 0,2,4,... of the original white frame 0
# rows 0,2,4,... of the original black frame 1
# rows 0,2,4,... of the original white frame 1
# etc ...
EI = Interleave(E1, E2)

# rows 1,3,5,... of the original white frame 0
# rows 1,3,5,... of the original black frame 0
# rows 1,3,5,... of the original white frame 1
# rows 1,3,5,... of the original black frame 1
# etc ...
OI = Interleave(O2, O1)

# alternating black and white columns frame 0
# alternating black and white columns frame 1
# etc ...
E = EI.WeaveColumns(2)

# alternating white and black columns frame 0
# alternating white and black columns frame 1
# etc ...
O = OI.WeaveColumns(2)

# alternating black and white columns frame 0
# alternating white and black columns frame 0
# alternating black and white columns frame 1
# alternating white and black columns frame 1
# etc ...
Interleave(E, O)

# weaves the even and odd rows of the original clips with alternating black and white columns
WeaveRows(2)

[[Category:Internal filters]]

← Older revision		Revision as of 07:46, 17 September 2022
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/weave.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
		+
	{{FuncDef\|Weave(clip ''clip'')}}		{{FuncDef\|Weave(clip ''clip'')}}

← Older revision		Revision as of 15:20, 8 November 2015
Line 88:		Line 88:

	[[Category:Internal filters]]		[[Category:Internal filters]]
		+	[[Category:Interlace_Filters]]

@@ Line 1: / Line 1: @@
-{{Template:FuncDef|Weave(clip ''clip'')}}
+<div style="max-width:62em" >
 '''Weave''' is the opposite of [[SeparateFields]]: it takes pairs of fields from the input video clip and combines them together to produce interlaced frames. The new clip has half the frame rate and frame count. Weave uses the frame-parity information in the source clip to decide which field to put on top. If it gets it wrong, use [[ComplementParity]] beforehand or [[SwapFields]] afterwards.
@@ Line 5: / Line 6: @@
 All AviSynth filters keep track of field parity, so Weave will always join the fields together in the proper order. If you want the other order, you'll have to use [[ComplementParity]] beforehand or [[SwapFields]] afterwards.
-From verions v2.56 this filter raises an exception if the clip is already frame-based. You may want to use [[AssumeFieldBased]] to force weave a second time. Prior versions did a no-op for materials that was already frame-based.
+This filter raises an exception if the clip is already frame-based. You may want to use [[AssumeFieldBased]] to force weave a second time. Prior versions did a no-op for materials that was already frame-based.
-{{Template:Func2Def|WeaveColumns(clip ''clip'', int ''period'')|WeaveRows(clip ''clip'', int ''period'')}}
+{{Func2Def
 '''WeaveColumns''' is the opposite of [[SeparateColumns]]: it weaves the columns of period frames into a single output frame. The number of frames of the new clip is the ceiling of 'the number of frames of the input clip divided by period'. WeaveColumns is a relatively slow filter due to the sparse pixel placing required by the algorithm. In some applications it may be faster to use [[TurnLeft]]/[[TurnRight]] with WeaveRows.
@@ Line 16: / Line 20: @@
 '''Example:'''
+<div {{BoxWidthIndent|48|0}} >
-  # makes a black and white checkerboard (without changing the spatial position of the rows and columns)
+  # makes a black and white checkerboard
-  BlankClip() # black
+  [[BlankClip]] # black
   # frame 0 consists of the rows 0,2,4,... of the original frame 0
@@ Line 26: / Line 31: @@
   # frame 3 consists of the rows 1,3,5,... of the original frame 1
   # etc ...
-  SeparateRows(2)
+  [[SeparateRows]](2)
   # E1 consists of even frames thus
@@ Line 32: / Line 37: @@
   # rows 0,2,4,... of the original frame 1
   # etc ...
-  E1 = SelectEven()
+  E1 = [[SelectEven]]
   # O1 consists of the odd frames thus
@@ Line 38: / Line 43: @@
   # rows 1,3,5,... of the original frame 1
   # etc ...
-  O1 = SelectOdd()
+  O1 = [[SelectOdd]]
   # likewise for a white clip
-  BlankClip(color=$FFFFFF)
+  [[BlankClip]](color=$FFFFFF)
-  SeparateRows(2)
+  [[SeparateRows]](2)
-  E2 = SelectEven()
+  E2 = [[SelectEven]]
-  O2 = SelectOdd()
+  O2 = [[SelectOdd]]
   # rows 0,2,4,... of the original black frame 0
@@ Line 51: / Line 56: @@
   # rows 0,2,4,... of the original white frame 1
   # etc ...
-  EI = Interleave(E1, E2)
+  EI = [[Interleave]](E1, E2)
   # rows 1,3,5,... of the original white frame 0
@@ Line 75: / Line 80: @@
   # alternating white and black columns frame 1
   # etc ...
-  Interleave(E, O)
+  [[Interleave]](E, O)
-  # weaves the even and odd rows of the original clips with alternating black and white columns
+  # weaves the even and odd rows of the original clips
   WeaveRows(2)
 '''Changes:'''
@@ Line 86: / Line 93: @@
 | Added WeaveColumns and WeaveRows.
 |}
 [[Category:Internal filters]]
 [[Category:Interlace_Filters]]

@@ Line 9: / Line 9: @@
 {{Template:Func2Def|WeaveColumns(clip ''clip'', int ''period'')|WeaveRows(clip ''clip'', int ''period'')}}
-WeaveColumns and WeaveRows are the opposite of [[SeparateColumns]] and [[SeparateRows]].
+WeaveColumns is the opposite of [[SeparateColumns]]: it weaves the columns of period frames into a single output frame. The number of frames of the new clip is the ceiling of 'the number of frames of the input clip divided by period'. WeaveColumns is a relatively slow filter due to the sparse pixel placing required by the algorithm. In some applications it may be faster to use [[TurnLeft]]/[[TurnRight]] with WeaveRows.
-WeaveColumns weaves ''period'' frames into a new frame as columns. The number of frames of the new clip is the number of frames of the old clip divided by ''period'' (rounded down). The width of new the frame is ''period'' times the width of the old frame.
+WeaveRows is the opposite of [[SeparateRows]]: it weaves the rows of period frames into a single output frame. The number of frames of the new clip is the ceiling of 'the number of frames of the input clip divided by period'. WeaveRows is a relatively quick filter, typically costing 1 output frame blit.
-−
-WeaveRows weaves ''period'' frames into a new frame as rows. The number of frames of the new clip is the number of frames of the old clip divided by ''period'' (rounded down). The height of new the frame is ''period'' times the height of the old frame.
 WeaveRows(2) is the same as Weave().