Click here to Skip to main content
Click here to Skip to main content

ColorMatrix Basics - Simple Image Color Adjustment

, 2 Apr 2003 CPOL
Rate this:
Please Sign up or sign in to vote.
A beginners guide to using the GDI+ ColorMatrix.

Color Image Grayscale Image Blue Image


This article discusses color operations on digital images, using the new ColorMatrix class provided by GDI+. The ColorMatrix is a welcome addition to the GDI library, especially with the increase in demand of digital imaging applications, as more and more consumer products are made available. This class, as well as many other new GDI classes, provide more control to the developer and reduce dependence on 3rd party applications such as LEAD tools, and others. Some basic knowledge of matrix operations (multiplication, addition, etc), the RGBA colorspace and GDI+ is assumed.


ColorMatrix operations are performed in the RGBA colorspace (red, green, blue, alpha). A ColorMatrix consists of a 5x5 matrix, with color values normalized to 1 for full intensity (255 -> 1.0). You might expect the matrix to be 4x4 ( [R, G, B, A] ), which would be sufficient if we only needed to perform linear transformations (multiplication: scaling, rotation, etc). However, one of the most frequent color manipulations, color adjustment, requires adding color values. This is a non-linear operation, referred to as a translation. Adding a 5th element to the color vector ( [R, G, B, A, w] ) combines these two operations, linear and non-linear, into a single operation called an affine transformation. The 5th element of the color vector is simply a dummy element, always with a value of 1, which only serves to allow a translation (addition) of the color vector.

The example below scales the color vector [255, 128, 102, 255] by .5 and then adds a value of 26 to the R, G and B components, leaving the A component at full intensity. Remember that the component values are normalized, with full intensity, 255, equal to 1.0 (values have been rounded to the nearest tenth). Also notice the addition of the 5th element to the color vector, which is simply ignored in the resultant color vector.

This takes the color and transforms it to .

Now that we've covered the basic principle of the ColorMatrix and it's operations on color vectors, we can start exploring some practical uses.

Applying the code

Applying a ColorMatrix to an image is quite simple. You must first associate a ColorMatrix object with an ImageAttributes object. Then you simply pass the ImageAttributes object as a parameter to the Graphics.DrawImage method.

Color adjustment is one of the more common color operations applied to digital images. The code to do this might look as follows:

Public Function translate(ByVal img As Image, ByVal red As Single, _
                       ByVal green As Single, ByVal blue As Single, _
                       Optional ByVal alpha As Single = 0) As Boolean

    Dim sr, sg, sb, sa As Single
    ' noramlize the color components to 1
    sr = red / 255
    sg = green / 255
    sb = blue / 255
    sa = alpha / 255
    ' create the color matrix
    dim New ColorMatrix(New Single()() _
                       {New Single() {1, 0, 0, 0, 0}, _
                        New Single() {0, 1, 0, 0, 0}, _
                        New Single() {0, 0, 1, 0, 0}, _
                        New Single() {0, 0, 0, 1, 0}, _
                        New Single() {sr, sg, sb, sa, 1}})

    ' apply the matrix to the image
    Return draw_adjusted_image(img, cm)

End Function
Private Function draw_adjusted_image(ByVal img As Image, _
                ByVal cm As ColorMatrix) As Boolean

        Dim bmp As New Bitmap(img) ' create a copy of the source image 
        Dim imgattr As New ImageAttributes()
        Dim rc As New Rectangle(0, 0, img.Width, img.Height)
        Dim g As Graphics = Graphics.FromImage(img)

        ' associate the ColorMatrix object with an ImageAttributes object

        ' draw the copy of the source image back over the original image, 
        'applying the ColorMatrix
        g.DrawImage(bmp, rc, 0, 0, img.Width, img.Height, _
                               GraphicsUnit.Pixel, imgattr)


        Return True

        Return False
    End Try

End Function

Conversion to grayscale is another common conversion. Grayscale values are determined by calculating the luminosity of a color, which is a weighted average of the R, G and B color components. The average is weighted according to the sensitivity of the human eye to each color component. The weights used here are as given by the NTSC (North America Television Standards Committee) and are widely accepted.

