Click here to Skip to main content
13,768,132 members
Click here to Skip to main content
Add your own
alternative version

Tagged as


43 bookmarked
Posted 19 Jan 2009
Licenced CPOL

Write text to transparent GIF

, 19 Jan 2009
Rate this:
Please Sign up or sign in to vote.
How to write text to a transparent GIF image and save it back without loosing the transparency.



This article describes how to edit a transparent GIF image by writing a text on it and save it back to disk without loosing the transparency of the image.

You can also edit the image by appending other images to it and also by drawing shapes, but it is not included in this article and I may add it later.


As GIF images are indexed (had a color palette and pixel color is represented by the index of the color in the palette), you cannot create Graphics object from the Image object containing the GIF image.

If you tried to get the Graphics object by executing

Graphics g = Graphics.FromImage(gifImage);
You will recieve an exception with the following message:
"A Graphics object cannot be created from an image that has an indexed pixel format."

So you cannot edit the GIF image directly and if you converted it to a non-indexed image then try to write it back to the dist, you will loose the transparency information.


The approach is to convert the GIF into non-indexed image so all the modifications required can be done through its Graphics object, then convert it back into an indexed image to be saved as GIF.

It is easy to convert the indexed image to non-indexed image by simply creating a new non-indexed image with the same width/height of the original image then draw the original image to it.

//Get the Graphics object of the image to use in drawing.
using (Graphics g = Graphics.FromImage(this.DestinationImage))
    //Draw the original image.
    g.DrawImage(this.SourceImage, 0, 0);
    //Free the resources.

As the image now is non-indexed image we can easily draw shapes, images and text to it using the Graphics object.

g.TextRenderingHint = TextRenderingHint.AntiAlias;
g.DrawString(title, titleFont, titleBrush, left, top, StringFormat.GenericTypographic);

The problem now is how to convert the non-indexed image back into an indexed image, the same approach used to convert the indexed into non-indexed will be used. We will create a new indexed image with the same width/height.

//Create an indexed image.
Bitmap dest = new Bitmap(src.Width, src.Height, PixelFormat.Format8bppIndexed);

We should now draw the non-indexed image content to the indexed image, but before doing that where we get the palette that will be used in the resulting image? For now I used the palette from the original image, but you can modify the code to deduce the palette from the non-indexed image.  

//Set the palette of the image.
dest.Palette = palette;

We should now obtain the transparent color index and cache the palette into a dictionary to speed up the search for color.

//Create a dictionary of colors to speed up the search.
Dictionary<int,> colors = new Dictionary<int,>();
//The transparent color index.
int transparent = 255;
//Load the dictionary with the given palette.
for (int i = 0; i < palette.Entries.Length; i++)
    colors[Color2Int(palette.Entries[i])] = i;
    if (palette.Entries[i].A == 0)
        transparent = i;

As we are not able to use the graphics object of the indexed image so we should modify the image raw data. To be able to obtain the image raw data you should first lock it for modification.

Rectangle rect = new Rectangle(0, 0, src.Width, src.Height);
//Lock the image data so you can modify it.
BitmapData destData = dest.LockBits(rect, ImageLockMode.ReadWrite, dest.PixelFormat);

We should obtain the raw data of the image so we can edit it.

//The number of bytes in each scan line (row in image) of the image.
int dStride = Convert.ToInt32(Math.Abs(destData.Stride));
//Create a buffer to hold the image data.
byte[] destBytes = new byte[dest.Height * dStride];
//Copy the image data into the buffer.
IntPtr destPtr = destData.Scan0;
Marshal.Copy(destPtr, destBytes, 0, dest.Height * dStride);

We should loop for each pixel in the non-indexed image, get the pixel image and obtain the index of the pixel color from the palette.

If the pixel color is transparent (Alpha part is zero), we use the transparent index. If the pixel color found in the palette we use this index.

If the pixel color is not found in the palette, then we choose the nearest color. The nearest color in the palette have the minimum distance from the original color based on the formula:
distance = (o.Red-d.Red)<sup>2</sup> + (o.Blue-d.Blue)<sup>2</sup> + (o.Green-d.Green)<sup>2</sup>

