Fmtconv - Revision history

Reel.Deal: add documentation link

2022-12-29T06:35:05Z

add documentation link

← Older revision		Revision as of 08:35, 29 December 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|1={{Author/cretindesalpes}}		\|1={{Author/cretindesalpes}}
	\|2=~~r29~~		\|2=r30
	\|3=[https://github.com/EleonoreMizo/fmtconv/releases/ fmtconv-r29.zip]		\|3=[https://github.com/EleonoreMizo/fmtconv/releases/ fmtconv-r29.zip]
	\|4=Resize		\|4=Resize
Line 8:		Line 8:
	\|6=[https://forum.doom9.org/showthread.php?t=183139 Doom9 Forum]		\|6=[https://forum.doom9.org/showthread.php?t=183139 Doom9 Forum]
	}}		}}
			<div {{BlueBox2\|40\|0\|3px solid red}} >
			'''Up-to-date documentation: [https://htmlpreview.github.io/?https://github.com/EleonoreMizo/fmtconv/blob/master/doc/fmtconv.html fmtconv.html]'''
			</div>
	<br>		<br>
	== Description ==		== Description ==

Kogarou: I keep forgetting to click the preview button

2022-07-06T03:18:45Z

I keep forgetting to click the preview button

← Older revision		Revision as of 05:18, 6 July 2022
Line 11:		Line 11:
	== Description ==		== Description ==
	[[fmtconv]] is a format-conversion plug-in for the VapourSynth and AviSynth+ video processing engines. It does:		[[fmtconv]] is a format-conversion plug-in for the VapourSynth and AviSynth+ video processing engines. It does:

	~~Fmtconv is a format-conversion plug-in for the Vapoursynth and Avisynth+ video processing engines. It does:~~

	*Resizing.		*Resizing.
Line 50:		Line 48:
	:{{Template:FuncDef\|fmtc_bitdepth (clip c, int "bits", bool "flt", string "planes", bool "fulls", bool "fulld", int "dmode", float "ampo",float "ampn",bool "dyn", bool "staticnoise", int "cpuopt", int "patsize", bool "tpdfo", bool "tpdfn",bool "corplane")}}		:{{Template:FuncDef\|fmtc_bitdepth (clip c, int "bits", bool "flt", string "planes", bool "fulls", bool "fulld", int "dmode", float "ampo",float "ampn",bool "dyn", bool "staticnoise", int "cpuopt", int "patsize", bool "tpdfo", bool "tpdfn",bool "corplane")}}
	<br>		<br>
	::{{Par2\| \|clip\| }}		::{{Par2\|c\|clip}}
	:::Input clip.		:::Input clip.
	<br>		<br>
Line 143:		Line 141:
	<br><br>		<br><br>
	:{{Template:FuncDef\|fmtc_matrix (clip c, string mat, string mats, string matd, bool fulls, bool fulld, arrayf coef, string csp, string col_fam, int bits, int singleout, int cpuopt)}}		:{{Template:FuncDef\|fmtc_matrix (clip c, string mat, string mats, string matd, bool fulls, bool fulld, arrayf coef, string csp, string col_fam, int bits, int singleout, int cpuopt)}}
	::{{Par2\|c\|clip\| }}		::{{Par2\|c\|clip}}
	:::Input clip.		:::Input clip.
	<br>		<br>
	::{{Par2\|mat\|string\|-1}}		::{{Par2\|mat\|string\|(undefined)}}
	:::Predefined matrix for conversions to and from R’G’B’. The direction is deduced from the specified input and output colorspaces. Possible values are:		:::Predefined matrix for conversions to and from R’G’B’. The direction is deduced from the specified input and output colorspaces. Possible values are:
	:::*"601": ITU-R BT.601 / ITU-R BT.470-2 / SMPTE 170M. For Standard Definition content.		:::*"601": ITU-R BT.601 / ITU-R BT.470-2 / SMPTE 170M. For Standard Definition content.
Line 229:		Line 227:
	<br><br>		<br><br>
	:{{Template:FuncDef\|fmtc_matrix2020cl (clip c, bool full, string csp, int bits, int cpuopt)}}		:{{Template:FuncDef\|fmtc_matrix2020cl (clip c, bool full, string csp, int bits, int cpuopt)}}
	::{{Par2\|c\|clip\| }}		::{{Par2\|c\|clip}}
	:::Input clip.		:::Input clip.
	:::For RGB, only 16-bit clips are supported		:::For RGB, only 16-bit clips are supported
