ConditionalFilter - Revision history

Pinterf: /* Runtime Functions */

2021-11-28T18:28:03Z

‎Runtime Functions

Pinterf: /* Changelog */

2021-11-25T21:44:18Z

‎Changelog

Pinterf: /* Runtime Functions */ Add 'offset' parameter, add PlaneMinMaxStats

2021-11-25T21:37:18Z

‎Runtime Functions: Add 'offset' parameter, add PlaneMinMaxStats

Pinterf: /* ScriptClip */ New example

2021-11-25T21:20:34Z

‎ScriptClip: New example

Pinterf: /* ScriptClip */ Examples on function-like syntax, variable visibility, and after_frame

2021-11-25T16:01:37Z

‎ScriptClip: Examples on function-like syntax, variable visibility, and after_frame

Pinterf: /* ScriptClip */ add avs+ syntax (function)

2021-11-24T11:15:27Z

‎ScriptClip: add avs+ syntax (function)

Pinterf: /* ScriptClip */ Avisynth+ additions

2021-11-19T07:21:46Z

‎ScriptClip: Avisynth+ additions

Pinterf: /* ConditionalFilter */ Shorter alternative format for Avs+

2019-04-08T11:48:10Z

‎ConditionalFilter: Shorter alternative format for Avs+

Raffriff42: one more touch-up

2016-02-28T01:39:51Z

one more touch-up

Admin at 21:04, 7 January 2016

2016-01-07T21:04:46Z

@@ Line 319: / Line 319: @@
 :int 'plane' (default 0): 0, 1, 2 or 3
 ::for YUV inputs they mean Y=0,U=1,V=2,A=3 planes
-::for RGB inputs R=0,G=0,B=0 and A=3 planes
+::for RGB inputs R=0,G=1,B=2 and A=3 planes
 :bool 'setvar' (default false):
 ::when true then it writes a global variables named "PlaneStats_min" "PlaneStats_max" "PlaneStats_thmin" "PlaneStats_thmax" "PlaneStats_median"
 Note: using global variables are thread safe from ScriptClip only when used with 'function'-syntax call with its default 'local'=true

@@ Line 628: / Line 628: @@
 {|border=1 cellspacing=1 cellpadding=4
   | v2.60
   | Added ConditionalSelect.

@@ Line 247: / Line 247: @@
 These are the internal functions which are evaluated every frame.
-These will return the average pixel value of a plane (requires ISSE):
+These will return the average pixel value of a plane:
 :<tt>AverageLuma(clip)</tt>
 :<tt>AverageChromaU(clip)</tt>
 :<tt>AverageChromaV(clip)</tt>
-These return a float value between 0 and 255 of the absolute difference between two planes (requires ISSE): :<tt>RGBDifference(clip1, clip2)</tt>
+These return a float value between 0 and 255 of the absolute difference between two planes:
 :<tt>LumaDifference(clip1, clip2)</tt>
 :<tt>ChromaUDifference(clip1, clip2)</tt>
 :<tt>ChromaVDifference(clip1, clip2)</tt>
 When using these functions there is an "implicit last" clip (first parameter doesn't have to be specified), so the first parameter is replaced by the testclip.
@@ Line 264: / Line 272: @@
 :<tt>UDifferenceFromPrevious(clip)</tt>
 :<tt>VDifferenceFromPrevious(clip)</tt>
-:<tt>RGBDifferenceToNext(clip)</tt>
+:<tt>{{AvsPluscon}}RDifferenceFromPrevious(clip)</tt>
-:<tt>YDifferenceToNext(clip)</tt>
+:<tt>{{AvsPluscon}}GDifferenceFromPrevious(clip)</tt>
-:<tt>UDifferenceToNext(clip)</tt>
+:<tt>{{AvsPluscon}}BDifferenceFromPrevious(clip)</tt>
-:<tt>VDifferenceToNext(clip)</tt>
+:<tt>RGBDifferenceToNext(clip, int offset)</tt>
 This will replace the last frame before a scene change with the first frame after the scene change:
@@ Line 276: / Line 291: @@
 Other internal functions:
-:<tt>YPlaneMax(clip, float threshold)</tt>
+:<tt>{{AvsPluscon}}PlaneMinMaxStats(clip, float threshold, int offset, int plane, bool setvar)</tt>
-:<tt>UPlaneMax(clip, float threshold)</tt>
+:<tt>YPlaneMax(clip, float threshold, int offset)</tt>
-:<tt>VPlaneMax(clip, float threshold)</tt>
+:<tt>UPlaneMax(clip, float threshold, int offset)</tt>
-:<tt>YPlaneMin(clip, float threshold)</tt>
+:<tt>VPlaneMax(clip, float threshold, int offset)</tt>
-:<tt>UPlaneMin(clip, float threshold)</tt>
+:<tt>YPlaneMin(clip, float threshold, int offset)</tt>
-:<tt>VPlaneMin(clip, float threshold)</tt>
+:<tt>UPlaneMin(clip, float threshold, int offset)</tt>
-:<tt>YPlaneMedian(clip)</tt>
+:<tt>VPlaneMin(clip, float threshold, int offset)</tt>
-:<tt>UPlaneMedian(clip)</tt>
+:<tt>YPlaneMedian(clip, int offset)</tt>
-:<tt>VPlaneMedian(clip)</tt>
+:<tt>UPlaneMedian(clip, int offset)</tt>
-:<tt>YPlaneMinMaxDifference(clip, float threshold)</tt>
+:<tt>VPlaneMedian(clip, int offset)</tt>
-:<tt>UPlaneMinMaxDifference(clip, float threshold)</tt>
+:<tt>YPlaneMinMaxDifference(clip, float threshold, int offset)</tt>
-:<tt>VPlaneMinMaxDifference(clip, float threshold)</tt>
+:<tt>UPlaneMinMaxDifference(clip, float threshold, int offset)</tt>
 Threshold is a percentage, on how many percent of the pixels are allowed above or below minimum. The threshold is optional and defaults to 0.
 If you understand the stuff above, you can proceed with "advanced conditional filtering", which tells you a little bit more about conditional filtering.
 </div>
 == Advanced conditional filtering: part I ==

@@ Line 141: / Line 141: @@
    ColorbarsHD()
    Expr("frameno","","") # luma is 0..255 for the first 256 frames.
-   # A global variable which ShowChannel is overwriting in each frame
+   # A global variable which ShowChannels is overwriting in each frame
    global SC_LMn_0 = 2
    # ShowChannels (an external filter) sets some global variables
@@ Line 173: / Line 173: @@
+   }
 </div>
-Function-like syntax: example on local=false
+Function-like syntax: example on local=true<br>
 <div {{BoxWidthIndent|100|1}}>
-   # local=true -> new GlobalVar frame is created, 'current_frame' and 'last' is created in it, they are visible
+  ColorbarsHD()
    ScriptClip( function [] (c) {c.subtitle(string(current_frame) ) } , local = true)
 </div>
-Function-like syntax: example on local=true
+Example: function-like syntax with local=false
 <div {{BoxWidthIndent|100|1}}>
    # Error: "I don't know what 'current_frame' means.

@@ Line 127: / Line 127: @@
        foo = 3
        last
 </div>
@@ Line 133: / Line 132: @@
 * ConditionalSelect, ConditionalFilter, ScriptClip, ConditionalReader, FrameEvaluate, WriteFile, WriteFileIf, WriteFileStart, WriteFileEnd
-If local=true the filter will evaluate its run-time script in a new variable scope, avoiding unintended sharing of variables between run-time scripts.
+If local=true (function-syntax default) the filter will evaluate its run-time script in a new variable scope (opens a new global variable frame), avoiding unintended sharing of variables between run-time scripts.
-In our present Avisynth+ all runtime filters are compatible with the usual behaviour, but one can set the other mode by "local=true" parameter. This is when script is passed as string
+In our present Avisynth+ all runtime filters are compatible with the usual behaviour, but one can set the other mode by "local=true" parameter.
 As a memo, ConditionalFilter still has the GRunT-like "shortcut" style parameter for bool results which implies "=" and "true" and parameter "condvarsuffix" for ConditionalReader)

@@ Line 58: / Line 58: @@
 <div style="max-width:62em" >
 {{FuncDef
-|ScriptClip(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'', {{AvsPluscon}} bool ''local'']
+|ScriptClip(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'', {{AvsPluscon}} bool ''local'']<br>
 )}}

@@ Line 4: / Line 4: @@
 {{FuncDef
 |ConditionalFilter(clip ''testclip'', clip ''source1'', clip ''source2'', string ''expression1'', string ''operator'', string ''expression2'' [, bool ''show'']
 )}}
 '''ConditionalFilter''' returns {{FuncArg|source1}} when the condition formed by ''expression1+operator+expression2'' is met for current frame, otherwise it returns {{FuncArg|source2}}. If any function in {{FuncArg|expression1}} or {{FuncArg|expression2}} is not explicitly applied to a clip, it will be applied on {{FuncArg|testclip}}. The audio is taken from {{FuncArg|source1}}.
 An example: this will choose frames from vid_blur when the average luma value of a frame is less than 20. Otherwise frames from vid will be returned.
@@ Line 23: / Line 29: @@
 :* "equals", "=" or "=="
 </div>
 == ConditionalSelect ==

@@ Line 1: / Line 1: @@
-<!-- {{Template:Func5Def
-|ConditionalFilter(clip ''testclip'', clip ''source1'', clip ''source2'', string ''expression1'', string ''operator'', string ''expression2'' [, bool ''show'']
-−
-|ConditionalSelect(clip ''testclip'', string ''expression'', clip ''source0'' [, clip ''source1''...] [, bool ''show'']
-−
-|ScriptClip(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'']
-−
-|FrameEvaluate(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'']
-−
-|ConditionalReader(clip ''clip'', string ''filename'', string ''variablename'' [, bool ''show'']
-)}} -->
 == ConditionalFilter ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |ConditionalFilter(clip ''testclip'', clip ''source1'', clip ''source2'', string ''expression1'', string ''operator'', string ''expression2'' [, bool ''show'']
 )}}
@@ Line 32: / Line 22: @@
 :* "lessthan" or "<"
 :* "equals", "=" or "=="
 == ConditionalSelect ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |ConditionalSelect(clip ''testclip'', string ''expression'', clip ''source0'' [, clip ''source1''...] [, bool ''show'']
 )}}
@@ Line 56: / Line 47: @@
 Audio from {{FuncArg|testclip}} is passed through untouched.
 == ScriptClip ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |ScriptClip(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'']
 )}}
@@ Line 101: / Line 93: @@
 '''Restrictions''' - the output of the script MUST be exactly like the clip delivered to ScriptClip (same colorspace, width and height). Your returned clip is allowed to have different length - but the length from {{FuncArg|clip}} is always used. Audio from {{FuncArg|clip}} is passed through untouched. For two very different sources (MPEG2DEC3 and AviSource) - you might run into colorspace mismatches. This is a known quirk.
 == FrameEvaluate ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |FrameEvaluate(clip ''clip'', string ''filter'' [, bool ''show'', bool ''after_frame'']
 )}}
@@ Line 112: / Line 105: @@
 If {{FuncArg|after_frame}}=true, the script should be evaluated after the frame has been fetched from the filters above. Default is false.
 == ConditionalReader ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |ConditionalReader(clip ''clip'', string ''filename'', string ''variablename'' [, bool ''show'']
 )}}
@@ Line 123: / Line 117: @@
 See the dedicated [[ConditionalReader]] page.
 == Runtime Functions ==
+<div style="max-width:62em" >
 These are the internal functions which are evaluated every frame.
@@ Line 174: / Line 169: @@
 If you understand the stuff above, you can proceed with "advanced conditional filtering", which tells you a little bit more about conditional filtering.
 == Advanced conditional filtering: part I ==
+<div style="max-width:62em" >
 You will have to know a few things about the functionality of AviSynth to understand this section:
 Scripts are parsed from top to bottom, but when a frame is requested the last filter is actually being invoked first, requesting frames upwards in
@@ Line 264: / Line 260: @@
 </div>
 In the following section an example of "adaptive motion/resizing filter" will be considered.
 == Advanced conditional filtering: part II ==
+<div style="max-width:62em" >
 In the following example, some frame dependent info will be written to a text-file. The first variable "a" indicates whether the frame is combed (for a certain threshold). Note that IsCombed is a filter from the Decomb plugin. The second variable "b" indicates whether there is "much" movement in the frame.
 <div {{BoxWidthIndent|50|1}}>
@@ Line 319: / Line 316: @@
    return c
+  }
 </div>
 Some adaptive motion/resizing filters appeared on the forums. These filters discriminate between low, medium and high motion in a clip (on frame basis). By doing that, different filters can be used for different kind of motion in the clip. In general, one should use temporal smoothing in low motion scenes, spatial smoothing in high motion scenes and use spatio-temporal smoothing in medium motion scenes.
@@ Line 465: / Line 464: @@
 A few details were omitted, but this is how the [http://forum.doom9.org/showthread.php?p=450522#post450522 script] basically works.

@@ Line 40: / Line 40: @@
 )}}
-'''ConditionalSelect''' returns each one frame from several source clips based on an integer evaluator. If the expression evaluates to the integer ''j'' (starting at zero), the frame from the ''j''-th source clip is returned. {{FuncArg|source0..n}} can be an array of clips.
+'''ConditionalSelect''' returns each one frame from several source clips based on an integer evaluator. If the expression evaluates to the integer ''j'' (starting at zero), the frame from the ''j''-th source clip is returned. {{FuncArg|source0, ..., sourcen}} can be an array of clips.
 This will return a frame from ''vid_blur2'' when the average luma value of a frame (of ''vid'') is less than 15, will return a frame from ''vid_blur'' when the average luma value of a frame (of ''vid'') is higher than 15 but smaller than 25. Otherwise a frame from ''vid'' will be returned.
@@ Line 472: / Line 472: @@
   | v2.60
   | Added ConditionalSelect.
   |}