Plugins - Revision history

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

2018-07-02T11:03:52Z

LoadVirtualDubPlugin: Update for avs+, document rangehint

← Older revision		Revision as of 13:03, 2 July 2018
Line 34:		Line 34:
	{{FuncDef		{{FuncDef
	\|LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''])		\|LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''])
	}}
	~~<br>{{AvsPluscon}}{{FuncDef~~
	~~\|LoadVirtualDubPlugin (string ''filename'', string ''filtername'' [, int ''preroll''][, string ''rangehint''])~~
	}}		}}

Line 46:		Line 43:
	::Some filters' output depends on previous frames; for these, {{FuncArg\|preroll}} should be set to a suitable number.		::Some filters' output depends on previous frames; for these, {{FuncArg\|preroll}} should be set to a suitable number.

			Note that there is a new parameter but _not_ for use in LoadVirtualdubPlugin, but when calling the loaded VDF filter from the script.
	:{{AvsPluscon}}{{Par2\|rangehint\|string\|""}}		:{{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		:This parameter can tell the filter about a YUV-type clip colorspace info
	:Allowed values:		:Allowed values:
Line 60:		Line 58:
	:Instead the base color space is kept and colorSpaceMode and colorRangeMode will set in PixmapLayout.formatEx.		: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.		: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]].
			:*{{AvsPluscon}} Since Avisynth+ r2724 LoadVirtualdubPlugin was updated to support newer interface versions.
	:This update changed the supported interface version from V6 to V20, and Filtermod version 6 (partial support)		:This update changed the supported interface version from V6 to V20, and Filtermod version 6 (partial support)
	:Supported extras:		:Supported extras:
	:*VirtualDub2 support with extended colorspaces		:VirtualDub2 support with extended colorspaces
	::* Allow RGB24, RGB48, RGB64 besides RGB32		::* 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)		::* 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)

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

@@ 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.

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

2018-07-02T10:54:21Z

LoadVirtualDubPlugin: Add avs+ rangehint parameter

@@ 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====

Raffriff42: tweak appearance

2017-04-23T09:14:44Z

tweak appearance

← Older revision		Revision as of 11:14, 23 April 2017
Line 18:		Line 18:
	{{Func4Def		{{Func4Def
	\|LoadCPlugin(string ''filename'')		\|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'')
	\|Load_Stdcall_Plugin(string ''filename'' [, string ''filename''...]){{AvsPluscon}}		\|Load_Stdcall_Plugin(string ''filename'' [, string ''filename''...]) {{AvsPluscon}}
	}}		}}
	:{{Par2\|filename\|string\|}}		:{{Par2\|filename\|string\|}}

Raffriff42: note AVS+ differences

2017-04-23T00:55:37Z

note AVS+ differences

