Using Filters

   Print  Previous  Next

Introduction

You can use filters in order to render your output differently.

The functions look as follows:

void Filter(int filter);
void SetFilter(int filter);

 

These functions basically work wherever a matrix is used, which is the case with the MAS Script Effect, Macros for Effects, the Storage Place Macro, and the Global Macro. Insert one of these functions into PostRenderEffect in order to use it.
Filters are useful tools to manipulate every MADRIX effect, videos, and images.
Several filters can be applied/used at the same time.

 

Filter Constants

Filters are divided into several groups, such as color correction filters or style filters, for example.

Identifier / Filter (FX)

Description

General Filters

int FILTER_NONE

Deactivates the filter.

Blur / Sharpen Filters

int FILTER_BLUR

This filter blurs the output.

int FILTER_BLUR_BSPLINE

This filter blurs the output applying a B-spline.

int FILTER_BLUR_CATMULL_ROM

This filter blurs the output applying a Catmull-Rom spline.

int FILTER_BLUR_GAUSS

This filter blurs the output applying the Gaussian function.

int FILTER_BLUR_MITCHELL

This filter blurs the output applying the Mitchell-Netravali function.

int FILTER_SHARPEN

This filter sharpens the output.

Brightness Graph Filters

int FILTER_BRIGHTNESS_GRAPH_XYZ

This filter displays the distribution of the color intensity on the y-axis.

int FILTER_BRIGHTNESS_GRAPH_XZY

This filter displays the distribution of the color intensity on the z-axis.

int FILTER_BRIGHTNESS_GRAPH_YXZ

This filter displays the distribution of the color intensity on the x-axis.

Color Correction Filters

int FILTER_BRIGHTEN

The brighten filter to light up the whole matrix.

int FILTER_DARKEN

The darken filter to darken the whole matrix.

int FILTER_GRAYSCALE

The grayscale filter to render the matrix grayscale, i.e. in gray colors.

int FILTER_INVERT_COLOR

The invert color filter to invert every color channel.

Color Swap Filters

int FILTER_RGB_TO_BGR

The filter reorders the color channels to blue, green, red. The white color channel remains unchanged.

int FILTER_RGB_TO_BRG

The filter reorders the color channels to blue, red, green. The white color channel remains unchanged.

int FILTER_RGB_TO_GRB

The filter reorders the color channels to green, red, blue. The white color channel remains unchanged.

int FILTER_RGB_TO_GBR

The filter reorders the color channels to green, blue, red. The white color channel remains unchanged.

int FILTER_RGB_TO_RBG

The filter reorders the color channels to red, blue, green. The white color channel remains unchanged.

int FILTER_RGBW_TO_WBGR

The filter reorders the color channels to white, blue, green, red.

int FILTER_RGBW_TO_WBRG

The filter reorders the color channels to white, blue, red, green.

int FILTER_RGBW_TO_WGRB

The filter reorders the color channels to white, green, red, blue.

int FILTER_RGBW_TO_WGBR

The filter reorders the color channels to white, green, blue, red.

int FILTER_RGBW_TO_WRBG

The filter reorders the color channels to white, red, blue, green.

int FILTER_RGBW_TO_WRGB

The filter reorders the color channels to white, red, green, blue.

int FILTER_RGBW_TO_BWGR

The filter reorders the color channels to blue, white, green, red.

int FILTER_RGBW_TO_BWRG

The filter reorders the color channels to blue, white, red, green.

int FILTER_RGBW_TO_GWRB

The filter reorders the color channels to green, white, red, blue.

int FILTER_RGBW_TO_GWBR

The filter reorders the color channels to green, white, blue, red.

int FILTER_RGBW_TO_RWBG

The filter reorders the color channels to red, white, blue, green.

int FILTER_RGBW_TO_RWGB

The filter reorders the color channels to red, white, green, blue.

int FILTER_RGBW_TO_BGWR

The filter reorders the color channels to blue, green, white, red.

int FILTER_RGBW_TO_BRWG

The filter reorders the color channels to blue, red, white, green.

int FILTER_RGBW_TO_GRWB

The filter reorders the color channels to green, red, white, blue.

int FILTER_RGBW_TO_GBWR

The filter reorders the color channels to green, blue, white, red.

int FILTER_RGBW_TO_RBWG

The filter reorders the color channels to red, blue, white, green.

int FILTER_RGBW_TO_RGWB

The filter reorders the color channels to red, green, white, blue.

Color Mask Filters

int FILTER_RED

The red filter to filter out every color except the red color channel.

int FILTER_GREEN

The green filter to filter out every color except the green color channel.

int FILTER_BLUE

The blue filter to filter out every color except the blue color channel.

int FILTER_WHITE

The white filter to filter out every color except the white color channel.

int FILTER_RED_GREEN

The red/green filter to filter out every color except the red and the green color channel.

int FILTER_RED_BLUE

The red/blue filter to filter out every color except the red and the blue color channel.

int FILTER_GREEN_BLUE

The green/blue filter to filter out every color except the green and the blue color channel.

int FILTER_RED_WHITE

The red/white filter to filter out every color except the red and the white color channel.

int FILTER_GREEN_WHITE

The green/white filter to filter out every color except the green and the white color channel.

int FILTER_BLUE_WHITE

The blue/white filter to filter out every color except the blue and the white color channel.

int FILTER_RED_GREEN_BLUE

The red/green/blue filter to filter out every color except the red, the green, and the blue color channel.

int FILTER_RED_GREEN_WHITE

The red/green/white filter to filter out every color except the red, the green, and the white color channel.

int FILTER_RED_BLUE_WHITE

The red/blue/white filter to filter out every color except the red, the blue, and the white color channel.

int FILTER_GREEN_BLUE_WHITE

The green/blue/white filter to filter out every color except the green, the blue, and the white color channel.

Kaleidoscope Filters

int FILTER_KALEIDOSCOPE_6X

The 6x mix mode.

int FILTER_KALEIDOSCOPE_8X

The 8x mix mode.

int FILTER_KALEIDOSCOPE_12X

The 12x mix mode.

Style Filters

int FILTER_EDGES

The edges filter to make the edges of objects/motifs stand out.

int FILTER_EDGES_POPUP

The edges popup filter to make the edges of objects/motifs stand out.

int FILTER_EMBOSS

The emboss filter to create an image with just highlights and shadows.

int FILTER_EMBOSS_POPUP

The emboss popup filter to create an image with just highlights and shadows depending on the motif.

Mirror Filters

int FILTER_INVERT_H_MATRIX

The filter flips the matrix horizontally.

int FILTER_INVERT_V_MATRIX

The filter flips the matrix vertically.

int FILTER_INVERT_HV_MATRIX

The filter flips the matrix horizontally and vertically. Therefore it instantly rotates the matrix by 180°.

int FILTER_INVERT_D_MATRIX

The filter flips the matrix regarding the depth.

int FILTER_INVERT_HD_MATRIX

The filter flips the matrix horizontally and regarding the depth.

int FILTER_INVERT_VD_MATRIX

The filter flips the matrix vertically and regarding the depth.

int FILTER_INVERT_HVD_MATRIX

The filter flips the matrix horizontally, vertically, and regarding the depth.

Swap Filters

int FILTER_SWAP_H_1X

This filter divides the matrix into 2 columns and transposes them.

int FILTER_SWAP_H_2X

This filter divides the matrix into 4 columns and transposes them.

int FILTER_SWAP_H_3X

This filter divides the matrix into 8 columns and transposes them.

int FILTER_SWAP_H_4X

This filter divides the matrix into 16 columns and transposes them.

int FILTER_SWAP_H_5X

This filter divides the matrix into 32 columns and transposes them.

int FILTER_SWAP_V_1X

This filter divides the matrix into 2 rows and transposes them.

int FILTER_SWAP_V_2X

This filter divides the matrix into 4 rows and transposes them.

int FILTER_SWAP_V_3X

This filter divides the matrix into 8 rows and transposes them.

int FILTER_SWAP_V_4X

This filter divides the matrix into 16 rows and transposes them.

int FILTER_SWAP_V_5X

This filter divides the matrix into 32 rows and transposes them.

int FILTER_SWAP_HV_1X

This filter divides the matrix into 2 columns and rows, and transposes them.

int FILTER_SWAP_HV_2X

This filter divides the matrix into 4 columns and rows, and transposes them.

int FILTER_SWAP_HV_3X

This filter divides the matrix into 8 columns and rows, and transposes them.

int FILTER_SWAP_HV_4X

This filter divides the matrix into 16 columns and rows, and transposes them.

int FILTER_SWAP_HV_5X

This filter divides the matrix into 32 columns and rows, and transposes them.

int FILTER_SWAP_D_1X

This filter divides the matrix into 2 depth segments and transposes them.

int FILTER_SWAP_D_2X

This filter divides the matrix into 4 depth segments and transposes them.

int FILTER_SWAP_D_3X

This filter divides the matrix into 8 depth segments and transposes them.

int FILTER_SWAP_D_4X

This filter divides the matrix into 16 depth segments and transposes them.

int FILTER_SWAP_D_5X

This filter divides the matrix into 32 depth segments and transposes them.

int FILTER_SWAP_HD_1X

This filter divides the matrix into 2 columns and depth segments, and transposes them.

int FILTER_SWAP_HD_2X

This filter divides the matrix into 4 columns and depth segments, and transposes them.

int FILTER_SWAP_HD_3X

This filter divides the matrix into 8 columns and depth segments, and transposes them.

int FILTER_SWAP_HD_4X

This filter divides the matrix into 16 columns and depth segments, and transposes them.

int FILTER_SWAP_HD_5X

This filter divides the matrix into 32 columns and depth segments, and transposes them.

int FILTER_SWAP_VD_1X

This filter divides the matrix into 2 rows and depth segments, and transposes them.

int FILTER_SWAP_VD_2X

This filter divides the matrix into 4 rows and depth segments, and transposes them.

int FILTER_SWAP_VD_3X

This filter divides the matrix into 8 rows and depth segments, and transposes them.

int FILTER_SWAP_VD_4X

This filter divides the matrix into 16 rows and depth segments, and transposes them.

int FILTER_SWAP_VD_5X

This filter divides the matrix into 32 rows and depth segments, and transposes them.

int FILTER_SWAP_HVD_1X

This filter divides the matrix into 2 columns, rows and depth segments, and transposes them.

int FILTER_SWAP_HVD_2X

This filter divides the matrix into 4 columns, rows and depth segments, and transposes them.

int FILTER_SWAP_HVD_3X

This filter divides the matrix into 8 columns, rows and depth segments, and transposes them.

int FILTER_SWAP_HVD_4X

This filter divides the matrix into 16 columns, rows and depth segments, and transposes them.

int FILTER_SWAP_HVD_5X

This filter divides the matrix into 32 columns, rows and depth segments, and transposes them.

 

Example

Paste the following example into the Global Macro Editor to see how this filter inverts all colors of your main output.

@scriptname="Filter: Invert Colors";

@author="";

@version="2.8";

@description="";

 

void InitEffect()

{}

 

void PreRenderEffect()

{}

 

void PostRenderEffect()

{                    

  Filter(FILTER_INVERT_COLOR); 

}

 

MADRIX Version: 5.1a | Script Version: 3.10
[Ctrl & +/-] = Zoom In/Out | [Ctrl & 0] = 100%
Print   Previous   Next