MaskTools2/mt lutspa - Revision history

Reel.Deal: /* Examples */ change the order of gradients and add sources for examples

2022-01-22T05:33:37Z

‎Examples: change the order of gradients and add sources for examples

Reel.Deal: /* Examples */ add gradient pictures ans corresponding RPM expression and also make a table

2015-09-16T20:52:18Z

‎Examples: add gradient pictures ans corresponding RPM expression and also make a table

Reel.Deal: /* Examples */ add pictures ans corresponding RPM expression

2015-09-16T18:23:43Z

‎Examples: add pictures ans corresponding RPM expression

Reel.Deal: mt_lutspa

2015-09-16T16:11:15Z

mt_lutspa

New page

{{FilterCat4|External_filters|Plugin_functions|Other_filters|Support_filters}}
Computes the value of a pixel according to its spatial position.
 
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|mt_lutspa (clip, string "mode", bool "relative", bool "biased", string "expr", string "yExpr", string "uExpr", string "vExpr", int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")}}
 
::{{Par2| |clip| }}
:::The clip is used as a template (for the frame count, the width, the height and the colorspace).
 
::{{Par2|mode|string|"relative"}}
:::mode controls how the pixels coordinates are transformed into a value. It overrides the legacy parameters, relative and biased.
:::Possible values for mode are :
:::*"absolute" : x and y go from 0 to width - 1 and height - 1. Equivalent to relative = false.
:::*"relative", or "relative opened", or "relative exclusive" : x and y go from 0 to 1 (excluded). Equivalent to relative = true, biased = true.
:::*"relative closed", or "relative inclusive" : x and y go from 0 to 1 (included). Equivalent to relative = true, biased = false.
 
::{{Par2|relative|bool|true}}
:::relative, defaulted to true, indicates whether x & y should be absolute (x ranging from 0 to the clip's width, y from 0 to the height), or relative (x & y ranging from 0 to 1).
 
::{{Par2|biased|bool|true}}
:::biased is used only when relative is true, and indicates whether x and y range from 0 to 1 included (biased = false) or excluded (biased = true).
 
::{{Par2|expr|string|"x"}}
::{{Par2|yExpr|string|"x"}}
::{{Par2|uExpr|string|"x"}}
::{{Par2|vExpr|string|"x"}}
:::It computes the value of each pixels according to its coordinates and the given lut. Variable x and y in the lut corresponds respectively to absciss and ordinate of the pixel.
 
::{{Par2|Y|int|3}}
::{{Par2|U|int|1}}
::{{Par2|V|int|1}}
:::These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded :
::::*x = -255...0 : all the pixels of the plane will be set to -x.
::::*x = 1 : the plane will not be processed. That means the content of the plane after the filter is pure garbage.
::::*x = 2 : the plane of the first input clip will be copied.
::::*x = 3 : the plane will be processed with the processing the filter is designed to do.
 
::{{Par2|chroma|string|""}}
:::When defined, the value contained in this string will overwrite the {{Template:FuncDef3|U}} and {{Template:FuncDef3|V}} processing modes.
:::This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
::::*"process" : set u = v = 3.
::::*"copy" or "copy first" : set u = v = 2.
::::*"xxx", where xxx is a number : set u = v = -xxx.
 
::{{Par2|offX|int|0}}
::{{Par2|offY|int|0}}
:::{{Template:FuncDef3|offX}} and {{Template:FuncDef3|offY}} are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.
 
::{{Par2|w|int|-1}}
::{{Par2|h|int|-1}}
:::{{Template:FuncDef3|w}} and {{Template:FuncDef3|h}} are the width and height of the processed box. -1 means that the box extends to the lower right corner of the video. That also means that default settings are meant to process the whole picture.
 
== Examples ==
'''TO DO!'''
 
 
-----------------------------------------------
'''Back to [[MaskTools2#Filters|MaskTools2]] ←'''
-----------------------------------------------

@@ Line 64: / Line 64: @@
 :[[File:mt_lutspa_vlines1.png]]
+|
-* <code>mt_lutspa(expr="x 2 ^ y 2 ^ + 2 / 0.5 ^ 256 *")</code>
+*<code>mt_lutspa(mode="relative", expr="x 255 *")</code>
-[[File:mt_lutspa_gradient1.png]]
+[[File:mt_lutspa_gradient4.png]]
 |-
+|
@@ Line 78: / Line 78: @@
 :[[File:mt_lutspa_hlines2.png‎]]
+|
-*<code>mt_lutspa("absolute", expr="y 800 >= y 1000 <= & 255 y 800 y 1050 < & y 1050 – abs 5.1 * 0 ? ? ?")</code>
+* <code>mt_lutspa(expr="x 2 ^ y 2 ^ + 2 / 0.5 ^ 256 *")</code>
-[[File:mt_lutspa_gradient3.png]]
+[[File:mt_lutspa_gradient1.png]]
 |-
+|
-*<code>mt_lutspa(relative=false, expr="y 6 % 0.01 < 0 255 ?")</code>
+*<code>[https://forum.doom9.org/showthread.php?p=1433058#post1433058 mt_lutspa(relative=false, expr="y 6 % 0.01 < 0 255 ?")]</code>
 :[[File:mt_lutspa_hlines3.png‎]]
+|
-*<code>mt_lutspa(mode="relative", expr="x 255 *")</code>
+*<code>mt_lutspa("absolute", expr="y 800 >= y 1000 <= & 255 y 800 y 1050 < & y 1050 – abs 5.1 * 0 ? ? ?")</code>
-[[File:mt_lutspa_gradient4.png]]
+[[File:mt_lutspa_gradient3.png]]
 |-
+|
@@ Line 92: / Line 92: @@
 :[[File:mt_lutspa_checkerboard.png‎‎]]
+|
-*<code>mt_lutspa(mode="relative", expr="x 1 2 / - abs y 1 2 / - abs + 256 *")</code>
+*<code>[https://forum.doom9.org/showthread.php?p=1219924#post1219924  mt_lutspa(mode="relative", expr="x 1 2 / - abs y 1 2 / - abs + 256 *")]</code>
 [[File:mt_lutspa_gradient5.png]]
 |-
@@ Line 99: / Line 99: @@
 :[[File:mt_lutspa_grid.png‎]]
+|
-* <code>mt_lutspa(mode="relative", expr="x y 1 x - 1 y - * * * 4096 *")</code>
+*<code>[https://web.archive.org/web/20181111105049/https://www.nmm-hd.org/newbbs/viewtopic.php?t=770#p6981 mt_lutspa(mode="relative", expr="x y 1 x - 1 y - * * * 4096 *")]</code>
 [[File:mt_lutspa_gradient6.png]]
 |}

← Older revision		Revision as of 20:52, 16 September 2015
Line 55:		Line 55:
	For the following examples lets assume our input clip is: <code>[[BlankClip\|BlankClip(width=128, height=128, pixel_type="Y8")]]</code>		For the following examples lets assume our input clip is: <code>[[BlankClip\|BlankClip(width=128, height=128, pixel_type="Y8")]]</code>

−	====Lines and Patterns=~~===~~	+	:{\| class="wikitable" border="1"; width="100%"
−	* <code>mt_lutspa(mode="absolute", expr="x 32 % 16 < 0 255 ?")</code>	+	\|-
		+	!!width="50%"\| Lines and Patterns
		+	!!width="50%"\| Gradients
		+	\|-
		+	\|
		+	*<code>mt_lutspa(mode="absolute", expr="x 32 % 16 < 0 255 ?")</code>
	:[[File:mt_lutspa_vlines1.png]]		:[[File:mt_lutspa_vlines1.png]]
−		+	\|
		+	* <code>mt_lutspa(expr="x 2 ^ y 2 ^ + 2 / 0.5 ^ 256 *")</code>
		+	[[File:mt_lutspa_gradient1.png]]
		+	\|-
		+	\|
	<code>mt_lutspa(mode="relative", expr="y 32 480 / - 82 480 / / pi sin 128 * 128 +")</code>		<code>mt_lutspa(mode="relative", expr="y 32 480 / - 82 480 / / pi sin 128 * 128 +")</code>
	:[[File:mt_lutspa_hlines1.png]]		:[[File:mt_lutspa_hlines1.png]]
−		+	\|
		+	<code>mt_lutspa(mode="relative", expr="x y + 256 2 /")</code>
		+	[[File:mt_lutspa_gradient2.png]]
		+	\|-
		+	\|
	*<code>mt_lutspa(relative=false, expr="y 5 % 0.01 < 55 y 5 % 1.1 < 200 y 5 % 3.9 > 200 255 ? ? ?")</code>		*<code>mt_lutspa(relative=false, expr="y 5 % 0.01 < 55 y 5 % 1.1 < 200 y 5 % 3.9 > 200 255 ? ? ?")</code>
	:[[File:mt_lutspa_hlines2.png‎]]		:[[File:mt_lutspa_hlines2.png‎]]
−		+	\|
		+	<code>mt_lutspa("absolute", expr="y 800 >= y 1000 <= & 255 y 800 y 1050 < & y 1050 – abs 5.1 0 ? ? ?")</code>
		+	[[File:mt_lutspa_gradient3.png]]
		+	\|-
		+	\|
	*<code>mt_lutspa(relative=false, expr="y 6 % 0.01 < 0 255 ?")</code>		*<code>mt_lutspa(relative=false, expr="y 6 % 0.01 < 0 255 ?")</code>
	:[[File:mt_lutspa_hlines3.png‎]]		:[[File:mt_lutspa_hlines3.png‎]]
−		+	\|
		+	<code>mt_lutspa(mode="relative", expr="x 255 ")</code>
		+	[[File:mt_lutspa_gradient4.png]]
		+	\|-
		+	\|
	*<code>mt_lutspa(mode="absolute", expr="x 32 % 16 < 0 1 ? y 32 % 16 < 0 1 ? + 1 == 0 255 ?")</code>		*<code>mt_lutspa(mode="absolute", expr="x 32 % 16 < 0 1 ? y 32 % 16 < 0 1 ? + 1 == 0 255 ?")</code>
	:[[File:mt_lutspa_checkerboard.png‎‎]]		:[[File:mt_lutspa_checkerboard.png‎‎]]
−		+	\|
		+	<code>mt_lutspa(mode="relative", expr="x 1 2 / - abs y 1 2 / - abs + 256 ")</code>
		+	[[File:mt_lutspa_gradient5.png]]
		+	\|-
		+	\|
	*<code>mt_lutspa(relative=false, expr="x 16 % 0 == y 16 % 0 == \| 255 0 ?")</code>		*<code>mt_lutspa(relative=false, expr="x 16 % 0 == y 16 % 0 == \| 255 0 ?")</code>
	:[[File:mt_lutspa_grid.png‎]]		:[[File:mt_lutspa_grid.png‎]]
−		+	\|
−		+	* <code>mt_lutspa(mode="relative", expr="x y 1 x - 1 y - * * * 4096 *")</code>
−	~~====Gradients==~~==	+	[[File:mt_lutspa_gradient6.png]]
−	~~'''TO DO'''~~	+	\|}
−	~~<br>~~	+
	<br>		<br>
	<br>		<br>

@@ Line 53: / Line 53: @@
 <br>
 == Examples ==
-'''TO DO!'''
+For the following examples lets assume our input clip is: <code>[[BlankClip|BlankClip(width=128, height=128, pixel_type="Y8")]]</code>
 <br>
 <br>