Line 262:		Line 260:
	<br><br>		<br><br>
	:{{Template:FuncDef\|fmtc_primaries (clip c, arrayf rs, arrayf gs, arrayf bs,arrayf ws, arrayf rd, arrayf gd, arrayf bd, arrayf wd, string prims, string primd, int cpuopt)}}		:{{Template:FuncDef\|fmtc_primaries (clip c, arrayf rs, arrayf gs, arrayf bs,arrayf ws, arrayf rd, arrayf gd, arrayf bd, arrayf wd, string prims, string primd, int cpuopt)}}
	::{{Par2\|c\|clip\| }}		::{{Par2\|c\|clip}}
	:::Input clip.		:::Input clip.
	:::Supported colorspaces are 16- or 32-bit linear RGB. You should use the transfer function to convert between linear RGB and gamma-compressed R’G’B ’colorspaces.		:::Supported colorspaces are 16- or 32-bit linear RGB. You should use the transfer function to convert between linear RGB and gamma-compressed R’G’B ’colorspaces.

Kogarou: Small update to the description

2022-07-06T03:14:19Z

Small update to the description

← Older revision		Revision as of 05:14, 6 July 2022
Line 11:		Line 11:
	== Description ==		== Description ==
	[[fmtconv]] is a format-conversion plug-in for the VapourSynth and AviSynth+ video processing engines. It does:		[[fmtconv]] is a format-conversion plug-in for the VapourSynth and AviSynth+ video processing engines. It does:

			Fmtconv is a format-conversion plug-in for the Vapoursynth and Avisynth+ video processing engines. It does:

	*Resizing.		*Resizing.
