PixelShiftPlus - Revision history

Reel.Deal: /* Syntax and Parameters */

2022-12-11T05:56:30Z

‎Syntax and Parameters

Reel.Deal at 05:54, 11 December 2022

2022-12-11T05:54:35Z

Reel.Deal: v1.1.0

2022-12-11T05:54:20Z

v1.1.0

Reel.Deal: PixelShiftPlus v1.0.0

2022-11-30T01:00:00Z

PixelShiftPlus v1.0.0

New page

{{FilterCat5|External_filters|Scripts|Restoration_filters|Chroma correction|Deep_color_tools}}
{{Filter3
|1=reel.deal
|2=v1.0.0
|3=[https://github.com/Reel-Deal/AviSynthPlus-Scripts/blob/main/pixelshiftplus.avsi pixelshiftplus.avsi]
|4=Chroma Correction
|5=
|6=}}
== Description ==
[[PixelShiftPlus]] is a script to independently shift pixels with subpixel accuracy. 
It includes 3 functions:
* PixelShiftRGB – shift any plane in an RGB(A) clip.
* PixelShiftYUV – shift any plane in a YUV(A) clip.
* PixelShiftUV – shift the chroma in a YUV(A) clip. Similar to ChromaShiftSP2.
 
== Requirements ==
* [x86/x64]: [[AviSynth+]]
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
* Optional plugin: [[FillBorders]] (only if specified by <code>Mode</code>)
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|PixelShiftRGB (clip input, float "RX", float "RY", float "GX", float "GY", float "BX", float "BY", float "AX", float "AY", string "Resizer", int "Mode", bool "Inverse")}}
:{{Template:FuncDef|PixelShiftYUV (clip input, float "YX", float "YY", float "UX", float "UY", float "VX", float "VY", float "AX", float "AY", string "Resizer", bool "ChromaPixels", int "Mode", bool "Inverse")}}
:{{Template:FuncDef|PixelShiftUV (clip input, float "UX", float "UY", float "VX", float "VY", string "Resizer", bool "ChromaPixels", int "Mode", bool "Inverse")}}
 
::{{Par2| |clip| }}
:::Input clip.
:::PixelShiftRGB: all RGB(A) colorspaces are supported.
:::PixelShiftY(UV): all YUV(A) colorspaces are supported.
 
::{{Par2|RX, RY, GX, GY, BX, BY, AX, AY|float|0.0}}
::{{Par2|YX, YY, UX, UY, VX, VY, AX, AY|float|0.0}}
:::Specify the shift amount in each (R, G, B, A) or (Y, U, V, A) plane.
:::*(X) horizontal shift: positive values shift left, negative values right.
:::* (Y) vertical shift: positive values shift upwards, negative values downwards.
:::Note that the shifting direction will be reversed if <code>Inverse=true</code>.
 
::{{Par2|Resizer|string|"Spline36"}}
:::Resizer to use to shift planes.
:::Available options: <code>"Bicubic", "Bilinear", "Blackman", "Gauss", "Lanczos", "Lanczos4", "Point", "Sinc", "Spline16", "Spline36", "Spline64"</code>.
:::Note that <code>"Point"</code> cannot do subpixel shifting because it uses only integer pixel coordinates, float values will be rounded.
 
::{{Par2|ChromaPixels|bool|false}}
:::By default, the X and Y shift values of the chroma planes are shifted in "luma pixels", meaning that the shift values are divided by the subsampling ratio of the input clip.
:::For example:
:::*YUV420, the X and Y shift values are divided by 2 since the chroma planes are half the width and height of the luma plane.
:::*YUV422 or YUV411, only the X shift value is divided by 2 and 4, respectively.
:::*YUV444, has no effect since the chroma planes are the same size as the luma.
:::When <code>Resizer="Point"</code>, this parameter is ignored and set to true.
:::When set to true, the X and Y shift values are not divided.
 
::{{Par2|Mode|int|1}}
:::Border mode:
:::* 0 : "fillmargins" - top and bottom borders are filled with a weighted average of its three neighbours from the previous line. Left and right borders are repeated, as in mode 1.
:::* 1 : "repeat" - fills the borders using the outermost line or column.
:::* 2 : "mirror" - fills the borders by mirroring.
:::* 3 : "reflect" - fills the borders by reflecting (whole sample symmetric).
:::* 4 : "wrap" - fills the borders by wrapping.
:::* 5 : "fade" - fills the borders to constant value.
:::* 6 : "fixborders" - A direction "aware" modification of FillMargins. It also works on all four sides.
:::Default: 1 (all other modes require the [[FillBorders]] plugin)
 
::{{Par2|Inverse|int|false}}
:::If true, it will reverse the shifting direction:
:::*(X) horizontal shift: negative values shift left, positive values right.
:::*(Y) vertical shift: negative values shift upwards, positive values downwards.
 
== Examples ==
Move chroma left 3.2 pixels and down 1.6 pixels:
[[AviSource]]("Blah.avi")
PixelShiftUV (UX=3.2, UY=-1.6, VX=3.2, VY=-1.6)

 
== Changelog ==
Version Date Changes 
v1.0.0 2022/11/29 - Initial release
 
== External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Chroma_correction|External Filters]] ←'''

@@ Line 49: / Line 49: @@
 :::*YUV422 or YUV411, only the X shift value is divided by 2 and 4, respectively.
 :::*YUV444, has no effect since the chroma planes are the same size as the luma.
 :::When set to true, the X and Y shift values are not divided.
 <br>
@@ Line 68: / Line 67: @@
 :::*(Y) vertical shift: negative values shift upwards, positive values downwards.
 <br>
 == Examples ==
 Move both chroma planes left 3.2 pixels and down 1.6 pixels:

@@ Line 2: / Line 2: @@
 {{Filter3
 |1=reel.deal
-|2=v1.0.0
+|2=v1.1.0
 |3=[https://github.com/Reel-Deal/AviSynthPlus-Scripts/blob/main/pixelshiftplus.avsi pixelshiftplus.avsi]
 |4=Chroma Correction

@@ Line 9: / Line 9: @@
 == Description ==
 [[PixelShiftPlus]] is a script to independently shift pixels with subpixel accuracy.<br>
-It includes 3 functions:
+It includes 4 functions:
 * PixelShiftRGB – shift any plane in an RGB(A) clip.
 * PixelShiftYUV – shift any plane in a YUV(A) clip.
 * PixelShiftUV – shift the chroma in a YUV(A) clip. Similar to ChromaShiftSP2.
 <br>
 == Requirements ==
@@ Line 23: / Line 24: @@
 :{{Template:FuncDef|PixelShiftYUV (clip input, float "YX", float "YY", float "UX", float "UY", float "VX", float "VY", float "AX", float "AY", string "Resizer", bool "ChromaPixels", int "Mode", bool "Inverse")}}
 :{{Template:FuncDef|PixelShiftUV (clip input, float "UX", float "UY", float "VX", float "VY", string "Resizer", bool "ChromaPixels", int "Mode", bool "Inverse")}}
 <br>
 ::{{Par2| |clip| }}
@@ Line 67: / Line 69: @@
 <br>
 == Examples ==
-Move chroma left 3.2 pixels and down 1.6 pixels:
+Move both chroma planes left 3.2 pixels and down 1.6 pixels:
   [[AviSource]]("Blah.avi")
-  PixelShiftUV (UX=3.2, UY=-1.6, VX=3.2, VY=-1.6)
+  PixelShiftUV(UX=3.2, UY=-1.6, VX=3.2, VY=-1.6) # same as PixelShiftC(X=3.2, Y=-1.6)
 <br>
 == Changelog ==
   Version      Date            Changes<br>
   v1.0.0       2022/11/29      - Initial release
 <br>