Fade - Revision history

Reel.Deal at 05:32, 18 September 2022

2022-09-18T05:32:19Z

Reel.Deal: add link to avs+ documentation

2022-09-16T18:32:16Z

add link to avs+ documentation

Raffriff42: formatting, links, phrasing

2016-02-14T23:33:30Z

formatting, links, phrasing

Raffriff42: added category

2015-11-08T14:33:42Z

added category

Admin: 1 revision

2013-05-09T15:02:24Z

1 revision

Vdcrim: "color" and "fps" are optional parameters

2013-02-26T02:38:41Z

"color" and "fps" are optional parameters

New page

{{Template:Func3Def|FadeIn(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}

{{Template:Func3Def|FadeIn0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}

{{Template:Func3Def|FadeIn2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}

FadeOut and FadeOut2 cause the video stream to fade linearly to black or the specified RGB color at the end. Similarly FadeIn and FadeIn2 cause the video stream to fade linearly to black or the specified RGB color at the start when watching the clip backwards. FadeIO and FadeIO2 are a combination of their respective FadeIn and FadeOut functions. The sound track (if present) also fades linearly to or from silence. The fading affects only the last ''num_frames'' frames of the video. The last frame of the video becomes almost-but-not-quite black (or the specified color). An additional perfectly black (or the specified color) frame is added at the end, thus increasing the total frame count by one.

FadeOut2 works similarly, except that two black (or color) frames are added at the end instead of one. The only purpose of this is to work around a bug in Windows Media Player. All the WMP versions that I've tested fail to play the last frame of an MPEG file--instead, they stop on the next-to-last frame when playback ends. This leaves an unsightly almost-but-not-quite-black frame showing on the screen when the movie ends if you use FadeOut. FadeOut2 avoids this problem.

The ''color'' parameter is optional, default=0 <black>, and is specified as an RGB value regardless of whether the clip format is RGB or YUV based. See [[Colors]] (...) for more information on specifying colors.

The ''fps'' parameter is optional, default=24.0, and provides a reference for num_frames in audio only clips. It is ignored if a video stream is present. Set fps=AudioRate() if sample exact audio positioning is required.

FadeOut(''clip, n'') is just a shorthand for [[Dissolve]](''clip'', [[Blackness]](''clip, n+1'',color=''color''), ''n'') (or ''n+2'' instead of ''n+1'' for FadeOut2 and n for FadeOut0).

'''Changes:'''
{| border="1"
|-
| v2.56
| FadeIn0/FadeIO0 /FadeOut0 commands are added and the fps parameter is added to all fade functions.
|-
| v2.07
| Added FadeIO/FadeIO2 commands. Added color parameter to all fade functions.
|-
| v2.06
| Till v2.06 the FadeIn/FadeIn2 commands do not exist, but you can get the same effect by reversing the arguments to Dissolve: Dissolve(Blackness(''clip, n+1'', color=''color''), ''clip, n'').
|}

[[Category:Internal filters]]

@@ Line 3: / Line 3: @@
 Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/fade.html https://avisynthplus.readthedocs.io]
 </div>
 {| border="0"

← Older revision		Revision as of 18:32, 16 September 2022
Line 1:		Line 1:
		+	<div {{BlueBox2\|40\|0\|3px solid purple}} >
		+	{{AvsPlusFullname}}<br>
		+	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/fade.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
	{\| border="0"		{\| border="0"
	\|-		\|-

← Older revision		Revision as of 14:33, 8 November 2015
Line 30:		Line 30:

	[[Category:Internal filters]]		[[Category:Internal filters]]
		+	[[Category:Timeline_editing_filters]]

@@ Line 1: / Line 1: @@
-{{Template:Func3Def|FadeIn(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}
+{| border="0"
-{{Template:Func3Def|FadeIn0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut0(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}
+:{{Par2|clip|clip|}}
-{{Template:Func3Def|FadeIn2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeIO2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])|FadeOut2(clip ''clip'', int ''num_frames'' [, int ''color''] [, float ''fps''])}}
+:{{Par2|num_frames|int|}}
-FadeOut and FadeOut2 cause the video stream to fade linearly to black or the specified RGB color at the end. Similarly FadeIn and FadeIn2 cause the video stream to fade linearly to black or the specified RGB color at the start when watching the clip backwards. FadeIO and FadeIO2 are a combination of their respective FadeIn and FadeOut functions. The sound track (if present) also fades linearly to or from silence. The fading affects only the last ''num_frames'' frames of the video. The last frame of the video becomes almost-but-not-quite black (or the specified color). An additional perfectly black (or the specified color) frame is added at the end, thus increasing the total frame count by one.
+:{{Par2|color|int|$000000}}
-FadeOut2 works similarly, except that two black (or color) frames are added at the end instead of one. The only purpose of this is to work around a bug in Windows Media Player. All the WMP versions that I've tested fail to play the last frame of an MPEG file--instead, they stop on the next-to-last frame when playback ends. This leaves an unsightly almost-but-not-quite-black frame showing on the screen when the movie ends if you use FadeOut. FadeOut2 avoids this problem.
+:{{Par2|fps|float|24.0}}
-The ''fps'' parameter is optional, default=24.0, and provides a reference for num_frames in audio only clips. It is ignored if a video stream is present. Set fps=AudioRate() if sample exact audio positioning is required.
+== Notes ==
-'''Changes:'''
+== Changes ==
 {| border="1"
 |-
@@ Line 27: / Line 91: @@
 | Till v2.06 the FadeIn/FadeIn2 commands do not exist, but you can get the same effect by reversing the arguments to Dissolve: Dissolve(Blackness(''clip, n+1'', color=''color''), ''clip, n'').
 |}
 [[Category:Internal filters]]
 [[Category:Timeline_editing_filters]]