Line 19:		Line 21:

	*Pixel data types: 8-–12-, 14- and 16-bit integer, 32-bit float.		*Pixel data types: 8-–12-, 14- and 16-bit integer, 32-bit float.
	*Colorspaces: RGB, Y, YUV in 4:4:4, 4:2:2, 4:2:0, 4:1:1 ~~and YCgCo with the same~~ chroma subsampling factors.		*Colorspaces: RGB, Y, YUV, YCoCg, YDzDx and ICtCp in 4:4:4, 4:2:2, 4:2:0 and 4:1:1 chroma subsampling factors.
	*Progressive and interlaced content.		*Progressive and interlaced content.

	Fmtconv is ~~focused~~ primarily on quality and exactness rather than execution speed. This does not mean it is slow or ~~un-optimized~~, but fmtconv is clearly not on par with the fastest equivalent 8-bit filters.		Fmtconv is focussed primarily on quality and exactness rather than execution speed. This does not mean it is slow or unoptimized, but fmtconv is clearly not on par with the fastest equivalent 8-bit filters.
			See [https://htmlpreview.github.io/?https://github.com/EleonoreMizo/fmtconv/blob/master/doc/fmtconv.html doc/fmtconv.html on github] for more information.
	See doc/fmtconv.html for more information.
	<br>		<br>
	<br>		<br>

Kogarou: fixing the book's link

2022-07-06T01:45:33Z

fixing the book's link

← Older revision		Revision as of 03:45, 6 July 2022
Line 256:		Line 256:
	You must supply the full description of the original and target gamuts, with the built-in presets or by setting individual components.		You must supply the full description of the original and target gamuts, with the built-in presets or by setting individual components.

	Please note that this function does not work at the same level as matrix. The latter converts between gamma-compressed RGB and YUV-like colorspaces, while primaries operates on linear RGB colorspaces exclusively, whose specifications are given by the primaries. For more details, see [https://web.archive.org/web/20220306120040/http://poynton.ca/PDFs/Guided_tour.pdf\|Charles Poynton, A Guided Tour of Color Space, 1997].		Please note that this function does not work at the same level as matrix. The latter converts between gamma-compressed RGB and YUV-like colorspaces, while primaries operates on linear RGB colorspaces exclusively, whose specifications are given by the primaries. For more details, see [https://web.archive.org/web/20220306120040/http://poynton.ca/PDFs/Guided_tour.pdf Charles Poynton, A Guided Tour of Color Space, 1997].

	The [[Internal_functions#Primaries\|_Primaries]] frame property is set or deleted, depending on the target gamut.		The [[Internal_functions#Primaries\|_Primaries]] frame property is set or deleted, depending on the target gamut.

Kogarou: Another minor edit

2022-07-03T18:14:02Z

Another minor edit

← Older revision		Revision as of 20:14, 3 July 2022
Line 626:		Line 626:
	:::*"DV" : For 4:2:0 modes, it’s like MPEG-2 but U and V channels are “co-sited” vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.		:::*"DV" : For 4:2:0 modes, it’s like MPEG-2 but U and V channels are “co-sited” vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.
	:::*"top_left", "tl" : Chroma samples are located on the top-left luma sample of each pixel group.		:::*"top_left", "tl" : Chroma samples are located on the top-left luma sample of each pixel group.
	:::The chroma placement is ignored when center is set to False or kernel to "point". You’ll find below an overview of common chroma placement and subsampling combinations:		:::The chroma placement is ignored when center is set to False or kernel to "point". You’ll find below an overview of common chroma placement and subsampling combinations.
	:::Graphical examples of chroma placements can be found ~~in the github:~~ [https://raw.githubusercontent.com/EleonoreMizo/fmtconv/master/doc/colorspace-subsampling.png]		:::Graphical examples of chroma placements can be found [https://raw.githubusercontent.com/EleonoreMizo/fmtconv/master/doc/colorspace-subsampling.png in the github].
	<br>		<br>
	::{{Par2\|interlaced\|int\|2}}		::{{Par2\|interlaced\|int\|2}}

Kogarou: Small edit to the colorspace subsampling example

2022-07-03T18:09:17Z

Small edit to the colorspace subsampling example

← Older revision		Revision as of 20:09, 3 July 2022
Line 627:		Line 627:
	:::*"top_left", "tl" : Chroma samples are located on the top-left luma sample of each pixel group.		:::*"top_left", "tl" : Chroma samples are located on the top-left luma sample of each pixel group.
	:::The chroma placement is ignored when center is set to False or kernel to "point". You’ll find below an overview of common chroma placement and subsampling combinations:		:::The chroma placement is ignored when center is set to False or kernel to "point". You’ll find below an overview of common chroma placement and subsampling combinations:
	~~Chroma placement~~		:::Graphical examples of chroma placements can be found in the github: [https://raw.githubusercontent.com/EleonoreMizo/fmtconv/master/doc/colorspace-subsampling.png]
	~~(image~~:https://raw.githubusercontent.com/EleonoreMizo/fmtconv/master/doc/colorspace-subsampling.png)
	<br>		<br>
	::{{Par2\|interlaced\|int\|2}}		::{{Par2\|interlaced\|int\|2}}

Reel.Deal: change link to releases page since it's always up-to-date

2022-06-29T00:20:04Z

change link to releases page since it's always up-to-date

← Older revision		Revision as of 02:20, 29 June 2022
Line 3:		Line 3:
	\|1={{Author/cretindesalpes}}		\|1={{Author/cretindesalpes}}
	\|2=r29		\|2=r29
	\|3=[https://github.com/EleonoreMizo/fmtconv/releases/~~tag/r29~~ fmtconv-r29.zip]		\|3=[https://github.com/EleonoreMizo/fmtconv/releases/ fmtconv-r29.zip]
	\|4=Resize		\|4=Resize
	\|5=Open source		\|5=Open source

Kogarou: DL link fixed

2022-06-27T21:53:00Z

DL link fixed

← Older revision		Revision as of 23:53, 27 June 2022
Line 3:		Line 3:
	\|1={{Author/cretindesalpes}}		\|1={{Author/cretindesalpes}}
	\|2=r29		\|2=r29
	\|3=[https://github.com/EleonoreMizo/fmtconv/releases/~~download~~/r29/fmtconv-r29.zip]		\|3=[https://github.com/EleonoreMizo/fmtconv/releases/tag/r29 fmtconv-r29.zip]
	\|4=Resize		\|4=Resize
	\|5=Open source		\|5=Open source

Kogarou: plugin version update

2022-06-27T21:50:29Z

plugin version update

← Older revision		Revision as of 23:50, 27 June 2022
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|1={{Author/cretindesalpes}}		\|1={{Author/cretindesalpes}}
	\|2=~~r24~~		\|2=r29
	\|3=[https://github.com/EleonoreMizo/fmtconv/releases fmtconv-~~r24~~.zip]		\|3=[https://github.com/EleonoreMizo/fmtconv/releases/download/r29/fmtconv-r29.zip]
	\|4=Resize		\|4=Resize
	\|5=Open source		\|5=Open source
Line 584:		Line 584:
	:::Set these parameter to True to activate the kernel inversion mode for the specified direction (use invks for both). Inverting the kernel allows to “undo” a previous upsizing by compensating the loss in high frequencies, giving a sharper and more accurate output than classic kernels, closer to the original. This is particularly useful for clips upscaled with a bilinear kernel. All the kernel-related parameters specify the kernel to undo. The target resolution must be as close as possible to the initial resolution. The kernel inversion is mainly intended to downsize an upscaled picture. Using it for upsizing will not restore details but will give a sligthly sharper look, at the cost of a bit of aliasing and ringing. This mode is somewhat equivalent to the debilinear plug-in but works with a different principle.		:::Set these parameter to True to activate the kernel inversion mode for the specified direction (use invks for both). Inverting the kernel allows to “undo” a previous upsizing by compensating the loss in high frequencies, giving a sharper and more accurate output than classic kernels, closer to the original. This is particularly useful for clips upscaled with a bilinear kernel. All the kernel-related parameters specify the kernel to undo. The target resolution must be as close as possible to the initial resolution. The kernel inversion is mainly intended to downsize an upscaled picture. Using it for upsizing will not restore details but will give a sligthly sharper look, at the cost of a bit of aliasing and ringing. This mode is somewhat equivalent to the debilinear plug-in but works with a different principle.
	<br>		<br>
	::{{Par2\|invkstaps\|arrayi\|(4)}}		::{{Par2\|invkstaps\|arrayi\|4}}
	::{{Par2\|invkstapsh\|arrayi\|invkstaps}}		::{{Par2\|invkstapsh\|arrayi\|invkstaps}}
	::{{Par2\|invkstapsv\|arrayi\|invkstaps}}		::{{Par2\|invkstapsv\|arrayi\|invkstaps}}
Line 634:		Line 634:
	:::Specifies if the clip is made of frames or fields. interlacedd overrides interlaced for output.		:::Specifies if the clip is made of frames or fields. interlacedd overrides interlaced for output.
	:::*0 : Frames are progressive content.		:::*0 : Frames are progressive content.
	:::*1 : Frames are actually the separated fields of an interlaced stream. Specify tff or provide the _Field property in all the frames.		:::*1 : Frames are actually the separated fields of an interlaced stream. Specify tff or provide the [[Internal_functions#Field\|_Field]] property in all the frames.
	:::*2 : Automatic detection, depends on the _FieldBased frame property. If not found, the frame is considered progressive.		:::*2 : Automatic detection, depends on the [[Internal_functions#FieldBased\|_FieldBased]] frame property. If not found, the frame is considered progressive.
	<br>		<br>
	::{{Par2\|tff\|int\|2}}		::{{Par2\|tff\|int\|2}}
Line 642:		Line 642:
	:::*0 : Bottom field first (BFF). This means all even fields are top, and all odd fields are bottom.		:::*0 : Bottom field first (BFF). This means all even fields are top, and all odd fields are bottom.
	:::*1 : Top field first (TFF). This means all even fields are bottom, and all odd fields are top.		:::*1 : Top field first (TFF). This means all even fields are bottom, and all odd fields are top.
	:::*2 : Automatic detection, depends on the _Field frame property. If not found, the frame is considered progressive.		:::*2 : Automatic detection, depends on the [[Internal_functions#Field\|_Field]] frame property. If not found, the frame is considered progressive.
	<br>		<br>
	::{{Par2\|flt\|bool\|false}}		::{{Par2\|flt\|bool\|false}}

Kogarou: finished fmtc_resample (!!)

2022-06-27T21:45:45Z

finished fmtc_resample (!!)

Show changes