← Older revision		Revision as of 02:55, 23 April 2017
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'''.		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'')		\|LoadCPlugin(string ''filename'')
			\|LoadCPlugin(string ''filename'' [, string ''filename''...]){{AvsPluscon}}
	\|Load_Stdcall_Plugin(string ''filename'')		\|Load_Stdcall_Plugin(string ''filename'')
			\|Load_Stdcall_Plugin(string ''filename'' [, string ''filename''...]){{AvsPluscon}}
	}}		}}
	:{{Par2\|filename\|string\|}}		:{{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.		*The plugin's documentation should advise you if '''LoadCPlugin''' is needed.
	*'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.		*'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.

Raffriff42: one more touch-up

2016-03-13T17:43:59Z

one more touch-up

← Older revision		Revision as of 19:43, 13 March 2016
Line 54:		Line 54:
	:{{Par2\|filtername\|string\|}}		:{{Par2\|filtername\|string\|}}
	::The name to be given to the plugin function after loading in AviSynth.		::The name to be given to the plugin function after loading in AviSynth.
	*The plugin's documentation should advise you if '''LoadVFAPIPlugin''' is needed.
	</div>		</div>

Raffriff42: VFAPI extension = .VFP

2016-03-13T17:03:11Z

VFAPI extension = .VFP

← Older revision		Revision as of 19:03, 13 March 2016
Line 45:		Line 45:

	====LoadVFAPIPlugin====		====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		{{FuncDef
Line 51:		Line 51:
	}}		}}
	:{{Par2\|filename\|string\|}}		:{{Par2\|filename\|string\|}}
	::The path of the '''.~~DLL~~''' file.		::The path of the '''.VFP''' file.
	:{{Par2\|filtername\|string\|}}		:{{Par2\|filtername\|string\|}}
	::The name to be given to the plugin function after loading in AviSynth.		::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}}		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>		</div>


	==== Plugin Autoload and Conflicting Function Names ====		==== Plugin Autoload and Conflicting Function Names ====

Raffriff42: corrected function signatures

2016-03-13T16:37:11Z

corrected function signatures

← Older revision		Revision as of 18:37, 13 March 2016
Line 3:		Line 3:
	__TOC__		__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).		}}
			:{{Par2\|filename\|string\|}}
			::The path of the '''.DLL''' file(s).


			====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'''.

	~~===~~LoadCPlugin~~===~~		{{Func2Def
	~~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'''.~~		\|LoadCPlugin(string ''filename'')
	~~<div {{BoxWidthIndent\|38\|1~~}} >		\|Load_Stdcall_Plugin(string ''filename'')
	~~LoadCPlugin ("filename" [, ...])~~		}}
	~~Load_Stdcall_Plugin ("filename" [, ...])~~		:{{Par2\|filename\|string\|}}
	~~</div>~~		::The path of the '''.DLL''' file.
	*{{~~FuncArg~~\|filename}} ~~is the~~ path of the '''.DLL''' file~~(s)~~.
	*The plugin's documentation should advise you if '''LoadCPlugin''' is needed.		*The plugin's documentation should advise you if '''LoadCPlugin''' is needed.
	*'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.		*'''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'''.		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.
			:{{Par2\|filtername\|string\|}}
			::The name to be given to the plugin function after loading in AviSynth.
			:{{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]].		*VirtualDub filters support only [[RGB32]].
	*Usage example ([http://trevlac.us/colorCorrection/ ColorTools]) – see [http://forum.doom9.org/showthread.php?t=72634 '''here'''] (doom9).		*Usage example ([http://trevlac.us/colorCorrection/ ColorTools]) – 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).		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 path of the '''.DLL''' file.
			:{{Par2\|filtername\|string\|}}
			::The name to be given to the plugin function after loading in AviSynth.
	*The plugin's documentation should advise you if '''LoadVFAPIPlugin''' is needed.		*The plugin's documentation should advise you if '''LoadVFAPIPlugin''' is needed.
	</div>		</div>


	=== Plugin Autoload and Name Precedence ===		==== Plugin Autoload and Name Precedence ====
	<div style="max-width:62em" >		<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.		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>		</div>

	=== Plugin Autoload and Conflicting Function Names ===		==== Plugin Autoload and Conflicting Function Names ====
	<div style="max-width:62em" >		<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]].		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]].

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

← Older revision		Revision as of 20:39, 12 March 2016
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]].		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}} >
			mpeg2source("F:\From_hell\from_hell.d2v")
			</div>
			you won't know which plugin will be used in your script, as both have an <tt>mpeg2source</tt> function.

			To load the file with [[External_plugins_old#Source_Filters\|mpeg2dec.dll]] (which outputs [[YUY2]]), call
	<div {{BoxWidthIndent\|38\|1}} >		<div {{BoxWidthIndent\|38\|1}} >
	~~# using mpeg2source from [[External_plugins_old#Source_Filters\|mpeg2dec.dll]]~~
	mpeg2dec_mpeg2source("F:\From_hell\from_hell.d2v")		mpeg2dec_mpeg2source("F:\From_hell\from_hell.d2v")
	</div>		</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}} >		<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>
	</div>		</div>

Raffriff42: Advice: keep these plugins outside your autoload directory

2016-03-12T18:08:23Z

Advice: keep these plugins outside your autoload directory

← Older revision		Revision as of 20:08, 12 March 2016
Line 18:		Line 18:
	</div>		</div>
	*{{FuncArg\|filename}} is the path of the '''.DLL''' file(s).		*{{FuncArg\|filename}} is the path of the '''.DLL''' file(s).
	*The plugin's documentation should advise you if '''LoadCPlugin''' is needed.~~<br>~~		*The plugin's documentation should advise you if '''LoadCPlugin''' is needed.
	*'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.		*'''Load_Stdcall_Plugin''' is merely an ''alias'' or alternate name.
			*Advice: keep these plugins outside your [[#Plugin Autoload and Name Precedence\|autoload directory]] to prevent crashes.