TimecodeFPS - Revision history

Reel.Deal: add note to timescodes parameter and cosmetics

2022-01-14T23:02:24Z

add note to timescodes parameter and cosmetics

Asd: Update the version

2022-01-14T02:06:34Z

Update the version

← Older revision		Revision as of 04:06, 14 January 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|[https://github.com/nattthebear natt]		\|[https://github.com/nattthebear natt]
	\|v1.1.3		\|v1.1.4
	\|[https://github.com/Asd-g/TimecodeFPS/releases/ TimecodeFPS]		\|[https://github.com/Asd-g/TimecodeFPS/releases/ TimecodeFPS]
	\|Frame Rate Converters		\|Frame Rate Converters
Line 66:		Line 66:
	==Changelog==		==Changelog==
	Version Date Changes<br>		Version Date Changes<br>
			v1.1.4 2022-01-14 - Fixed regression when start=true. (Asd-g)<br>
	v1.1.3 2022-01-13 - Changes by Asd-g		v1.1.3 2022-01-13 - Changes by Asd-g
	- Set duration of the latest frame when specified.<br>		- Set duration of the latest frame when specified.<br>

Asd: Update to the latest version

2022-01-13T21:17:27Z

Update to the latest version

← Older revision		Revision as of 23:17, 13 January 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|[https://github.com/nattthebear natt]		\|[https://github.com/nattthebear natt]
	\|v1.1.1		\|v1.1.3
	\|[https://github.com/Asd-g/TimecodeFPS/releases/ TimecodeFPS~~-1.1.1.zip~~]		\|[https://github.com/Asd-g/TimecodeFPS/releases/ TimecodeFPS]
	\|Frame Rate Converters		\|Frame Rate Converters
	\|Modified BSD license		\|Modified BSD license
	\|6=[http://tasvideos.org/forum/viewtopic.php?t=12763 TASVideos Forum]}}		\|6=[http://tasvideos.org/forum/viewtopic.php?t=12763 TASVideos Forum]}}
	== Description ==		== Description ==
	TimecodeFPS converts a clip from VFR to CFR. Timing information from clip is discarded, and matroska v2 timecodes from the timecodes file are used instead. Conversion is to any desired exact CFR framerate, as specified by fpsnum/fpsden. With report=true, an alternate debug/analysis display and info is used. Strictness of the conversion is controlled by the parameters threshone and threshmore.		TimecodeFPS converts a clip from VFR to CFR. Timing information from clip is discarded, and matroska v2 timecodes from the timecodes file are used instead. Conversion is to any desired exact CFR framerate, as specified by fpsnum/fpsden. With report=true, an alternate debug/analysis display and info is used. Strictness of the conversion is controlled by the parameters threshone and threshmore.

Line 49:		Line 49:
	::: If set to true, the 0th timecode in the file is assumed to be at the 0 time. If set to false, the exact number t=0 is assumed to be the 0 time.		::: If set to true, the 0th timecode in the file is assumed to be at the 0 time. If set to false, the exact number t=0 is assumed to be the 0 time.

	:::So for example, if the timecode for the 0th frame is at 6 seconds in, then if <code>start=false</code>, 6 seconds of pure black frames will be introduced into the output.		:::So for example, if the timecode for the 0th frame is at 6 seconds in, then if <code>start=false</code>, 6 seconds of pure black frames will be introduced into the output.
	:::When <code>start=true</code>, things will just start with that 0th frame being the first frame in the output and the 6 seconds will be omitted.		:::When <code>start=true</code>, things will just start with that 0th frame being the first frame in the output and the 6 seconds will be omitted.
	<br>		<br>
Line 66:		Line 66:
	==Changelog==		==Changelog==
	Version Date Changes<br>		Version Date Changes<br>
			v1.1.3 2022-01-13 - Changes by Asd-g
			- Set duration of the latest frame when specified.<br>
			v1.1.2 2021-09-28 - Changes by TomArrow
			- Created Visual Studio 2019 solution and removed GCC .mak files.
			- Changed to C++ and adapted a few lines of code that didn't work in C++.
			- Can now pass multiple timecode files by separating them with a semicolon, for example if you are loading multiple videos with absolute timestamp values and concatenating them and you want to preserve a continuous FPS across multiple files.<br>
	v1.1.1 2021-06-04 - Changes by Asd-g		v1.1.1 2021-06-04 - Changes by Asd-g
	- Added support for timestamp files created from mkvtoolnix.		- Added support for timestamp files created from mkvtoolnix.<br>
	v1.1 2020-04-15 - Changes by Binjohn		v1.1 2020-04-15 - Changes by Binjohn
	- Add 64-bit binary.		- Add 64-bit binary.
	- Update to AviSynth+ 3.5 library.		- Update to AviSynth+ 3.5 library.<br>
	2018-02-17 2018-02-17 - Add "start" parameter		2018-02-17 2018-02-17 - Add "start" parameter<br>
	2012-04-16 2012-04-16 - Initial release - [http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]		2012-04-16 2012-04-16 - Initial release - [http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]
	<br>		<br>

Reel.Deal: v1.1.1

2021-06-05T19:46:56Z

v1.1.1

← Older revision		Revision as of 21:46, 5 June 2021
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|[https://github.com/nattthebear natt]		\|[https://github.com/nattthebear natt]
	\|v1.1		\|v1.1.1
	\|[https://github.com/~~Binjohn~~/TimecodeFPS/releases TimecodeFPS-1.1.zip]		\|[https://github.com/Asd-g/TimecodeFPS/releases/ TimecodeFPS-1.1.1.zip]
	\|Frame Rate Converters		\|Frame Rate Converters
	\|Modified BSD license		\|Modified BSD license
Line 66:		Line 66:
	==Changelog==		==Changelog==
	Version Date Changes<br>		Version Date Changes<br>
			v1.1.1 2021-06-04 - Changes by Asd-g
			- Added support for timestamp files created from mkvtoolnix.
	v1.1 2020-04-15 - Changes by Binjohn		v1.1 2020-04-15 - Changes by Binjohn
	- Add 64-bit binary.		- Add 64-bit binary.
Line 75:		Line 77:
	*[https://github.com/nattthebear/avisynthjunk GitHub] - Natt's plugin archive.		*[https://github.com/nattthebear/avisynthjunk GitHub] - Natt's plugin archive.
	*[https://github.com/Binjohn/TimecodeFPS GitHub] - Source code repository (Binjohn).		*[https://github.com/Binjohn/TimecodeFPS GitHub] - Source code repository (Binjohn).
			*[https://github.com/Asd-g/TimecodeFPS GitHub] - Source code repository (Asd-g).
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''		'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''

Binjohn at 16:43, 18 April 2020

2020-04-18T16:43:53Z

← Older revision		Revision as of 18:43, 18 April 2020
Line 3:		Line 3:
	\|[https://github.com/nattthebear natt]		\|[https://github.com/nattthebear natt]
	\|v1.1		\|v1.1
	\|[https://github.com/Binjohn/TimecodeFPS/releases TimecodeFPS-1.1~~-bjt~~.zip]		\|[https://github.com/Binjohn/TimecodeFPS/releases TimecodeFPS-1.1.zip]
	\|Frame Rate Converters		\|Frame Rate Converters
	\|Modified BSD license		\|Modified BSD license

Reel.Deal: /* Syntax and Parameters */

2020-04-16T15:18:06Z

Syntax and Parameters

← Older revision		Revision as of 17:18, 16 April 2020
Line 22:		Line 22:
	:{{Template:FuncDef\|TimecodeFPS (clip, string "timecodes", int "fpsnum", int "fpsden", bool "report", float "threshone", float "threshmore", bool "start") }}		:{{Template:FuncDef\|TimecodeFPS (clip, string "timecodes", int "fpsnum", int "fpsden", bool "report", float "threshone", float "threshmore", bool "start") }}
	<br>		<br>
	::{{Par2\| \|clip\|~~last~~}}		::{{Par2\| \|clip\| }}
	:::Input clip. Can be any AviSynth supported colorspace. Must have exactly the same number of frames as lines in timecodes. Input FPS is discarded. Audio, if it exists, is passed through untouched.		:::Input clip. Can be any AviSynth supported colorspace. Must have exactly the same number of frames as lines in timecodes. Input FPS is discarded. Audio, if it exists, is passed through untouched.
	<br>		<br>

Reel.Deal: Add TimecodeFPS v1.1 (thanks Binjohn)

2020-04-16T13:36:04Z

Add TimecodeFPS v1.1 (thanks Binjohn)

← Older revision		Revision as of 15:36, 16 April 2020
Line 1:		Line 1:
	{{~~FilterCat4~~\|External_filters\|~~Scripts~~\|Adjustment_filters\|Frame_Rate_Conversion}}		{{FilterCat5\|External_filters\|Plugins\|Plugins_x64\|Adjustment_filters\|Frame_Rate_Conversion}}
	{{Filter3		{{Filter3
	\|[https://github.com/nattthebear natt]		\|[https://github.com/nattthebear natt]
	\|~~2012-04-16~~		\|v1.1
	\|[~~http~~://~~www.mediafire~~.com/~~?a51pifo438i7hdb timecodefps~~.zip]		\|[https://github.com/Binjohn/TimecodeFPS/releases TimecodeFPS-1.1-bjt.zip]
	\|Frame Rate Converters		\|Frame Rate Converters
	\|Modified BSD license		\|Modified BSD license
Line 14:		Line 14:
	<br>		<br>
	== Requirements ==		== Requirements ==
	* AviSynth ~~2.6~~ or [~~http~~://sourceforge.net/projects/avisynth2/ ~~greater~~]		* [x86] [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
			* [x64] [[AviSynth+]]
	* Supported color formats: [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]		* Supported color formats: [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]

	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|TimecodeFPS (clip, string "timecodes", int "fpsnum", int "fpsden", bool "report", float "threshone", float "threshmore") }}		:{{Template:FuncDef\|TimecodeFPS (clip, string "timecodes", int "fpsnum", int "fpsden", bool "report", float "threshone", float "threshmore", bool "start") }}
	<br>		<br>
	::{{Par2\| \|clip\|last}}		::{{Par2\| \|clip\|last}}
Line 42:		Line 43:
	::{{Par2\|threshmore\|float\|0.9}}		::{{Par2\|threshmore\|float\|0.9}}
	:::Controls the thresholds for the VFR->CFR algorithm. The algorithm is rather simple; it runs through the entire input track in sequence. For each input frame, it computes how much "space" there is for the frame: That is, the difference between the frame's VFR end time and the frame's CFR start time, the latter being determined by how many frames have been inserted into the output stream already.		:::Controls the thresholds for the VFR->CFR algorithm. The algorithm is rather simple; it runs through the entire input track in sequence. For each input frame, it computes how much "space" there is for the frame: That is, the difference between the frame's VFR end time and the frame's CFR start time, the latter being determined by how many frames have been inserted into the output stream already.
	:::This absolute time delta is converted to a unitless number relative to the CFR framerate, so that 1.0 = room for exactly one frame at the specified CFR rate. Then 0 or more copies of the input frame are inserted into the output track. The first copy is inserted if the available space is greater than threshone, and additional copies are inserted as long as the available space is greater than threshmore. (Available space decrements by 1.0 every time a frame is inserted).		:::This absolute time delta is converted to a unitless number relative to the CFR framerate, so that 1.0 = room for exactly one frame at the specified CFR rate. Then 0 or more copies of the input frame are inserted into the output track. The first copy is inserted if the available space is greater than <code>threshone</code>, and additional copies are inserted as long as the available space is greater than <code>threshmore</code>. (Available space decrements by 1.0 every time a frame is inserted).
	:::With these parameters, the "strictness" of the conversion is defined. Threshone = threshmore = 0.5 will be the most accurate in preserving original timing. The default settings allow for "frame preserving" operation: A lower threshold for a first copy and a higher threshold for a second copy means timing can be sacrificed for the goal of getting each frame in the stream at least once. Experimentation with the report tool is advised.		:::With these parameters, the "strictness" of the conversion is defined. <code>Threshone=0.5</code> and <code>threshmore=0.5</code> will be the most accurate in preserving original timing. The default settings allow for "frame preserving" operation: A lower threshold for a first copy and a higher threshold for a second copy means timing can be sacrificed for the goal of getting each frame in the stream at least once. Experimentation with the report tool is advised.
			<br>
			::{{Par2\|start\|bool\|false}}
			::: If set to true, the 0th timecode in the file is assumed to be at the 0 time. If set to false, the exact number t=0 is assumed to be the 0 time.

			:::So for example, if the timecode for the 0th frame is at 6 seconds in, then if <code>start=false</code>, 6 seconds of pure black frames will be introduced into the output.
			:::When <code>start=true</code>, things will just start with that 0th frame being the first frame in the output and the 6 seconds will be omitted.
	<br>		<br>

Line 59:		Line 66:
	==Changelog==		==Changelog==
	Version Date Changes<br>		Version Date Changes<br>
	2012-04-16 2012-04-16 - Initial release		v1.1 2020-04-15 - Changes by Binjohn
			- Add 64-bit binary.
			- Update to AviSynth+ 3.5 library.
			2018-02-17 2018-02-17 - Add "start" parameter
			2012-04-16 2012-04-16 - Initial release - [http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]
	<br>		<br>
	==External Links ==		==External Links ==
	*[https://github.com/nattthebear/avisynthjunk GitHub] - GitHub ~~archive~~.		*[https://github.com/nattthebear/avisynthjunk GitHub] - Natt's plugin archive.
			*[https://github.com/Binjohn/TimecodeFPS GitHub] - Source code repository (Binjohn).
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''		'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''

Binjohn: fpsnum and fpsden was reversed

2020-04-15T14:58:01Z

fpsnum and fpsden was reversed

← Older revision		Revision as of 16:58, 15 April 2020
Line 28:		Line 28:
	:::Exactly one timecode is expected per frame, and it gives the start point of the frame. (The end point of a frame is implicitly the same as the start point of the next frame, except for the last frame, where a guess is made.) The timecodes should be non-negative and non-decreasing. The first timecode need not be at time zero, but that will be used as the start point for the CFR stream, so a non-zero start time may cause the introduction of blank frame(s) before the first real frame.		:::Exactly one timecode is expected per frame, and it gives the start point of the frame. (The end point of a frame is implicitly the same as the start point of the next frame, except for the last frame, where a guess is made.) The timecodes should be non-negative and non-decreasing. The first timecode need not be at time zero, but that will be used as the start point for the CFR stream, so a non-zero start time may cause the introduction of blank frame(s) before the first real frame.
	<br>		<br>
	::{{Par2\|~~fpsden~~\|int\|25}}		::{{Par2\|fpsnum\|int\|25}}
	::{{Par2\|~~fpsnum~~\|int\|1}}		::{{Par2\|fpsden\|int\|1}}
	:::An exact CFR framerate to convert to. Any legal values are valid. Choosing the "right" framerate for a source should be done with report mode; there is no automatic detection.		:::An exact CFR framerate to convert to. Any legal values are valid. Choosing the "right" framerate for a source should be done with report mode; there is no automatic detection.
	<br>		<br>
Line 45:		Line 45:
	:::With these parameters, the "strictness" of the conversion is defined. Threshone = threshmore = 0.5 will be the most accurate in preserving original timing. The default settings allow for "frame preserving" operation: A lower threshold for a first copy and a higher threshold for a second copy means timing can be sacrificed for the goal of getting each frame in the stream at least once. Experimentation with the report tool is advised.		:::With these parameters, the "strictness" of the conversion is defined. Threshone = threshmore = 0.5 will be the most accurate in preserving original timing. The default settings allow for "frame preserving" operation: A lower threshold for a first copy and a higher threshold for a second copy means timing can be sacrificed for the goal of getting each frame in the stream at least once. Experimentation with the report tool is advised.
	<br>		<br>

	== Examples ==		== Examples ==
	Note: In order to get timing display along side output display, TimecodeFPS must be called twice with the same parameters, once with report on and once with report off. Here is an example:		Note: In order to get timing display along side output display, TimecodeFPS must be called twice with the same parameters, once with report on and once with report off. Here is an example:

Reel.Deal: add author link

2019-09-12T19:21:08Z

add author link

← Older revision		Revision as of 21:21, 12 September 2019
Line 1:		Line 1:
	{{FilterCat4\|External_filters\|Scripts\|Adjustment_filters\|Frame_Rate_Conversion}}		{{FilterCat4\|External_filters\|Scripts\|Adjustment_filters\|Frame_Rate_Conversion}}
	{{Filter3		{{Filter3
	\|natt		\|[https://github.com/nattthebear natt]
	\|2012-04-16		\|2012-04-16
	\|[http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]		\|[http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]

Reel.Deal: /* External Links */

2019-09-12T19:20:41Z

External Links

← Older revision		Revision as of 21:20, 12 September 2019
Line 61:		Line 61:
	<br>		<br>
	==External Links ==		==External Links ==
			*[https://github.com/nattthebear/avisynthjunk GitHub] - GitHub archive.
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''		'''Back to [[External_filters#Frame_Rate_Conversion\|External Filters]] ←'''

← Older revision		Revision as of 01:02, 15 January 2022
Line 28:		Line 28:
	:::Path to a matroska v2 timecodes file. Only matroska v2 timecodes files are supported.		:::Path to a matroska v2 timecodes file. Only matroska v2 timecodes files are supported.
	:::Exactly one timecode is expected per frame, and it gives the start point of the frame. (The end point of a frame is implicitly the same as the start point of the next frame, except for the last frame, where a guess is made.) The timecodes should be non-negative and non-decreasing. The first timecode need not be at time zero, but that will be used as the start point for the CFR stream, so a non-zero start time may cause the introduction of blank frame(s) before the first real frame.		:::Exactly one timecode is expected per frame, and it gives the start point of the frame. (The end point of a frame is implicitly the same as the start point of the next frame, except for the last frame, where a guess is made.) The timecodes should be non-negative and non-decreasing. The first timecode need not be at time zero, but that will be used as the start point for the CFR stream, so a non-zero start time may cause the introduction of blank frame(s) before the first real frame.

			::: * '''Note''': starting from v1.1.4, an extra timestamp sets the duration of the last frame (when specified).
	<br>		<br>
	::{{Par2\|fpsnum\|int\|25}}		::{{Par2\|fpsnum\|int\|25}}
Line 68:		Line 70:
	v1.1.4 2022-01-14 - Fixed regression when start=true. (Asd-g)<br>		v1.1.4 2022-01-14 - Fixed regression when start=true. (Asd-g)<br>
	v1.1.3 2022-01-13 - Changes by Asd-g		v1.1.3 2022-01-13 - Changes by Asd-g
	- Set duration of the latest frame when specified.<br>		- Set duration of the latest frame when specified.<br>
	v1.1.2 2021-09-28 - Changes by TomArrow		v1.1.2 2021-09-28 - Changes by TomArrow
	- Created Visual Studio 2019 solution and removed GCC .mak files.		- Created Visual Studio 2019 solution and removed GCC .mak files.
	- Changed to C++ and adapted a few lines of code that didn't work in C++.		- Changed to C++ and adapted a few lines of code that didn't work in C++.
	- Can now pass multiple timecode files by separating them with a semicolon, for example if you are loading multiple videos with absolute timestamp values and concatenating them and you want to preserve a continuous FPS across multiple files.<br>		- Can now pass multiple timecode files by separating them with a semicolon,
			for example if you are loading multiple videos with absolute timestamp
			values and concatenating them and you want to preserve a continuous FPS
			across multiple files.<br>
	v1.1.1 2021-06-04 - Changes by Asd-g		v1.1.1 2021-06-04 - Changes by Asd-g
	- Added support for timestamp files created from mkvtoolnix.<br>		- Added support for timestamp files created from mkvtoolnix.<br>
	v1.1 2020-04-15 - Changes by Binjohn		v1.1 2020-04-15 - Changes by Binjohn
	- Add 64-bit binary.		- Add 64-bit binary.
	- Update to AviSynth+ 3.5 library.<br>		- Update to AviSynth+ 3.5 library.<br>
	2018-02-17 2018-02-17 - Add "start" parameter<br>		2018-02-17 2018-02-17 - Add "start" parameter<br>
	2012-04-16 2012-04-16 - Initial release - [http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]		2012-04-16 2012-04-16 - Initial release - [http://www.mediafire.com/?a51pifo438i7hdb timecodefps.zip]