FPS - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T03:41:53Z

add link to avs+ documentation

Raffriff42: one more touch-up

2016-03-10T02:17:14Z

one more touch-up

Raffriff42: one more touch-up

2016-02-27T23:20:07Z

one more touch-up

Show changes

Admin: /* ConvertFPS */

2016-01-14T22:04:36Z

‎ConvertFPS

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

Raffriff42: formatting, add internal links in examples

2016-01-14T12:21:59Z

formatting, add internal links in examples

Raffriff42: ''sync_audio'' notes & example

2016-01-14T12:15:14Z

''sync_audio'' notes & example

Admin: /* ConvertFPS */

2016-01-01T22:22:59Z

‎ConvertFPS

Admin at 22:17, 1 January 2016

2016-01-01T22:17:38Z

Admin: /* Parameters */

2016-01-01T21:58:58Z

‎Parameters

← Older revision		Revision as of 03: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.

@@ Line 4: / Line 4: @@
 == AssumeFPS ==
 <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'', ''int numerator'' [, int ''denominator'', bool ''sync_audio''])
 |AssumeFPS(clip ''clip1'', clip ''clip2'' [, bool ''sync_audio''])
 |AssumeFPS(clip ''clip1'', string ''preset'' [, bool ''sync_audio''])
@@ Line 18: / Line 21: @@
 {{Par2|fps|float|}}
 :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 &rarr; 329833/9895 (33.3332996)
+:eg, 33.3333 &rarr; 329833/9895 (33.3332996)
 {{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.
-{{Func4Def
+{{Func2Def
 |ChangeFPS(clip ''clip'', float ''fps'' [, bool ''linear''])
 |ChangeFPS(clip ''clip'', int ''numerator'' [, int ''denominator'', bool ''linear''])
 |ChangeFPS(clip ''clip1'', clip ''clip2'', bool ''linear'')
 |ChangeFPS(clip ''clip1'', string ''preset'' [, bool ''linear''])
@@ Line 196: / Line 202: @@
 {{Par2|fps|float|}}
 :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 &rarr; 329833/9895 (33.3332996)
+:eg, 33.3333 &rarr; 329833/9895 (33.3332996)
 {{Par2|numerator|int|}}
@@ Line 248: / Line 254: @@
 Not all parameter values are checked for sanity.
-{{Func4Def
+{{Func2Def
 |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''])
@@ Line 256: / Line 265: @@
 {{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.
 {{Par2|zone|int|}}

@@ Line 235: / Line 235: @@
 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.

← Older revision		Revision as of 12: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=====

@@ Line 106: / Line 106: @@
 *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>
 *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")
 *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")
 *''sync_audio'' experiments:
   [[ColorBars]] ## 29.97 fps
   [[Trim]](0, 299) ## ''vdur'' (video duration) = 10.01 sec
@@ Line 128: / Line 134: @@
   [[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
+  #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=====
@@ Line 195: / Line 202: @@
 =====Examples=====
 *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.
 =====History=====
@@ Line 251: / Line 259: @@
 =====Examples=====
 *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.
-  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).
 =====History=====

@@ Line 7: / Line 7: @@
 Changes the frame rate without changing the frame count, causing the video to play faster or slower.
 =====Parameters=====
@@ Line 102: / Line 100: @@
 {{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.
@@ Line 123: / Line 121: @@
   AviSource("video.avi").AssumeFPS(60, true)             # Double speed
 =====History=====

@@ Line 210: / Line 210: @@
 == 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.
@@ Line 258: / Line 258: @@
 *From v2.57, the behaviour with respect to the framerate is a bit changed. See AssumeFPS.
 ==Changes==

@@ Line 145: / Line 145: @@
 {{Par2|multiplier|int|1}}
-:clip1.[[Clip_properties|FrameRateNumerator]] is multiplied by ''multiplier''.
+:clip.[[Clip_properties|FrameRateNumerator]] is multiplied by ''multiplier''.
 {{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}}