# InterFrame

## Abstract

author: SubJunk
version: 2.8.2
download: http://www.spirton.com/
category: Frame Rate Conversion
requirements:

- SVPflow
  Note: SVPflow is included in the download of this script.

license: None

## Description

A frame interpolation script that makes accurate estimations about the content of frames

Its main use is to give videos higher framerates like newer TVs do

### Syntax

`InterFrame` (clip Input, bool "GPU", string "Preset", string "Tuning", int "NewNum", int "NewDen", string "InputType", int "OverrideAlgo", int "OverrideArea", int "Cores", bool "FrameDouble")

### Parameters

GPU:

Whether or not to use GPU (video card) alongside CPU to accelerate conversion and improve quality.
Note: This mode may run slower. This is because while it is doing calculations much faster, it is also doing more complicated calculations to improve quality.

- true - Use the GPU. Recommended for those with video cards.
- false - Do not use the GPU.

default - false (bool)

Preset:

Sets the interpolation strength/quality.
It controls the compromising between quality and speed.
Useful for realtime users.

- Medium - Very good quality (Recommended).
- Fast - Faster than Medium but slightly lower quality.
- Faster - Faster than Fast but lower quality.

default - Medium (string)

Tuning:

Tunes the settings for the type of content.

- Film - This offers a good balance between the accuracy of individual moving things and the cohesiveness of the frame. Useful for content that was filmed or rendered (Recommended).
- Animation - This should be used for cartoons/anime.
- Smooth - This increases the accuracy of individual moving things while decreasing the cohesiveness of the frame. Some people prefer it since it gives the motion an overall "smooth" feeling.
- Weak - This decreases the accuracy of individual moving things while increasing the cohesiveness of the frame.
  Note: This will weaken the interpolation a lot, meaning the motion isn't as smooth.
  Some people will prefer to use the Film tuning even for animated content, so don't automatically assume this is the right tuning for you; use with caution.

default - Film (string)

NewNum:

Sets the numerator for the output video.

- 0 - Automatic output framerate, which uses the following logic:
  - If the input framerate is 25FPS, output 50FPS.
  - If the input framerate is 30FPS, output 60FPS.
  - If the input framerate is anything else, output 59.94FPS.
- Integers higher than 0 - Output the framerate equal to this value divided by NewDen (see below).
  Note: Any value for this argument other than 0 - or nothing - requires NewDen to also be defined.

default - 0 (int)

NewDen:

Sets the denominator for the output video.

- Whatever you want NewNum to be divided by.

default - 0 (int)

InputType:

Sets the type of input with regards to 2D or different types of 3D.

- 2D - This is for regular videos.
- SBS - This is for 3D Side-By-Side content, usually the resolution will be 3840x1080 (1920x1080 for each eye).
- OU - This is for 3D Over-Under content (AKA Top-to-Bottom), usually the resolution will be 1920x2160 (1920x1080 for each eye).
- HSBS - This is for 3D Side-By-Side content at half the resolution, usually the resolution will be 1920x1080 (960x1080 for each eye).
- HOU - This is for 3D Over-Under content (AKA Top-to-Bottom), usually the resolution will be 1920x1080 (1920x540 for each eye).
  Note: This setting does not create 3D from 2D, it just properly interpolates content that is already 3D.
  The 3D options approximately halve the speed - because they calculate each half separately - so if you are OK with less 3D accuracy you can use the 2D (default) mode for faster performance.

default - 2D (string)

OverrideAlgo:

Sets the algorithm.

- 2 - This makes strong predictions which can be useful for cartoons but can also leave big artifacts. This is the default value when using the "Animation" tuning.
- 13 - This is the most intelligent algorithm since it masks many artifacts, but it is not as smooth as 23. This is the default value.
- 23 - This is the smoothest algorithm, but it does not have the artifact masking that 13 has. This is the default value when using the "Smooth" tuning.
- Others - If you know them you can use them.

default - 13 (int)

OverrideArea:

Sets the strength of the Area mask.

- Any integer. The lower it is, the stronger the mask is.
  The "Animation" tuning uses a value of 150, while all other tunings use 0 (which means they don't use it).

default - 0 (int)

Cores:

Sets the number of CPU cores to use.

- This must be the same as the second number in the SetMTMode function.
  For example, if you use SetMTMode(3,4) you should use Cores=4.

default - Undefined

FrameDouble:

Whether to always double the framerate.

- true - Double the framerate of the input video, unless NewNum is not 0.
- false - Use the default framerate logic (see NewNum above for details).

default - false (bool)

## Example Scripts

Recommended:

    InterFrame(GPU=true, Cores=x)

48FPS output regardless of input framerate:

    InterFrame(NewNum=48000, NewDen=1001, Cores=x)

Always double the framerate:

    InterFrame(FrameDouble=true, Cores=x)

Cartoon/anime input:

    InterFrame(Tuning="Animation", Cores=x)

Faster - but lower quality - interpolation:

    InterFrame(Preset="Fast", Cores=x)

3D SBS input:

    InterFrame(InputType="SBS", Cores=x)

## Changelog

21/05/2015 - 2.8.2

- Updated to SVPflow 1.1.15, which increased speed (thanks, SVP!)

02/05/2015 - 2.8.1

- Updated to SVPflow 1.1.14, which increased speed by up to 15% (thanks, SVP!)

10/03/2015 - 2.8.0.1

- Updated to SVPflow 1.1.13, which fixed the unused SVConvert function (thanks, SVP!)

05/03/2015 - 2.8.0

- Updated SVP libraries (thanks, SVP!) which:
  - Increased speed by up to 20%
  - Reduced memory usage
  - Removed 2 dependencies (from 4 to 2)
- Updated documentation

03/01/2015 - 2.7.0

- Added "fastest" preset, for even more speed but lower quality.

09/09/2014 - 2.6.0

- Added new boolean option "FrameDouble", which when set to "true" will always double the framerate of the input video, unless NewNum is greater than 0.
- Updated the "Recommended" script in the documentation

11/05/2014 - 2.5.2

- Updated SVP libraries (thanks, SVP!) which:
  - Improved quality
  - Fixed bugs

16/12/2013 - 2.5.1

- Minor code cleanup
- Updated SVP libraries (thanks, SVP!) which:
  - Improved quality
  - Improved GPU support
  - Fixed bugs

18/02/2013 - 2.5.0
- Minimized artifacts (thanks, Widezu69!)
- Made motion smoother by default (only in GPU mode)
- Updated libraries which improve scene-change detection, thanks to SVP.

24/01/2013 - 2.4.0
- Updated libraries which improve scene-change detection, thanks to SVP.

16/01/2013 - 2.4.0 RC1
- Fixed the presets Weak and Faster when not using GPU (thanks, Motenai Yoda!)
- Fixed the Animation tuning (thanks, HolyWu!)

11/01/2013 - 2.4.0 Beta 1
- The "Medium" preset is back to what it was in 2.2.0
- The "Fast" preset is the same as "Medium" was in 2.3.0
- The new "Faster" preset is the same as "Fast" was in 2.3.0
- The "Animation" tuning has been changed a lot based on SVP recommendations
- The "Weak" tuning has been changed a lot based on widezu69's recommendations
- The "Smooth" tuning is smoother

24/12/2012 - 2.3.0
- Increased speed
- Decreased blobs/artifacts in high-action scenes
- Updated libraries which optimise memory use and support more video cards, thanks to SVP.

13/11/2012 - 2.2.0
- Fixed a syntax bug that appears to have had little-to-no effect (thanks to HolyWu for reporting it).
- Tweaked scene-change detection again (tightened this time to improve artifacts).

27/06/2012 - 2.1.0
- Improved smoothness in high-action scenes by loosening scene-change detection.

05/06/2012 - 2.0.2
- Better interpolation stability.
- Supports more video cards.
- Better compatibility with AviSynth 2.6.
- Thanks to SVP.

05/05/2012 - 2.0.1
- Updated libraries to support new video cards like GTX 680, thanks to SVP.

03/05/2012 - 2.0
- Updated libraries, thanks to SVP.

17/04/2012 - 2.0 RC1
- Updated libraries, thanks to SVP.

12/04/2012 - 2.0 Beta 4
- Reduced instances of warping by fixing usage of SAD mask, thanks to Bernardd for reporting the bug. - Further reduced instances of warping by lowering area_sharp (sadgamma).

11/04/2012 - 2.0 Beta 3
- Updated libraries, thanks to SVP.
- Changed some fields from string to int (NewNum, NewDen, OverrideAlgo and OverrideArea).

30/03/2012 - 2.0 Beta 2
- Updated libraries, thanks to SVP.
- Fixed 3D modes.
- Fixed "overlap must be even" error.

24/03/2012 - 2.0 Beta 1
- Rewrite which no longer uses MVTools2 and has better quality and is faster.

29/02/2012 - 1.13
- Added the "OverrideAlgo" option for users who wants to override the recommended algo value.
- Added the "OverrideSadML" option for users who wants to override the recommended sadml value.
- Updated FFTW to 3.3.1 from 3.2.2.
- Updated MVTools2 (SVP Build) to 2.5.11.9 from 2.5.11.8, thanks to SVP.
- Updated libflowgpu to 1.2.7 from 1.2.6, thanks to SVP.

31/12/2011 - 1.12.3
- Updated libflowgpu to 1.2.6 from 1.2.5 which improves ATI GPU compatibility, thanks to SVP.
- Code reshuffle (no changes)

03/11/2011 - 1.12.2
- Updated MVTools2 (SVP Build) to 2.5.11.8 from 2.5.11.7 which improves speed by 2-15%, thanks to SVP.

16/09/2011 - 1.12.1
- Updated MVTools2 (SVP Build) to 2.5.11.7 from 2.5.11.6 which synchronises the build with the official 2.5.11.2 beta release.
- Updated libflowgpu to 1.2.5 from 1.2.0 which improves GPU compatibility, thanks to SVP.

12/09/2011 - 1.12
- Improved some warping.
- Added new UltraSmooth tuning and changed the Smooth tuning. Smooth now has more error-correction than before, while UltraSmooth is roughly what Smooth was before.

05/07/2011 - 1.11
- Increased quality of all presets. This change makes fast panning less smooth, but also decreases errors in general.
- Fixed bug with Placebo preset (thanks to Alek93j and Gavino).

18/06/2011 - 1.10
- Increased quality of all presets. Thanks to DeathTheSheep for collaborating.
- Increased speed of "Ultra Fast" and "Super Fast" presets.
- "Animation" tuning is now much better and recommended for cartoon/anime inputs.
- What used to be the "Animation" tuning is now called "Weak".

23/05/2011 - 1.9
- Added support for 2 more types of 3D inputs (Half-SBS and Half-Over-Under).

20/05/2011 - 1.8.1
- Fixed stuttering motion particularly visible in cartoons.

04/05/2011 - 1.8
- Improved support for 2 types of 3D content - SBS (Side-By-Side) and OU (Over-Under), AKA Top-to-Bottom. This new feature is controlled by the new parameter InputType.

30/04/2011 - 1.7.1
- Increased the speed by roughly 40%, thanks to SVP

28/04/2011 - 1.7
- Increased the quality of all presets

20/04/2011 - 1.6
- Updated libflowgpu from 1.1 to 1.2 which improves the quality of GPU=true mode, thanks to SVP
- Added more presets ("Faster" and "Super Fast") based on some realtime user's suggestions, so now there is a smoother step between presets

13/04/2011 - 1.5.2
- Set GPU=false by default instead of true, because of slight quality loss with GPU=true

13/04/2011 - 1.5.1
- Fixed bug with GPU=false mode

11/04/2011 - 1.5
- Improved the quality of the default, Fast and Placebo presets
- It now checks for the existence of the mandatory value for FlowPath and displays an alert if it isn't defined
- Added the GPU parameter (true for GPU-acceleration, false for CPU-only)

10/04/2011 - 1.4
- Added custom mvtools2 and GPU-acceleration thanks to SVP
- Improved the quality of all presets

01/04/2011 - 1.3.1
- Added input validation for Tuning and Preset values with descriptive error messages

30/03/2011 - 1.3
- Added new Tuning value called Smooth
- Improved detection of scene-changes

24/03/2011 - 1.2
- Renamed Fast preset to Ultra Fast
- Added Very Fast and Fast presets
- Increased quality of Placebo and Medium presets
- Added Tuning variable
- Improved detection of scene-changes

22/03/2011 - 1.1
- Renamed Quality preset to Medium (default)
- Renamed Speed preset to Fast
- Increased quality of Medium (default) preset
- Added Placebo preset (little quality gain with big performance hit, not recommended)
- RemoveGrain is now required for Medium (default) preset
- EEDI2 is required for Placebo preset

21/03/2011 - 1.0.2
- Increased speed of both presets

20/03/2011 - 1.0.1
- Slightly faster - Scene-changes no longer fade/blend

18/03/2011 - 1.0
- Initial Release