Public Function grayscale(ByVal img As Image) As Boolean

    Dim cm As ColorMatrix = New ColorMatrix(New Single()() _
                           {New Single() {0.299, 0.299, 0.299, 0, 0}, _
                            New Single() {0.587, 0.587, 0.587, 0, 0}, _
                            New Single() {0.114, 0.114, 0.114, 0, 0}, _
                            New Single() {0, 0, 0, 1, 0}, _
                            New Single() {0, 0, 0, 0, 1}})

    Return draw_adjusted_image(img, cm)
End Function

The code below creates a digital negative:

Public Function negative(ByVal img As Image) As Boolean

    Dim cm As ColorMatrix = New ColorMatrix(New Single()() _
                           {New Single() {-1, 0, 0, 0, 0}, _
                            New Single() {0, -1, 0, 0, 0}, _
                            New Single() {0, 0, -1, 0, 0}, _
                            New Single() {0, 0, 0, 1, 0}, _
                            New Single() {0, 0, 0, 0, 1}})

    Return draw_adjusted_image(img, cm)

End Function

Color channel separations, alpha transparency adjustment, image toning (Sepia, etc) are just a few more common operations that can be easily performed with a ColorMatrix.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Michael Combs
United States United States
Michael has been developing software for about 19 years primarily in C#, C/C++, Fortran, and Visual Basic. His previous experience includes Internet data services (communication protocols, data storage and GIS) for the mortgage industry, oil platform instrumentation and explosives simulation and testing. He holds a B.S. in astrophysics and computer science. He is currently working for Global Software in Oklahoma City developing law enforcement and emergency services related software.

Comments and Discussions

GeneralMy Vote 5. PinmemberNathan Ferreira4-Dec-14 1:20 
GeneralMy vote of 1 PinmemberXmen W.K.6-Jul-10 4:01 
GeneralMy vote of 4 Pinmemberjoerg-schumann29-Jun-10 2:46 
GeneralI have an error "A Graphics object cannot be created from an image that has an index" Pinmemberrpiniones7-Apr-10 1:46 
Questionaspx file ? How to call in a page to see resluts ? PinmemberAlain Van haecke9-Jul-09 4:00 
GeneralColorize Image Pinmemberdanielku1531-May-09 10:46 
GeneralSub OffsetMatrix incorrect PinmemberThomas Nichols17-Mar-09 7:19 
AnswerAlpha Channel Bug PinmemberAndy Davies27-Feb-09 23:09 
GeneralMethod for producing a "Color Match"? [modified] PinmemberMichael Schäuble21-Sep-08 4:29 
QuestionPure Black and White [modified] PinmemberLuca Crisi, MCP23-May-08 0:44 
AnswerRe: Pure Black and White [modified] PinmemberLuca Crisi, MCP23-May-08 3:19 
GeneralRe: Pure Black and White PinmemberAamir Mustafa9-Oct-08 18:43 
GeneralRe: Pure Black and White PinmemberLuca Crisi, MCP13-Oct-08 9:27 
QuestionSaving Changed Image Format Pinmemberstixoffire19-Sep-07 1:16 
QuestionHow to Apply Pinmember*shona13-Aug-07 1:53 
QuestionHow to do softlight on an image? Pinmemberfreecoke12-Apr-07 7:41 
QuestionSave File [modified] PinmemberCarlHackman11-Mar-07 14:22 
Questionabaout grayscale Pinmemberaimaniez10-Mar-07 14:22 
GeneralUnderstanding The Matrix PinmemberJonFrost26-Nov-06 0:32 
QuestionColoring a grayscale image Pinmemberkspaun28-Sep-06 3:17 
AnswerRe: Coloring a grayscale image Pinmemberthefellow3j3-Feb-07 21:32 
Questionhow to do sharpness and blur [modified] Pinmembersingam17-Jul-06 4:35 
AnswerRe: how to do sharpness and blur [modified] Pinmemberwlh21cn20-Jul-06 0:44 
GeneralStrange bug while printing PinmemberPugwash200410-May-06 1:23 
GeneralComplete Grayscale Class PinsussAnonymous3-May-05 11:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150302.1 | Last Updated 3 Apr 2003
Article Copyright 2003 by Michael Combs
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid