Plugins - Revision history

Pinterf: /* LoadVirtualDubPlugin */ Update for avs+, document rangehint

2018-07-02T11:03:52Z

‎LoadVirtualDubPlugin: Update for avs+, document rangehint

Pinterf: /* LoadVirtualDubPlugin */ avs+ new version, new interface version and vdub2 support

2018-07-02T10:57:00Z

‎LoadVirtualDubPlugin: avs+ new version, new interface version and vdub2 support

Pinterf: /* LoadVirtualDubPlugin */ Add avs+ rangehint parameter

2018-07-02T10:54:21Z

‎LoadVirtualDubPlugin: Add avs+ rangehint parameter

Raffriff42: tweak appearance

2017-04-23T09:14:44Z

tweak appearance

Raffriff42: note AVS+ differences

2017-04-23T00:55:37Z

note AVS+ differences

Raffriff42: one more touch-up

2016-03-13T17:43:59Z

one more touch-up

Raffriff42: VFAPI extension = .VFP

2016-03-13T17:03:11Z

VFAPI extension = .VFP

Raffriff42: corrected function signatures

2016-03-13T16:37:11Z

corrected function signatures

Raffriff42: /* Plugin Autoload and Conflicting Function Names */ one more touch-up

2016-03-12T18:39:49Z

‎Plugin Autoload and Conflicting Function Names: one more touch-up

Raffriff42: Advice: keep these plugins outside your autoload directory

2016-03-12T18:08:23Z

Advice: keep these plugins outside your autoload directory

@@ Line 34: / Line 34: @@
 {{FuncDef
 |LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''])
 }}
@@ Line 46: / Line 43: @@
 ::Some filters' output depends on previous frames; for these, {{FuncArg|preroll}} should be set to a suitable number.
 :{{AvsPluscon}}{{Par2|rangehint|string|""}}
-:There can be an extra filter parameter added at the end of filter's (unnamed) parameter list:<code>string ''rangehint''</code>. See "[[LoadVirtualDubPlugin]]" documentation
+:This extra filter parameter added at the end of filter's (unnamed) parameter list: <code>string ''rangehint''</code>.
-:The imported Virtualdub filters (of course which are supporting the extra features) are getting and extra named parameter to the end.
+:The imported Virtualdub filters (of course which are supporting the extra feature) are getting and extra named parameter to the end.
 :This parameter can tell the filter about a YUV-type clip colorspace info
 :Allowed values:
@@ Line 60: / Line 58: @@
 :Instead the base color space is kept and colorSpaceMode and colorRangeMode will set in PixmapLayout.formatEx.
 :Filter can either use this information or not, depending on supported API version and its implementation.
-:E.g. <code>Crossfade(20,30) -> Crossfade(20,30,"rec601")</code> though this specific filter won't use it.
+:E.g. <code>Crossfade(20,30) -> Crossfade(20,30,"rec601")</code> (a bit stupid example, just for showing the syntax because this specific filter won't use it).
-*VirtualDub filters originally support only [[RGB32]].
+*Supported color spaces and features:
-:{{AvsPluscon}} Since Avisynth+ r2724 LoadVirtualdubPlugin was updated to support newer interface versions.
+:*VirtualDub filters originally support only [[RGB32]].
 :This update changed the supported interface version from V6 to V20, and Filtermod version 6 (partial support)
 :Supported extras:
-:*VirtualDub2 support with extended colorspaces
+:VirtualDub2 support with extended colorspaces
 ::* Allow RGB24, RGB48, RGB64 besides RGB32
 ::* RGBP/RGBAP 8 bit: since this format is not supported directly by Virtualdub filters, LoadVirtualdubPlugin automatically converts 8 bit Planar RGB to/from RGB24, RGBAP to/from RGB32 (lossless)

@@ Line 62: / Line 62: @@
 :E.g. <code>Crossfade(20,30) -> Crossfade(20,30,"rec601")</code> though this specific filter won't use it.
-*VirtualDub filters support only [[RGB32]].
+*VirtualDub filters originally support only [[RGB32]].
 *Usage example ([http://trevlac.us/colorCorrection/ ColorTools]) &ndash; see [http://forum.doom9.org/showthread.php?t=72634 '''here'''] (doom9).
 *See [[FAQ_using_virtualdub_plugins|FAQ using Virtualdub plugins]] for more information.

@@ Line 35: / Line 35: @@
 |LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''])
 }}
 :{{Par2|filename|string|}}
 ::The path of the '''.VDF''' file.
@@ Line 41: / Line 45: @@
 :{{Par2|preroll|int|0}}
 ::Some filters' output depends on previous frames; for these, {{FuncArg|preroll}} should be set to a suitable number.
 *VirtualDub filters support only [[RGB32]].
 *Usage example ([http://trevlac.us/colorCorrection/ ColorTools]) &ndash; see [http://forum.doom9.org/showthread.php?t=72634 '''here'''] (doom9).
 *See [[FAQ_using_virtualdub_plugins|FAQ using Virtualdub plugins]] for more information.
 ====LoadVFAPIPlugin====

@@ Line 18: / Line 18: @@
 {{Func4Def
 |LoadCPlugin(string ''filename'')
-|LoadCPlugin(string ''filename'' [, string ''filename''...]){{AvsPluscon}}
+|LoadCPlugin(string ''filename'' [, string ''filename''...]) {{AvsPluscon}}
 |Load_Stdcall_Plugin(string ''filename'')
-|Load_Stdcall_Plugin(string ''filename'' [, string ''filename''...]){{AvsPluscon}}
+|Load_Stdcall_Plugin(string ''filename'' [, string ''filename''...]) {{AvsPluscon}}
 }}
 :{{Par2|filename|string|}}

@@ Line 16: / Line 16: @@
 Loads so-called AviSynth ''C-plugins''. C-plugins are created in pure [[wikipedia:C_(programming_language)|'''C''']] (unlike most Avisynth plugins, which are created with [[wikipedia:Visual_C%2B%2B|MS C++]]), use a special [[Filter_SDK/C_API|'''C API''']], and must be loaded with '''LoadCPlugin'''.
-{{Func2Def
+{{Func4Def
 |LoadCPlugin(string ''filename'')
 |Load_Stdcall_Plugin(string ''filename'')
 }}
 :{{Par2|filename|string|}}
-::The path of the '''.DLL''' file.
+::The path of the '''.DLL''' file(s).
 *The plugin's documentation should advise you if '''LoadCPlugin''' is needed.
 *'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.

@@ Line 54: / Line 54: @@
 :{{Par2|filtername|string|}}
 ::The name to be given to the plugin function after loading in AviSynth.
 </div>

@@ Line 45: / Line 45: @@
 ====LoadVFAPIPlugin====
-Loads [[Vfapi|VFAPI]] plugins (''eg'', [[TMPGEnc]] import plugins).
+Loads [[Vfapi|VFAPI]] plugins (''eg'', [[Importing_media#How_do_I_load_my_video_clip_into_AviSynth.3F|QTReader]], [[TMPGEnc]]). These are distributed as special DLLs with the file extension '''.VFP'''.
 {{FuncDef
@@ Line 51: / Line 51: @@
 }}
 :{{Par2|filename|string|}}
-::The path of the '''.DLL''' file.
+::The path of the '''.VFP''' file.
 :{{Par2|filtername|string|}}
 ::The name to be given to the plugin function after loading in AviSynth.
@@ Line 80: / Line 80: @@
 It follows that there is no harm in loading the same plugin more than once.{{Dubious|Talk:Plugins#Loading_same_plugin_more_than_once}}
 </div>
 ==== Plugin Autoload and Conflicting Function Names ====

@@ Line 3: / Line 3: @@
 __TOC__
-===LoadPlugin===
+====LoadPlugin====
-Loads one or more standard (C++) AviSynth plugins.
+Loads one or more [[Filter_SDK|standard (C++)]] AviSynth plugins.
-<div {{BoxWidthIndent|38|1}} >
- LoadPlugin ("filename" [, ...])
+{{FuncDef
-</div>
+|LoadPlugin(string ''filename'' [, string ''filename''...])
-*{{FuncArg|filename}} is the path of the '''.DLL''' file(s).
+}}
-===LoadCPlugin===
+====LoadCPlugin====
-Loads so-called AviSynth ''C-plugins''. C-plugins are created in pure C (unlike ordinary Avisynth plugins which are created with MS C++), use a special ''C API'', and must be loaded with '''LoadCPlugin'''.
+Loads so-called AviSynth ''C-plugins''. C-plugins are created in pure [[wikipedia:C_(programming_language)|'''C''']] (unlike most Avisynth plugins, which are created with [[wikipedia:Visual_C%2B%2B|MS C++]]), use a special [[Filter_SDK/C_API|'''C API''']], and must be loaded with '''LoadCPlugin'''.
-<div {{BoxWidthIndent|38|1}} >
- LoadCPlugin ("filename" [, ...])
+{{Func2Def
- Load_Stdcall_Plugin ("filename" [, ...])
+|LoadCPlugin(string ''filename'')
-</div>
+|Load_Stdcall_Plugin(string ''filename'')
-*{{FuncArg|filename}} is the path of the '''.DLL''' file(s).
+}}
 *The plugin's documentation should advise you if '''LoadCPlugin''' is needed.
 *'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.
@@ Line 23: / Line 27: @@
-===LoadVirtualDubPlugin ===
+====LoadVirtualDubPlugin ====
 Loads a plugin written for [[VirtualDub]]. These are distributed as special DLLs with the file extension '''.VDF'''.
-<div {{BoxWidthIndent|38|1}} >
- LoadVirtualDubPlugin ("filename", "filtername", preroll)
+{{FuncDef
-</div>
+|LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''])
-*{{FuncArg|filename}} is the path of the '''.VDF''' file.
+}}
-*{{FuncArg|filtername}} is the name given to the plugin function after loading in AviSynth.
+:{{Par2|filename|string|}}
-*Some filters' output depends on previous frames; for these, {{FuncArg|preroll}} should be set to a suitable number.
+::The path of the '''.VDF''' file.
 *VirtualDub filters support only [[RGB32]].
 *Usage example ([http://trevlac.us/colorCorrection/ ColorTools]) &ndash; see [http://forum.doom9.org/showthread.php?t=72634 '''here'''] (doom9).
@@ Line 36: / Line 44: @@
-===LoadVFAPIPlugin===
+====LoadVFAPIPlugin====
 Loads [[Vfapi|VFAPI]] plugins (''eg'', [[TMPGEnc]] import plugins).
-<div {{BoxWidthIndent|38|1}} >
- LoadVFAPIPlugin ("filename", "filtername")
+{{FuncDef
-</div>
+|LoadVFAPIPlugin (string ''filename'', string ''filtername'')
-*{{FuncArg|filename}} is the path of the '''.DLL''' file.
+}}
-*{{FuncArg|filtername}} is the name given to the plugin function after loading in AviSynth.
+:{{Par2|filename|string|}}
 *The plugin's documentation should advise you if '''LoadVFAPIPlugin''' is needed.
 </div>
-=== Plugin Autoload and Name Precedence ===
+==== Plugin Autoload and Name Precedence ====
 <div style="max-width:62em" >
 It is possible to put all plugins and script files with [[User_defined_script_functions|user-defined functions]] or (global) [[Script_variables|variables]] in an ''autoload directory'', from which all files with the extension '''.AVSI''' and '''.DLL''' are loaded [[The_script_execution_model/Sequence_of_events|at startup]], then unloaded and reloaded dynamically as the script needs them.
@@ Line 70: / Line 81: @@
 </div>
-=== Plugin Autoload and Conflicting Function Names ===
+==== Plugin Autoload and Conflicting Function Names ====
 <div style="max-width:62em" >
 A problem that may arise when multiple plugins have functions with the same name. You won't know which function will be called in your script, as this will depend on loading order. To call a particular function in this situation, AviSynth's <tt>DLLName_function()</tt> feature automatically creates ''prefix aliases''; so for example, '''foo.dll''''s <tt>bar()</tt> function may be called as <tt>foo_bar()</tt>. This works both for auto-loaded plugins and for plugins loaded with [[LoadPlugin]].

@@ Line 74: / Line 74: @@
 A problem that may arise when multiple plugins have functions with the same name. You won't know which function will be called in your script, as this will depend on loading order. To call a particular function in this situation, AviSynth's <tt>DLLName_function()</tt> feature automatically creates ''prefix aliases''; so for example, '''foo.dll''''s <tt>bar()</tt> function may be called as <tt>foo_bar()</tt>. This works both for auto-loaded plugins and for plugins loaded with [[LoadPlugin]].
-Suppose you have the plugins '''mpeg2dec.dll''' and '''mpeg2dec3.dll''' in your autoload directory;<br>
+Suppose you have the plugins '''mpeg2dec.dll''' and '''mpeg2dec3.dll''' in your autoload directory; if you call
-if you want to load a '''.d2v''' file with '''mpeg2dec.dll''' (which outputs [[YUY2]]):
+<div {{BoxWidthIndent|38|1}} >
 <div {{BoxWidthIndent|38|1}} >
   mpeg2dec_mpeg2source("F:\From_hell\from_hell.d2v")
 </div>
-or with '''mpeg2dec3.dll''' (which outputs [[YV12]]):
+or to load the file with [[External_plugins_old#Source_Filters|mpeg2dec3.dll]] (which outputs [[YV12]]), call
 <div {{BoxWidthIndent|38|1}} >
-  # using mpeg2source from [[External_plugins_old#Source_Filters|mpeg2dec3.dll]]
+  mpeg2dec{{BoldColor|blue|100|3}}_mpeg2source("F:\From_hell\from_hell.d2v")
- mpeg2dec3_mpeg2source("F:\From_hell\from_hell.d2v")
 </div>
 </div>