//Get the color of the pixel.
Color c = src.GetPixel(col, row);
int index = 255;
if (c.A == 0) //Transparent
    index = transparent;
    //Get the nearst color from the palette.
    int ic = Color2Int(c);
    if (colors.ContainsKey(ic))
        index = colors[ic];
        index = GetNearestColor(palette, c);
        colors[ic] = index;

Update the image raw data with the selected color.

destBytes[row * dStride + col] = (byte)index;

After updating all image data, we should copy data back to the image and unlock the data.

//Copy the image data back to the image.
Marshal.Copy(destBytes, 0, destPtr, dest.Height * dStride);
//Unlock the data.

Using the code

When the user presses the Open button, we simply load the image into SourceImage, DestinationImage.

this.SourceImage = new Bitmap(fileName);
this.DestinationImage = this.SourceImage;

The image is now loaded and stored in SourceImage. When the user presses the Write button we should create a new non-indexed image from the source image and prepare the fonts and brushes for the title and text body.

//Create a blank image.
this.DestinationImage = new Bitmap(this.SourceImage.Width, this.SourceImage.Height, PixelFormat.Format32bppArgb);
//The font used in writing the title.
Font titleFont = new Font("Arial Black", 36, FontStyle.Italic, GraphicsUnit.Point);
//The brush used in writing the title.
Brush titleBrush = new SolidBrush(titleColor);
//The font used in writing the text.
Font bodyFont = new Font("Arial", 24, FontStyle.Bold | FontStyle.Italic, GraphicsUnit.Point);
//The brush used in writing the text.
Brush bodyBrush = new SolidBrush(bodyColor);

As the image is now non-index image we can get its Graphics object and use all the drawing methods exposed by the Graphics object.

//Get the Graphics object of the image to use in drawing.
using (Graphics g = Graphics.FromImage(this.DestinationImage))
    //Draw the original image.
    g.DrawImage(this.SourceImage, 0, 0);
    //Used to write smooth text.
    g.TextRenderingHint = TextRenderingHint.AntiAlias;
    //Write the text you want.
    g.DrawString(title, titleFont, titleBrush, left, top, StringFormat.GenericTypographic);

    float y = top + g.MeasureString(title, titleFont).Height;
    g.DrawString(body, bodyFont, bodyBrush, left, y, StringFormat.GenericTypographic);

    //Free the resources.

Now the edited image is stored in DestinationImage but it is non-indexed image. When the user presses the Save As button we should convert it into an indexed image and save it to disk.

Bitmap gif = CreateIndexedImage(this.DestinationImage, this.SourceImage.Palette);
gif.Save(fileName, ImageFormat.Gif);


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


About the Author

Abdallah Gomah
Team Leader AGI
Egypt Egypt
Abdallah Gomah
Master in Computer Science, 2013, Faculty of Computers & Information, Cairo University (Egypt)

- Working as a developer since I graduated from the faculty.
- Like coding in C++ aloso like to code in assembly.
- Have a great experience in coding with .NET (C#/VB), but I prefer the C# notation.
- Had written a lot of applications Desktop and Web.

I love playing football as much as I love the programming.

You may also be interested in...

Comments and Discussions

Questionhello, why i can't download the sourcedoe or the demo? Pin
foryou_ch11-Jun-12 22:25
memberforyou_ch11-Jun-12 22:25 
GeneralHey man! Pleased to meet you Pin
Muhammad Gouda7-Sep-09 0:59
memberMuhammad Gouda7-Sep-09 0:59 
GeneralNice Pin
Don Kackman8-Jul-09 8:05
memberDon Kackman8-Jul-09 8:05 
QuestionHow to detect GIF has transparent background? Pin
Hardy Wang19-Jan-09 11:59
memberHardy Wang19-Jan-09 11:59 
AnswerRe: How to detect GIF has transparent background? Pin
Abdallah Gomah19-Jan-09 18:23
memberAbdallah Gomah19-Jan-09 18:23 

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

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

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web01-2016 | 2.8.181116.1 | Last Updated 19 Jan 2009
Article Copyright 2009 by Abdallah Gomah
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid