Reel.Deal: update to match v1.1.0

2020-06-24T17:41:36Z

update to match v1.1.0

← Older revision		Revision as of 19:41, 24 June 2020
Line 37:		Line 37:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|FDecimate (clip, float "rate", float "threshold", bool "metrics", bool "show", bool "debug")}}		:{{Template:FuncDef\|FDecimate (clip, float "rate", float "threshold", bool "protect", bool "metrics", bool "show", bool "debug")}}
	<br>		<br>
	::{{Par2\| \|clip\| }}		::{{Par2\| \|clip\| }}
Line 46:		Line 46:
	<br>		<br>
	::{{Par2\|threshold\|int\|1.0}}		::{{Par2\|threshold\|int\|1.0}}
	:::This parameter sets the threshold difference metric for duplicate detection. If the difference metric between two frames exceeds this threshold, the two frames are considered to be different frames. i.e., not duplicates. Refer to the "How to Use FDecimate()" section above for an explanation of how to set this threshold properly.		:::This parameter sets the threshold difference metric for duplicate detection. If the difference metric between two frames exceeds this threshold, the two frames are considered to be different frames. i.e., not duplicates. Refer to the "How to Use FDecimate()" section above for an explanation of how to set this threshold properly.
			<br>
			::{{Par2\|protect \|bool\|false}}
			:::This parameter helps to avoid "bad" frames after scene changes. When enabled, the chosen output frame is compared to the following one (in the input stream). If the following one is a duplicate of the chosen one, then the following one is delivered instead.
	<br>		<br>
	::{{Par2\|metrics\|bool\|false}}		::{{Par2\|metrics\|bool\|false}}
Line 52:		Line 55:
	<br>		<br>
	::{{Par2\|show\|bool\|false}}		::{{Par2\|show\|bool\|false}}
	:::This parameter enables information to be displayed on the frame. It also displays the software version.		:::This parameter enables information to be displayed on the frame. It also displays the software version.
			:::The meanings of the numbers are as follows:
			:::*blind: The choice that would be made using naive decimation, not trying to avoid delivering duplicates.
			:::*choose: The choice that would be made when trying to avoid duplicates.
			:::*use: The final ch
	<br>		<br>
	::{{Par2\|debug\|bool\|false}}		::{{Par2\|debug\|bool\|false}}
Line 85:		Line 92:
	<code>FDecimate(metrics=true)</code>		<code>FDecimate(metrics=true)</code>

	This will display the difference metric for each frame (decimation is not performed when metrics=true). Inspect the metric for the duplicate frames. You need to find a number such that the metric for all the duplicates is below it, while the metric for the new pictures is above it. That number is the threshold that should be set for the 'threshold' parameter. It is usually ~~about~~ 1.0-2.5, but it may differ depending upon how noisy your clip is. It's important to get a good value for this threshold, so do it carefully, inspecting several sections of your clip.		This will display the difference metric for each frame (decimation is not performed when metrics=true). Inspect the metric for the duplicate frames. You need to find a number such that the metric for all the duplicates is below it, while the metric for the new pictures is above it. That number is the threshold that should be set for the 'threshold' parameter. It is usually something around 1.0-10.0, but it may differ depending upon how noisy your clip is. It's important to get a good value for this threshold, so do it carefully, inspecting several sections of your clip.

	'''''Producing the Decimated Output''''' Once the target frame rate and duplicate threshold have been determined, it is easy to produce the final decimated output. Assuming our target frame rate is 20.8 fps, and our duplicate threshold is 2.1, we would use this FDecimate() call:		'''''Producing the Decimated Output''''' Once the target frame rate and duplicate threshold have been determined, it is easy to produce the final decimated output. Assuming our target frame rate is 20.8 fps, and our duplicate threshold is 2.1, we would use this FDecimate() call:
Line 120:		Line 127:
	FDecimate with default values:		FDecimate with default values:
	AviSource("blah.avi")		AviSource("blah.avi")
	FDecimate (rate=23.976, threshold=1.0, metrics=false, show=false, debug=false)		FDecimate (rate=23.976, threshold=1.0, protect=false, metrics=false, show=false, debug=false)
	<br>		<br>
	== Changelog ==		== Changelog ==
	Version Date Changes<br>		Version Date Changes<br>
	v1.1.0 2008/07/03 - Improves the avoidance of duplicate delivery and adds a ,i>protect option		v1.1.0 2008/07/03 - Improves the avoidance of duplicate delivery and adds a ,i>protect option
	intended to help prevent delivery of "bad" frames after scene changes.		intended to help prevent delivery of "bad" frames after scene changes.
	v1.0.2 2007/04/29 - Fixes a theoretical problem with pitch handling (which was thus far never		v1.0.2 2007/04/29 - Fixes a theoretical problem with pitch handling (which was thus far never
	encountered in practice).		encountered in practice).
	<br>		<br>

Reel.Deal at 17:24, 24 June 2020

2020-06-24T17:24:15Z

← Older revision		Revision as of 19:24, 24 June 2020
Line 129:		Line 129:
	encountered in practice).		encountered in practice).
	<br>		<br>
	~~<br>~~

	== Archived Downloads ==		== Archived Downloads ==
	{\| class="wikitable" border="1"; width="600px"		{\| class="wikitable" border="1"; width="600px"

Reel.Deal: FDecimate: add documentation

2020-06-24T17:22:08Z

FDecimate: add documentation

Show changes

Raffriff42: redirect for convenient searching

2015-11-08T01:03:32Z

redirect for convenient searching

New page

#REDIRECT [[External_filters#IVTC_.26_Decimation]]
{{FilterCat|External_filters|Restoration_filters|IVTC}}

FDecimate - Revision history

Reel.Deal: update to match v1.1.0

Reel.Deal at 17:24, 24 June 2020

Reel.Deal: FDecimate: add documentation

Raffriff42: redirect for convenient searching