PlanarTools

Revision as of 20:03, 22 April 2020

Description

This plugin is a set of filters that offers converting packed(interleaved) formats to planar formats and vice versa.

AviSynth has these already as internal filters, but those are a little difficult to use, and optimization is insufficient.

Requirements

• [x86]: AviSynth+ or AviSynth 2.6
• [x64]: AviSynth+
• Supported color formats: RGB24, RGB32, YUY2, Y8, YV12, YV16, YV24
• SSE2 Capable CPU

• Microsoft Visual C++ 2015 Redistributable Package (x86 / x64)

*** vcredist_x86.exe is required for modPlus-x86

*** vcredist_x64.exe is required for modPlus-x64

Syntax and Parameters

PackedToPlanar

Convert packed format to planar format without changing the pixel values.

PackedToPlanar (clip clip)

clip   =

Input clip must be RGB24, RGB32, or YUY2. Output format is YV24(RGB24, RGB32) or YV16(YUY2).

ExtractPlane

Extract a color channel from packed format, and output as a Y8 clip.

PackedToPlanar (clip clip, int "plane")

clip   =

Input clip must be RGB24, RGB32, or YUY2.

int  plane =

Color channel to extract. Default is 0 for (RGB24/YUY2) or 3 for (RGB32).

• 0 : Blue(RGB24/RGB32) or Y(YUY2)
• 1 : Green(RGB24/RGB32) or U(YUY2)
• 2 : Red(RGB24/RGB32) or V(YUY2). 3: Alpha(RGB32)

This is same as ShowGreen/ShowBlue/ShowRed/ShowAlpha(on RGB) or ConvertToY8/UToY8/VToY8(on YUY2), but faster.

PlanarToRGB32

Make a RGB32 clip from multiple planar format clips without changing the pixel values.

PlanarToRGB32(clip base, clip alpha)

PlanarToRGB32(clip green, clip blue, clip red, clip alpha)

clip   =

Base clip: YV24 only. Each planes are mapped as follows: Y : Green | U : Blue | V : Red

clip   =

clip   =

clip   =

Green, blue, red - planar formats clips. Only Y-planes are used.

clip   =

Alpha - planar format. Only Y-plane is used. must be the same resolution of others.

RGBToRGB

Convert RGB24 clip to RGB32, and vice versa.

RGBToRGB (clip clip)

clip   =

Input clip must be RGB24 or RGB32.

Examples

TODO

Notes

• All filters are SSE2 optimized. Thus these will cause crash on No SSE2 machine.
• RGBToRGB requires SSSE3. If SSSE3 is not available on your machine, it invoke internal ConvertToRGB24/ConvertToRGB32 filter instead.

External Links

• GitHub - Source code repository.

Back to External Filters ←