FPS - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T03:41:53Z

add link to avs+ documentation

← Older revision		Revision as of 05:41, 18 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/fps.html https://avisynthplus.readthedocs.io]
			</div>


	A set of functions to change the frame rate of a clip.		A set of functions to change the frame rate of a clip.

Raffriff42: one more touch-up

2016-03-10T02:17:14Z

one more touch-up

← Older revision		Revision as of 04:17, 10 March 2016
Line 4:		Line 4:
	== AssumeFPS ==		== AssumeFPS ==
	<div style="max-width:62em" >		<div style="max-width:62em" >
	Changes the frame rate without changing the frame count, causing the video to play faster or slower.		Changes the frame ''rate'' without changing the frame ''count'', causing the video to play faster or slower.

	{{~~Func4Def~~		{{Func2Def
	\|AssumeFPS(clip ''clip'', float ''fps'' [, bool ''sync_audio''])		\|AssumeFPS(clip ''clip'', float ''fps'' [, bool ''sync_audio''])
	\|AssumeFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', bool ''sync_audio''])		\|AssumeFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', bool ''sync_audio''])
			}}

			{{Func2Def
	\|AssumeFPS(clip ''clip1'', clip ''clip2'' [, bool ''sync_audio''])		\|AssumeFPS(clip ''clip1'', clip ''clip2'' [, bool ''sync_audio''])
	\|AssumeFPS(clip ''clip1'', string ''preset'' [, bool ''sync_audio''])		\|AssumeFPS(clip ''clip1'', string ''preset'' [, bool ''sync_audio''])
Line 18:		Line 21:
	{{Par2\|fps\|float\|}}		{{Par2\|fps\|float\|}}
	:If supplied, the new framerate is set to {{FuncArg\|fps}}.		:If supplied, the new framerate is set to {{FuncArg\|fps}}.
	:*Due to the way frame rates are stored, {{FuncArg\|fps}} must be converted to the closest ratio of 32-bit signed integers,		:Due to the way frame rates are stored, {{FuncArg\|fps}} must be converted to the closest ratio of 32-bit signed integers,
	::eg, 33.3333 → 329833/9895 (33.3332996)		:eg, 33.3333 → 329833/9895 (33.3332996)

	{{Par2\|numerator\|int\|}}		{{Par2\|numerator\|int\|}}
Line 184:		Line 187:
	The audio data are not touched by this filter. Audio will remain synchronized, although the length of the audio data may slightly differ from that of the video data after the conversion. This is because the output can only contain an integer number of frames. This effect will be more pronounced for shorter clips. The difference in length can be ignored.		The audio data are not touched by this filter. Audio will remain synchronized, although the length of the audio data may slightly differ from that of the video data after the conversion. This is because the output can only contain an integer number of frames. This effect will be more pronounced for shorter clips. The difference in length can be ignored.

	{{~~Func4Def~~		{{Func2Def
	\|ChangeFPS(clip ''clip'', float ''fps'' [, bool ''linear''])		\|ChangeFPS(clip ''clip'', float ''fps'' [, bool ''linear''])
	\|ChangeFPS(clip ''clip'', int ''numerator'' [, int ''denominator'', bool ''linear''])		\|ChangeFPS(clip ''clip'', int ''numerator'' [, int ''denominator'', bool ''linear''])
			}}

			{{Func2Def
	\|ChangeFPS(clip ''clip1'', clip ''clip2'', bool ''linear'')		\|ChangeFPS(clip ''clip1'', clip ''clip2'', bool ''linear'')
	\|ChangeFPS(clip ''clip1'', string ''preset'' [, bool ''linear''])		\|ChangeFPS(clip ''clip1'', string ''preset'' [, bool ''linear''])
Line 196:		Line 202:
	{{Par2\|fps\|float\|}}		{{Par2\|fps\|float\|}}
	:If supplied, the new framerate is set to {{FuncArg\|fps}}.		:If supplied, the new framerate is set to {{FuncArg\|fps}}.
	:*Due to the way frame rates are stored, {{FuncArg\|fps}} must be converted to the closest ratio of 32-bit signed integers,		:Due to the way frame rates are stored, {{FuncArg\|fps}} must be converted to the closest ratio of 32-bit signed integers,
	::eg, 33.3333 → 329833/9895 (33.3332996)		:eg, 33.3333 → 329833/9895 (33.3332996)

	{{Par2\|numerator\|int\|}}		{{Par2\|numerator\|int\|}}
Line 248:		Line 254:
	Not all parameter values are checked for sanity.		Not all parameter values are checked for sanity.

	{{~~Func4Def~~		{{Func2Def
	\|ConvertFPS(clip ''clip'', float ''new_rate'' [, int ''zone'', int ''vbi''])		\|ConvertFPS(clip ''clip'', float ''new_rate'' [, int ''zone'', int ''vbi''])
	\|ConvertFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', int ''zone'', int ''vbi''])		\|ConvertFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', int ''zone'', int ''vbi''])
			}}

			{{Func2Def
	\|ConvertFPS(clip ''clip1'', clip ''clip2'' [, int ''zone'', int ''vbi''])		\|ConvertFPS(clip ''clip1'', clip ''clip2'' [, int ''zone'', int ''vbi''])
	\|ConvertFPS(clip ''clip1'', string ''preset'' [, int ''zone'', int ''vbi''])		\|ConvertFPS(clip ''clip1'', string ''preset'' [, int ''zone'', int ''vbi''])
Line 256:		Line 265:

	{{Par2\|new_rate\|float\|}}		{{Par2\|new_rate\|float\|}}
	:Target frame rate. Can be integer or floating point number. In ''Blend ''mode, new_rate must be at least 2/3 (66.7%) of the source frame rate, or an error will occur. This is to prevent frame skipping. If you need to slow down the frame rate more than that, use ''Switch ''mode.		:Target frame rate. Can be integer or floating point number.
			:In ''Blend ''mode, new_rate must be at least 2/3 (66.7%) of the source frame rate, or an error will occur. This is to prevent frame skipping. If you need to slow down the frame rate more than that, use ''Switch ''mode.
			:Due to the way frame rates are stored, {{FuncArg\|new_rate}} must be converted to the closest ratio of 32-bit signed integers,
			:eg, 33.3333 → 329833/9895 (33.3332996)

			{{Par2\|numerator\|int\|}}
			{{Par2\|denominator\|int\|1}}
			:If supplied, the new framerate is set to {{FuncArg\|numerator}} divided by {{FuncArg\|denominator}}. The same restrictions apply as for {{FuncArg\|new_rate}}.

			{{Par2\|clip2\|clip\|}}
			:If supplied, the new framerate is taken from {{FuncArg\|clip2}}.

			{{Par2\|preset\|string\|}}
			:If supplied, the new framerate is taken from a set of standard rates, as listed under [[#AssumeFPS\|AssumeFPS]].

	{{Par2\|zone\|int\|}}		{{Par2\|zone\|int\|}}

Raffriff42: one more touch-up

2016-02-27T23:20:07Z

one more touch-up

Show changes

Admin: /* ConvertFPS */

2016-01-14T22:04:36Z

ConvertFPS

← Older revision		Revision as of 00:04, 15 January 2016
Line 235:		Line 235:
	Footage converted with this filter should not be converted again. Blurriness builds up quickly in subsequent generations.		Footage converted with this filter should not be converted again. Blurriness builds up quickly in subsequent generations.

	The audio data ~~are~~ not touched by this filter. Audio will remain synchronized, although the length of the audio data may slightly differ from that of the video data after the conversion. This is because the output can only contain an integer number of frames. This effect will be more pronounced for shorter clips. The difference in length should be ignored.		The audio data is not touched by this filter. Audio will remain synchronized, although the length of the audio data may slightly differ from that of the video data after the conversion. This is because the output can only contain an integer number of frames. This effect will be more pronounced for shorter clips. The difference in length should be ignored.

	Not all parameter values are checked for sanity.		Not all parameter values are checked for sanity.

Raffriff42: /* ChangeFPS */ - copy "The audio data are not touched by this filter..." from ConvertFPS

2016-01-14T12:43:12Z

ChangeFPS: - copy "The audio data are not touched by this filter..." from ConvertFPS

← Older revision		Revision as of 14:43, 14 January 2016
Line 177:		Line 177:

	Changes the frame rate by deleting or duplicating frames.		Changes the frame rate by deleting or duplicating frames.

			The audio data are not touched by this filter. Audio will remain synchronized, although the length of the audio data may slightly differ from that of the video data after the conversion. This is because the output can only contain an integer number of frames. This effect will be more pronounced for shorter clips. The difference in length should be ignored.

	=====Parameters=====		=====Parameters=====

Raffriff42: formatting, add internal links in examples

2016-01-14T12:21:59Z

formatting, add internal links in examples

← Older revision		Revision as of 14:21, 14 January 2016
Line 106:		Line 106:

	*PAL +4% conversion:		*PAL +4% conversion:
			<div {{BoxWidthIndent\|62\|1}} >
	~~AVISource~~("FILM_clip.avi") # Get 24fps clip		[[AviSource]]("FILM_clip.avi") # Get 24fps clip
	LanczosResize(768, 576) # Resize to PAL square-pixel frame size.		[[LanczosResize]](768, 576) # Resize to PAL square-pixel frame size.
	AssumeFPS(25, 1, true) # Convert frame rate to PAL, also adjust audio.		AssumeFPS(25, 1, true) # Convert frame rate to PAL, also adjust audio.
	SSRC(44100) # ~~Restore~~ audio ~~sample rate~~ to a standard rate.		[[SSRC]](44100) # Resample audio, restoring it to a standard rate.
			</div>
	The +4% speed up is conventionally used for displaying 24fps film on PAL television. The slight increase in pitch and tempo is readily accepted by viewers of PAL material.		:The +4% speed up is conventionally used for displaying 24fps film on PAL television. <br>
			:The slight increase in pitch and tempo is readily accepted by viewers of PAL material.

	*Slowing down of video (framerate of original video is 30 frames a second):		*Slowing down of video (framerate of original video is 30 frames a second):
			<div {{BoxWidthIndent\|62\|1}} >
	AviSource("video.avi").AssumeFPS(10, true) # Slows the video down to a third of its speed		AviSource("video.avi")
			AssumeFPS(10, true) # Slows the video down to a third of its speed
			</div>

	*Speeding up of video (framerate of original video is 30 frames a second):		*Speeding up of video (framerate of original video is 30 frames a second):
			<div {{BoxWidthIndent\|62\|1}} >
	AviSource("video.avi").AssumeFPS(60, true) # Double speed		[[AviSource]]("video.avi")
			AssumeFPS(60, true) # Double speed
			</div>

	*''sync_audio'' experiments:		*''sync_audio'' experiments:
			<div {{BoxWidthIndent\|62\|1}} >
	[[ColorBars]] ## 29.97 fps		[[ColorBars]] ## 29.97 fps
	[[Trim]](0, 299) ## ''vdur'' (video duration) = 10.01 sec		[[Trim]](0, 299) ## ''vdur'' (video duration) = 10.01 sec
Line 128:		Line 134:
	[[AudioDub]](A) ## vdur=10.01, adur=9.00		[[AudioDub]](A) ## vdur=10.01, adur=9.00
	#return AssumeFPS(24, ''sync_audio''=false) ## vdur=12.50, adur=9.00 (audio unchanged)		#return AssumeFPS(24, ''sync_audio''=false) ## vdur=12.50, adur=9.00 (audio unchanged)
	#return AssumeFPS(24, ''sync_audio''=true) ## vdur=12.50, adur=11.238, sample rate=38438		#return AssumeFPS(24, ''sync_audio''=true) ## vdur=12.50, adur=11.238, sample rate=38438
	## (audio sample rate is changed by the same amount - in this case, by 24.00/29.97)		## (audio sample rate is changed by the same amount - in this case, by 24.00/29.97)
			</div>

	=====History=====		=====History=====
Line 195:		Line 202:
	=====Examples=====		=====Examples=====
	*PAL->NTSC conversion:		*PAL->NTSC conversion:
			<div {{BoxWidthIndent\|70\|1}} >
	AviSource("PAL_clip.avi") # Get clip		[[AviSource]]("PAL_clip.avi") # Get clip
	Bob(height=480) # Separate fields and interpolate them to full height.		[[Bob]](height=480) # Separate fields and interpolate them to full height.
	BicubicResize(640,480) # Resize to NTSC square-pixel frame size.		[[BicubicResize]](640,480) # Resize to NTSC square-pixel frame size.
	ChangeFPS(60000, 1001) # Convert field rate to NTSC, by duplicating fields.		ChangeFPS(60000, 1001) # Convert field rate to NTSC, by duplicating fields.
	SeparateFields.SelectEvery(4,0,3) # Undo Bob, even field first. Use SelectEvery(4,1,2) for odd field first.		[[SeparateFields]].[[SelectEvery]](4,0,3) # Undo [[Bob]], even field first. Use [[SelectEvery]](4,1,2) for odd field first.
	Weave() # Finish undoing Bob.		[[Weave]] # Finish undoing Bob.
			</div>
	The effect is similar to 3-2 telecine pull down. Regular viewers of PAL material may notice a motion stutter that viewers of NTSC material readily ignore as for telecined film.		:The effect is similar to 3-2 telecine pull down.
			:Regular viewers of PAL material may notice a motion stutter that viewers of NTSC material readily ignore as for telecined film.

	=====History=====		=====History=====
Line 251:		Line 259:
	=====Examples=====		=====Examples=====
	*NTSC->PAL conversion:		*NTSC->PAL conversion:
			<div {{BoxWidthIndent\|72\|1}} >
	~~AVISource~~("NTSC_clip.avi") # Get clip		[[AviSource]]("NTSC_clip.avi") # Get clip
	Bob(height=576) # Separate fields and interpolate them to full height.		[[Bob]](height=576) # Separate fields and interpolate them to full height.
	BicubicResize(768,576) # Resize to PAL square-pixel frame size.		[[BicubicResize]](768,576) # Resize to PAL square-pixel frame size.
	ConvertFPS(50) # Convert field rate to PAL, using ''Blend ''mode.		ConvertFPS(50) # Convert field rate to PAL, using ''Blend ''mode.
	SeparateFields.SelectEvery(4,0,3) # Undo Bob, even field first. Use SelectEvery(4,1,2) for odd field first.		[[SeparateFields]].[[SelectEvery]](4,0,3) # Undo [[Bob]], even field first. Use [[SelectEvery]](4,1,2) for odd field first.
	Weave() # Finish undoing Bob.		[[Weave]] # Finish undoing Bob.
			</div>
	This example will also work with frame-based NTSC material, even with telecined film (movies). For film material, however, you will get better results by using an inverse-telecine filter and speeding up the frame rate from 23.976 to 25fps.		:This example will also work with frame-based NTSC material, even with telecined film (movies).
			:For film material, however, you will get better results by using an inverse-telecine filter and speeding up the frame rate from 23.976 to 25fps.

	=====History=====		=====History=====

Raffriff42: ''sync_audio'' notes & example

2016-01-14T12:15:14Z

''sync_audio'' notes & example

← Older revision		Revision as of 14:15, 14 January 2016
Line 7:		Line 7:

	Changes the frame rate without changing the frame count, causing the video to play faster or slower.		Changes the frame rate without changing the frame count, causing the video to play faster or slower.

	~~This is also a method to change the sample rate of the audio alone.~~

	=====Parameters=====		=====Parameters=====
Line 102:		Line 100:

	{{Par2\|sync_audio\|bool\|false}}		{{Par2\|sync_audio\|bool\|false}}
	:If ''true'', the audio sample rate is changed ~~to match~~ the ~~duration of the video~~; the pitch of the resulting audio is shifted.		:If ''true'', the audio sample rate is changed by the same amount; the pitch of the resulting audio is shifted.
	:If ''false'' (the default), the audio is unchanged; this means the audio will lose synchronization over time.		:If ''false'' (the default), the audio is unchanged; this means the audio will lose synchronization over time.

Line 123:		Line 121:

	AviSource("video.avi").AssumeFPS(60, true) # Double speed		AviSource("video.avi").AssumeFPS(60, true) # Double speed

			*''sync_audio'' experiments:
			[[ColorBars]] ## 29.97 fps
			[[Trim]](0, 299) ## ''vdur'' (video duration) = 10.01 sec
			A = [[Tone]].[[AudioTrim]](0, -9.0) ## ''adur'' (audio duration) = 9.00 sec, sample rate=48000
			[[AudioDub]](A) ## vdur=10.01, adur=9.00
			#return AssumeFPS(24, ''sync_audio''=false) ## vdur=12.50, adur=9.00 (audio unchanged)
			#return AssumeFPS(24, ''sync_audio''=true) ## vdur=12.50, adur=11.238, sample rate=38438
			## (audio sample rate is changed by the same amount - in this case, by 24.00/29.97)

	=====History=====		=====History=====

Admin: /* ConvertFPS */

2016-01-01T22:22:59Z

ConvertFPS

← Older revision		Revision as of 00:22, 2 January 2016
Line 210:		Line 210:
	== ConvertFPS ==		== ConvertFPS ==

	{{Template:Func4Def\|ConvertFPS(clip ''clip'', float ''new_rate'' [, int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip1'', clip ''clip2'' [,int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip1'', string ''preset'' [, int ''zone'', int ''vbi''])}}		{{Template:Func4Def\|ConvertFPS(clip ''clip'', float ''new_rate'' [, int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip'', ''int numerator'' [, int ''denominator'', int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip1'', clip ''clip2'' [, int ''zone'', int ''vbi''])\|ConvertFPS(clip ''clip1'', string ''preset'' [, int ''zone'', int ''vbi''])}}

	The filter attempts to convert the frame rate without dropping or inserting frames, providing a smooth conversion with results similar to those of standalone converter boxes. The output will have (almost) the same duration as clip, but the number of frames will change proportional to the ratio of target and source frame rates.		The filter attempts to convert the frame rate without dropping or inserting frames, providing a smooth conversion with results similar to those of standalone converter boxes. The output will have (almost) the same duration as clip, but the number of frames will change proportional to the ratio of target and source frame rates.
Line 258:		Line 258:

	*From v2.57, the behaviour with respect to the framerate is a bit changed. See AssumeFPS.		*From v2.57, the behaviour with respect to the framerate is a bit changed. See AssumeFPS.


	==Changes==		==Changes==

Admin at 22:17, 1 January 2016

2016-01-01T22:17:38Z

← Older revision		Revision as of 00:17, 2 January 2016
Line 254:		Line 254:
	This example will also work with frame-based NTSC material, even with telecined film (movies). For film material, however, you will get better results by using an inverse-telecine filter and speeding up the frame rate from 23.976 to 25fps.		This example will also work with frame-based NTSC material, even with telecined film (movies). For film material, however, you will get better results by using an inverse-telecine filter and speeding up the frame rate from 23.976 to 25fps.

	====History====		=====History=====
	*From v2.56, if '''clip2''' is present, the framerate of ''clip1'' will be adjusted to match that of ''clip2''.		*From v2.56, if '''clip2''' is present, the framerate of ''clip1'' will be adjusted to match that of ''clip2''.

Admin: /* Parameters */

2016-01-01T21:58:58Z

Parameters

← Older revision		Revision as of 23:58, 1 January 2016
Line 145:		Line 145:

	{{Par2\|multiplier\|int\|1}}		{{Par2\|multiplier\|int\|1}}
	:~~clip1~~.[[Clip_properties\|FrameRateNumerator]] is multiplied by ''multiplier''.		:clip.[[Clip_properties\|FrameRateNumerator]] is multiplied by ''multiplier''.

	{{Par2\|divisor\|int\|1}}		{{Par2\|divisor\|int\|1}}
	:~~clip1~~.[[Clip_properties\|FrameRateDenominator]] is multiplied by ''divisor''.		:clip.[[Clip_properties\|FrameRateDenominator]] is multiplied by ''divisor''.

	{{Par2\|sync_audio\|bool\|false}}		{{Par2\|sync_audio\|bool\|false}}

← Older revision		Revision as of 23:58, 1 January 2016
Line 145:		Line 145:

	{{Par2\|multiplier\|int\|1}}		{{Par2\|multiplier\|int\|1}}
	:~~clip1~~.[[Clip_properties\|FrameRateNumerator]] is multiplied by ''multiplier''.		:clip.[[Clip_properties\|FrameRateNumerator]] is multiplied by ''multiplier''.

	{{Par2\|divisor\|int\|1}}		{{Par2\|divisor\|int\|1}}
	:~~clip1~~.[[Clip_properties\|FrameRateDenominator]] is multiplied by ''divisor''.		:clip.[[Clip_properties\|FrameRateDenominator]] is multiplied by ''divisor''.

	{{Par2\|sync_audio\|bool\|false}}		{{Par2\|sync_audio\|bool\|false}}