# Manipulate Visual Effects With the ColorMatrixFilter and ConvolutionFilter

The ColorMatrixFilter and ConvolutionFilter can be used to visually transform your Flash objects. In this article, I’ll show you how easy they are to manipulate, using a cool tool I built for simple experimentation.

## Introduction

Have you guys ever experimented with Flash’s ColorMatrix and Convolution filters? I was digging around in a quest to find some interesting stuff you can do with Flash and I bumped into them. Experimenting with them can deliver some awesome results.

I’ve written an EffectsTester to make it easy to experiment with them. Check out these camshots I took while playing around with it:

Now, if you find that interesting, let me walk you through what these two filters are all about.

## The Color Matrix Filter

The Color Matrix Filter is used to manipulate the color of a display object.

Let me explain the exact calculation performed by the ColorMatrixFilter. Every pixel in an image is a mixture of red, green, and blue. These primary colors, when combined, can make any other color:

Image from Wikimedia Commons. Thanks to Mike Horvath and jacobolus.

The amount of red in a pixel can vary from zero (no red at all) to 255. Same for green and blue. So, from the image above, you can see that a pure yellow pixel has red = 255, and green = 255. White has red, green, and blue all set to 255. Black has all three set to zero.

The color matrix filter looks at each pixel in a source image and changes them based on how much red, blue, and green is in the pixel. You end up with a whole new image; the destination image.

#### Here’s How it Works

First, let’s concentrate on these three values:

Let’s label these values a[0], a[1], and a[2] in turn. Now, think about just one single pixel in the entire source image (the one in the top-left corner will do). Let’s call the amount of red in that srcR, the amount of green srcG and the amount of blue srcB.

The question is: how much red will be in that pixel of the destination image, destR? Flash uses this calculation:

destR = ( a[0] * srcR ) + ( a[1] * srcG ) + ( a[2] * srcB );


Here you can see that a[0] is 1, while a[1] and a[2] are both zero, so:

destR =	( 1 * srcR ) + ( 0 * srcG ) + ( 0 * srcB );
//which means...
destR = srcR;


There’s no change! But what if we changed a[0] to zero and a[1] to 1? Then:

destR =	( 0 * srcR ) + ( 1 * srcG ) + ( 0 * srcB );
//which means...
destR = srcG;


…the amount of red in the destination pixel would be equal to the amount of green in the source pixel! Furthermore, if you changed the second row to read “1 0 0″, then the amount of green in the destination pixel would be equal to the amount of red in the source pixel; you would have swapped them over and your orange fish would turn into green ones:

You’re probably wondering about the A column and row and about the Offset column. Well, A stands for alpha, which means transparency. The A values have much the same effect as the R G B values, but since none of these sample images are transparent, it’s hard to demonstrate. The Offset column lets you simply increase or decrease the amount of red, blue, or green in the destination pixel: type -255 into the R row’s Offset column and you’ll see that there is no longer any red in the image.

#### Experiment

I realize it’s tricky to understand this just from reading about it, so we’re going to look at some cool example effects. That’s much more fun, anyway. But first, for the curious, here’s the actual mathematical formula Flash uses:

destR = ( a[0]  * srcR ) + ( a[1]  * srcG ) + ( a[2]  * srcB ) + ( a[3]  * srcA ) + a[4];
destG = ( a[5]  * srcR ) + ( a[6]  * srcG ) + ( a[7]  * srcB ) + ( a[8]  * srcA ) + a[9];
destB = ( a[10] * srcR ) + ( a[11] * srcG ) + ( a[12] * srcB ) + ( a[13] * srcA ) + a[14];
destA = ( a[15] * srcR ) + ( a[16] * srcG ) + ( a[17] * srcB ) + ( a[18] * srcA ) + a[19];


(Each of the values you see in the 5×4 matrix can vary between -255 and 255.)

Take a look at the “Color Chart” sample image:

Now, let’s say you want to remove all red color from the picture. Simply set all the values in the R row to zero:

This means:

destR = ( 0 * srcR ) + ( 0 * srcG ) + ( 0 * srcB ) + ( 0 * srcA ) + 0;
//which means:
destR = 0 + 0 + 0 + 0 + 0;
//so:
destR = 0;


Now let’s say you want to add some more green where there was previously red. Put “1″ at input 0×1, so the G row reads “1 1 0 0 0″:

Let’s now achieve something very strange by changing the G row to “0 -1 0 0 50″:

What just happened? As an example, if at some random pixel you had green = 30, it was multiplied with ‘-1′ and afterwards 50 was added, so the result would be: (30 * -1) + 50 = 20.

Therefore, a type of threshold is created: for each pixel with a green value greater than 50, its transformed pixel will be completely turned off. Why? Well, suppose the pixel’s green channel has a value of 51:

destG = ( 0 * srcR ) + ( -1 * srcG ) + ( 0 * srcB ) + ( 0 * srcA ) + 50;
//remember srcG = 51:
destG = 0 + (-51) + 0 + 0 + 50;
//so:
destG = - 51 + 50;
//so:
destG = -1;
//but a pixel can't have a negative amount of green, so this is just set to zero:
destG = 0;


Now try this:

All pixels with green values greater than 50 get turned off and those with green values below 50 have all three color channels increased. This allows you to see areas of the image that have only a very small amount of green, as with the fish image:

x

Here, only the pixels with an amount of green less than 50. The darker the pixel, the more green there is in the original image. That’s the basic principle anyway. I know it may seem complicated at first, but play with it and you’ll get it eventually :)

#### Grayscale

OK, let’s go for something standard: a grayscale image. Change your matrix like so:

You’ve got a grayscale. Nice :)

#### Inverted Colors

Let’s achieve another popular color state: Inverted Colors.

To invert the colors, we need to make it so that every pixel with a red value of 255 has a red value of zero, and vice-versa. Same for the other two colors. So we need to make Flash run code that looks like this:

destR = 255 - srcR;
destG = 255 - srcG;
destB = 255 - srcB;


But that’s easy! All we have to do is set the matrix like this:

#### More Effects

Most of the more exotic effects that can be achieved by the ColorMatrixFilter are done by setting a negative value for a color and a positive value for offset – or vice-versa. Put “-1″ from 0×3 to 2×3 (the alphas) and 255 for offset of the alpha (4×3).
Wow, now I know now how they made Terminator 2 :)

Honestly, I am not really sure what I just did – calculations become really hard to track after a while.

Although it’s possible to understand how the ColorMatrixFilter works from a mathematical point of view, realistically it’s going to remain a matter of playing around with it. You can never be exactly sure what is going to pop up when you put some specific values. That’s why I made this EffectsTester. So play around. Make yourself metallic green, or red, or colorless.

#### Real World Application

When you’ve got an effect you like, you can apply it to any DisplayObject (MovieClip, Sprite, Bitmap…) in your own code like this:

//first import ColorMatrixFilter up at the top of your code:
import flash.filters.ColorMatrixFilter;

//...later on:
var filters:Array = new Array();
//for everything after " = new", copy and paste from the "Grab The Code" box of EffectsTester:
var cmf:ColorMatrixFilter = new ColorMatrixFilter(new Array(-1,0,0,0,255,0,-1,0,0,255,0,0,-1,0,255,0,0,0,1,0));
//the next two lines apply the filter to your display object:
filters.push( cmf );
myDisplayObject.filters = filters;


Now let’s look at the convolution filter.

## The Convolution Filter

A convolution combines pixels in the input image with neighboring pixels to produce an image. A wide variety of image effects can be achieved through convolutions, including blurring, edge detection, sharpening, embossing, and beveling.

The ConvolutionFilter loops through all pixels of a display object. For each of them, it uses the center value in the matrix as the value of the current pixel being manipulated. For example, in a 3 x 3 matrix, the center value is at (1, 1). It then multiplies the values from the matrix by the surrounding pixels and adds the resulting values for all pixels to get the value for the resulting center pixel.

Understanding the exact math beneath the Convolution matrix is worth a whole new article, so I won’t cover all this here. If you want to get into it, check out this post on adobe.com.

However, a simple play around with the values will eventually give you all possible effects you can achieve. And it will be fun :) So let’s see what can we do!

#### Experiment

The convolution filter uses a matrix, just like the color matrix filter. Again, the values vary between -255 and 255. And again, you achieve most of the interesting effects when combining negative values with positive ones.

Let me share with you my observations of how this thing works. Try increasing some random value from the matrix. Whichever you pick, it will lighten the picture; if you want the picture to stay at normal brightness, make sure the value of “divisor” is equal to the sum of all the values in the matrix.

Now if you try to lower a random value below zero while keeping at least one other above zero, you get something going on there. It affects your edges:

Here is a nice one: want to look like a soldier? :) Try these values:

Now lower the “divisor” value to “-1″ to become a soldier on a mission at night.

A lot of stuff can be achieved if you hold your mouse button a bit more :) Lower and raise some values to extremes. Don’t forget to adjust the “divisor” – it’s crucial. Enlarge your matrix. Make it 5×5, for example.

#### Real World Application

To apply the effect in your own code, use the filters object, just as you did for the ColorMatrixFilter:

//first import ConvolutionFilter up at the top of your code:
import flash.filters.ConvolutionFilter;

//...later on:
var filters:Array = new Array();
//for everything after " = new", copy and paste from the "Grab The Code" box of EffectsTester:
var cf:ConvolutionFilter = new ConvolutionFilter(3,3,new Array(1,0,-10,-2,3,1,6,1,-1),0);
//the next two lines apply the filter to your display object:
filters.push( cf );
myDisplayObject.filters = filters;


Finally: try combining both filters.

//first import the filter classes up at the top of your code:
import flash.filters.ColorMatrixFilter;
import flash.filters.ConvolutionFilter;

//...later on:
var filters:Array = new Array();
//for everything after " = new", copy and paste from the "Grab The Code" box of EffectsTester:
var cmf:ColorMatrixFilter = new ColorMatrixFilter(new Array(-1,0,0,0,255,0,-1,0,0,255,0,0,-1,0,255,0,0,0,1,0));
var cf:ConvolutionFilter = new ConvolutionFilter(3,3,new Array(1,0,-10,-2,3,1,6,1,-1),0);

//the next three lines apply the filters to your display object:
filters.push( cf );
filters.push( cmf );
myDisplayObject.filters = filters;


Have fun playing with these filters and post any results you get in the comments! Thanks for reading.

• http://www.nitras.be Peter

For me the preview doesn’t work, but it looks like a nice indepth tutorial.
nice one.

• http://michaeljameswilliams.com/ Michael Williams

Have you tried selecting “Sample Image” from the drop-down list at the top?

• http://www.nitras.be Peter

yes to no avail,i’ll try again later, the mysteries of the interweb.

• Pingback: The Value of Your Values

• http://www.hermantaniwan.com Herman Taniwan

Yeah me Too. The image don’t show up and I got this error TypeError: Error #1009: Cannot access a property or method of a null object reference.
at EffectsTester_fla::MainTimeline/frame1().

• http://www.hermantaniwan.com Herman Taniwan

Yeah me Too. The image doesn’t show up and I got this error from my flash player 9 and 10 debugger ->TypeError: Error #1009: Cannot access a property or method of a null object reference.
at EffectsTester_fla::MainTimeline/frame1().

• http://www.elquefaltaba.es/qborreda.html qborreda

Playground post .. loving it! Thanx!

• http://www.juxt2.com Dimitree

Hey great tutorial! I love to learn what’s going on behind the scenes when using filters.

• http://gamedev.rasmuswriedtlarsen.com Rasmus Wriedt Larsen

Great post ! Thanks a lot.

• http://michaeljameswilliams.com/ Michael Williams

To those who can’t get it working: do you have a webcam? I’ve realised we’ve never actually tested it on a computer without one!

• Aaron

No, I don’t, and it doesn’t work for me.

• http://michaeljameswilliams.com/ Michael Williams

Aha, I think that’s the problem. Sorry about that — I’ve just received a new version of the SWF and we’ll have it online soon :)

• bassta

Добави само, че на Мак трябва да се даде USB Video Class Video, ако и това не пробачка – CamTwist

• http://snaptin.com Ian Yates
Staff

translate.google.com: “Only add that the Mac must be given USB Video Class Video, if that’s not probachka”

• Taran J

great one doode, thx

• Netraam

Nice tutorial! Is it possible to play with saturation as well?

• Avinash

Nice tutorial…but sorry to say that the source link doesn’t contain FLA(source file). If so then why do you call it as download source???

• David

I cant seem to get it to work. There’s something wrong with:
“var filters:Array = new Array();”

It gives a compiling error of:
“1152: A conflict exists with inherited definition flash.display:DisplayObject.filters in namespace public.”

• http://michaeljameswilliams.com/ Michael Williams

Try, “var myFilters:Array = new Array();” and then later “myDisplayObject.filters = myFilters;”

• Tonny

Nice tutorial. Thanks.
Could you show me matrix to exposure image ? Thanks.

• http://android9patch.blogspot.com Richard L.

Fantastic Article.

This is very similar to colorfilter applied to drawable on the android platform.

Thanks!

• http://www.betapet.se Henrik

Thank you for an excellent tutorial. You saved my day and made ColorMatrix simple!

/ Henrik, Sweden

• Miloparo

Thank you very much for this tutorial !

However, I have some problems to achieve certain effects.

Do you know how I can achieve a thermal effect ?
http://farm1.static.flickr.com/167/420843187_4cfce21a73.jpg

This is similar to the first effect of the band at the beginning of your tutorial :
http://d2fhka9tf2vaj2.cloudfront.net/tuts/070_effectsTester/Tutorial/-2.jpg

• art

Hi Martin,

http://active.tutsplus.com/tutorials/effects/manipulate-visual-effects-with-the-colormatrixfilter-and-convolutionfilter/

and i have a fun project for you.

I need to make a flash app that can Replace a range of colors from a bitmap image.