개발자로 살기

class CTestOutlineTextApp

// class declaration

Gdiplus::GdiplusStartupInput m_gdiplusStartupInput;

ULONG_PTR m_gdiplusToken;

};

// default constructor

CTestOutlineTextApp::CTestOutlineTextApp()

Gdiplus::GdiplusStartup(&m_gdiplusToken, &m_gdiplusStartupInput, NULL);

CTestOutlineTextApp::~CTestOutlineTextApp()

// destructor

Gdiplus::GdiplusShutdown(m_gdiplusToken);

For .NET Windows Form application, GDI+ initialization and uninitialization is handled automatically for the developers.

Drawing Single Outline Text with Generic GDI+

For this tutorial, I mostly stick to the Arial font, because Arial font comes with every Windows Operating Systems, so the sample code will work out of the box for you. To draw outline text, we have to add the string to the GraphicsPath object, using its AddString method, so that we can have its path to draw its outline. We must draw the text's outline first. To do that, we use Graphics class's DrawPath method. Lastly, we draw the text body with Graphics class's FillPath method. Simple, right?

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

path.AddString(pszbuf, wcslen(pszbuf), &fontFamily,

FontStyleRegular, 48, Gdiplus::Point(10,10), &strformat );

This is the equivalent C# code, using GDI+'s System::Drawing classes to draw outline text. You will notice that it is quite similar to the C++ code above.

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

(int)FontStyle.Regular, 48.0f, new Point(10, 10), strformat);

SolidBrush brush = new SolidBrush(Color.FromArgb(128, 0, 255));

We have a problem with the above text, specifically "A"; there is a sharp pointer at the top of "A". This problem exists if there are sharp edges or corners in the font glyphs and the outline is quite thick or thicker than the text body. The sharp pointer above came from the outline of the inner triangle of "A". Below is the C++ code followed by the C# code to reproduce the problem.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

wchar_t pszbuf[] = L"ABC";

path.AddString(pszbuf, wcslen(pszbuf), &fontFamily,

FontStyleRegular, 48, Gdiplus::Point(10,10), &strformat );

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

string szbuf = "ABC";

(int)FontStyle.Regular, 48.0f, new Point(10, 10), strformat);

SolidBrush brush = new SolidBrush(Color.FromArgb(128, 0, 255));

Fortunately, I have a workaround for this problem. We can set the LineJoin property of GDI+ pen to LineJoinRound to avoid sharp edges and corners. The downside is every edge will be rounded, instead of crisp sharp as the font. Below is the C++ code to call the SetLineJoin method.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

wchar_t pszbuf[] = L"ABC";

path.AddString(pszbuf, wcslen(pszbuf), &fontFamily,

FontStyleRegular, 48, Gdiplus::Point(10,10), &strformat );

This is the equivalent C# code to solve the problem by setting the LineJoin property to LineJoin.Round.

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

string szbuf = "ABC";

(int)FontStyle.Regular, 48.0f, new Point(10, 10), strformat);

SolidBrush brush = new SolidBrush(Color.FromArgb(128, 0, 255));

Drawing Single Outline Text with Gradient Color

We can select a gradient or texture brush, instead of a solid brush, for the text color. Below is a C++ example that shows how to do it.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

path.AddString(pszbuf, wcslen(pszbuf), &fontFamily,

FontStyleBold, 48, Gdiplus::Point(10,10), &strformat );

Pen pen(Color(0,0,160), 5);

LinearGradientBrush brush(Gdiplus::Rect(10, 10, 30, 60),

Color(132,200,251), Color(0,0,160), LinearGradientModeVertical);

Below is C# example that shows how to select a gradient brush.

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

(int)FontStyle.Bold, 48.0f, new Point(10, 10), strformat);

Pen pen = new Pen(Color.FromArgb( 0, 0, 160), 5);

LinearGradientBrush brush = new LinearGradientBrush(new Rectangle(10,10,30,70),

Color.FromArgb(132,200,251),

Color.FromArgb(0,0,160), LinearGradientMode.Vertical);

Drawing Double Outline Text with Generic GDI+

To achieve double outline text, you have to render the outer outline first, then the inner outline, using DrawPath, followed by the FillPath call to draw the text body. Below is the C++ code to achieve that:

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

path.AddString(pszbuf, wcslen(pszbuf),

&fontFamily, FontStyleRegular, 48, Gdiplus::Point(10,10), &strformat );

Pen penOut(Color(32, 117, 81), 12);

penOut.SetLineJoin(LineJoinRound);

graphics.DrawPath(&penOut, &path);

This is the equivalent C# code to draw double outline text:

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

(int)FontStyle.Regular, 48.0f, new Point(10, 10), strformat);

Pen penOut = new Pen(Color.FromArgb(32, 117, 81), 12);

penOut.LineJoin = LineJoin.Round;

e.Graphics.DrawPath(penOut, path);

SolidBrush brush = new SolidBrush(Color.FromArgb(128, 0, 255));

Drawing Text Glow with Generic GDI+

To draw text glow, you have to start with a thin pen with low alpha values between 24 to 64 and draw the outline, repeatedly draw the outline with a thicker pen. Then finally draw the text body with FillPath method.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

path.AddString(pszbuf, wcslen(pszbuf), &fontFamily,

FontStyleRegular, 48, Gdiplus::Point(10,10), &strformat );

for(int i=1; i<8; ++i)

Pen pen(Color(32, 0, 128, 192), i);

SolidBrush brush(Color(255,255,255));

This is the equivalent C# code to draw text glow:

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

SolidBrush brushWhite = new SolidBrush(Color.White);

(int)FontStyle.Regular, 48.0f, new Point(10, 10), strformat);

for(int i=1; i<8; ++i)

Pen pen = new Pen(Color.FromArgb(32, 0, 128, 192), i);

SolidBrush brush = new SolidBrush(Color.FromArgb(255, 255, 255));

Postscript OpenType Fonts

Before you rush to make your own outline library, I have to tell you one pitfall of GDI+. GDI+ cannot handle Postscript OpenType fonts; GDI+ can only handle TrueType fonts. I have searched for a solution and found Sjaak Priester's Make GDI+ Less Finicky About Fonts. His approach is to parse the font file for its glyphs and draw its outline. Sadly, I cannot use his code as his library is using the restrictive GNU license as I want to make my code free for all to use. Note: This is the reason why Winform developers use the TextRenderer class, to display the text, not GDI+ classes. I racked my brains for a solution. Since GDI (not GDI+) can display Postscript OpenType fonts and GDI supports path extraction through BeginPath/EndPath/GetPath, I decided to use just that to get my path into GDI+. Below is the comparison of the GDI+ path and GDI path. Note: Both are rendered by GDI+, it is just that their path extraction is different; one is using GDI+ while the other is using GDI to get the text path.

The top one is using GDI+ path and the bottom one is using GDI path. Looks like GDI path text is bigger and a bit inaccurate (not obvious here because it depends on the font). (Note: I realised that if you use Graphics::DrawString to draw the text, they are roughly the same size as the GDI path text; it is the GDI+ path text which is smaller!) However, GDI paths can do rotated italic text trick, like below, which GDI+ cannot do because GDI GraphicsPaths AddString takes in a FontFamily object, not a Font object. My OutlineText class provides the GdiDrawString method if you have the need to use PostScript OpenType fonts. The effect below is a Franklin Gothic Demi font, size 36, Italic text rotated 10 degrees anti-clockwise.

Drawing Outline Text using DirectWrite

As you all know, Direct2D and DirectWrite are the next graphics and text APIs for Vista and Windows 7. I have emailed Tom Mulcahy (Microsoft's developer of Direct2D for Windows 7). Below is Tom Mulcahy's email reply to me.

(Courtesy of Tom Mulcahy) The way to do this is to get the text contents as an ID2D1GeometrySink (See IDwriteFontFace::GetGlyphRunOutline). You can then call ID2D1RenderTarget::DrawGeometry to draw the outline of the text (specifying any color and width you want). Next call ID2D1RenderTarget::FillGeometry to fill the text (again you can specify any color you want).

Note: Text Designer Outline Text Library which is mentioned in the latter part of the article, will be updated with DirectWrite when Windows 7 is out.

What about Drawing Shadows?

To tell you the truth, text shadow is drawn using the single outline text code. There is one problem: shadow is translucent. If we use the first code example to render shadows, it will turn out to be like the image below. It is because some area of the font body and font outline overlaps, so they are rendered twice, therefore it is darker.

My solution is to render the shadow text body and shadow text outline separately like below and combine them, with the pixels with shadow text body taking precedence; Only where the shadow text body is not rendered, the shadow text outline is rendered. Shadow rendering is more involved and complicated, the 0.1.0 version of OutlineText.cpp without shadow implementation is only 3KB in file size and has 164 lines of code while the 0.2.0 version of OutlineText.cpp with shadow implementation is 23KB in file size and has 865 lines of code! Therefore, I will not show its code here, you can download and read the source code if you are interested.

Drawing Single Outline using OutlineText

This is the C++ code to use the OutlineText class to display the single outline text, using the TextOutline and DrawString methods:

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

text.TextOutline(Color(255,128,64),Color(200,0,0),8);

text.SetShadowBkgd(Color(255,255,0),rect.Width(),rect.Height());

text.Shadow(Color(128,0,0,0), 4, Point(4,8));

text.DrawString(&graphics,&fontFamily,FontStyleItalic,

This is the equivalent C# code to use the OutlineText class to display the single outline text, using the TextOutline and DrawString methods:

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

FontFamily fontFamily = new FontFamily("Arial Black");

OutlineText text = new OutlineText();

text.TextOutline(Color.FromArgb(255, 128, 64), Color.FromArgb(200, 0, 0), 8);

text.SetShadowBkgd(Color.FromArgb(255, 255, 0), this.Size.Width, this.Size.Height);

text.Shadow(Color.FromArgb(128, 0, 0, 0), 4, new Point(4, 8));

text.DrawString(e.Graphics, fontFamily,

FontStyle.Italic, 48, szbuf, new Point(10, 10), strformat);

Drawing Single Outline Text with Gradient Color using OutlineText

We can select a gradient or texture brush, instead of a solid brush, for the text color. We can use the MeasureString method to calculate the width and height of the text will take and this returned width and height will be the width and height of the gradient brush. However, we must call TextOutline method again to set the brush. The reason TextOutline needs to be called twice is because MeasureString needs the TextOutline information before the string can be measured correctly. Do not worry: TextOutline is pretty lightweight, it just sets some information. Below is a C++ example that shows how to do it.

using namespace TextDesigner;

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

text.SetShadowBkgd(Color(255,255,0),rect.Width(),rect.Height());

text.Shadow(Color(128,0,0,0), 4, Point(4,8));

text.TextOutline(Color(0,0,0), Color(0,0,160),5);

Gdiplus::Point(10,10),

&strformat,

&fDestWidth,

&fDestHeight);

float fDestWidth = 0.0f;

float fDestHeight = 0.0f;

LinearGradientBrush brush(Gdiplus::Rect(10, 10, fDestWidth, fDestHeight),

Color(132,200,251), Color(0,0,160), LinearGradientModeVertical);

text.TextOutline(&brush, Color(0,0,160),5);

text.DrawString(&graphics,&fontFamily,FontStyleItalic,

Below is a C# example that shows how to select a gradient brush with OutlineText.

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

OutlineText outlineText = new OutlineText();

outlineText.TextOutline(

Color.FromArgb(255, 128, 192),

Color.FromArgb(255, 0, 0, 160),

outlineText.EnableShadow(true);

//Rem to SetNullShadow() to release memory if a previous shadow has been set.

outlineText.SetNullShadow();

outlineText.Shadow(Color.FromArgb(128, 0, 0, 0), 4, new Point(4, 8));

Color m_clrBkgd = Color.FromArgb(255, 255, 255);

outlineText.SetShadowBkgd(m_clrBkgd, this.ClientSize.Width, this.ClientSize.Height);

FontFamily fontFamily = new FontFamily("Arial Black");

StringFormat strFormat = new StringFormat();

float fDestWidth = 0.0f;

float fDestHeight = 0.0f;

outlineText.MeasureString(

LinearGradientBrush brush = new LinearGradientBrush(new Rectangle(10, 10,

(int)fDestWidth, (int)fDestHeight),

Color.FromArgb(132,200,251), Color.FromArgb(0,0,160),

System.Drawing.Drawing2D.LinearGradientMode.Vertical);

outlineText.TextOutline(

brush,

Color.FromArgb(255, 0, 0, 160),

outlineText.DrawString(e.Graphics, fontFamily,

FontStyle.Italic, 48, "Text Designer",

new Point(10, 10), strFormat);

These are the settings in TestOutlineText application to display the above. I list out the settings here because sometimes even I was a bit lost on how to use TestOutlineText to display certain outline text effects. By listing the settings here, I hope the readers will get familiar with this application so that they can try out the outline effects they want. Please note if you enable shadow, the scrolling and resizing of the TestOutlineText application will be jerky because shadow rendering is computation intensive operation. I have written a PngOutlineText class to work around this problem, which I talk about it later towards the end of the article.

Drawing Double Outline using OutlineText

To achieve double outline text, you have to specify the outer outline and the inner outline. This is the C++ code to display the double outline text, using the TextDblOutline and DrawString methods:

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

text.TextDblOutline(Color(255,255,255),Color(0,128,128),Color(0,255,0),4,4);

text.SetShadowBkgd(Color(255,128,192),rect.Width(),rect.Height());

text.Shadow(Color(128,0,0,0), 4, Point(4,8));

text.DrawString(&graphics,&fontFamily,FontStyleRegular,

This is the C# code to display the double outline text, using the TextDblOutline and DrawString methods:

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

FontFamily fontFamily = new FontFamily("Arial Black");

OutlineText text = new OutlineText();

text.TextDblOutline(Color.FromArgb(255, 255, 255),

Color.FromArgb(0, 128, 128), Color.FromArgb(0, 255, 0), 4, 4);

text.SetShadowBkgd(Color.FromArgb(255, 128, 192), this.Size.Width, this.Size.Height);

text.Shadow(Color.FromArgb(128, 0, 0, 0), 4, new Point(4, 8));

text.DrawString(e.Graphics, fontFamily,

FontStyle.Bold, 48, szbuf, new Point(10, 10), strformat);

These are the settings to display the double outline text:

Drawing Text Glow using OutlineText

This is the C++ code to display the text glow using the TextGlow and DrawString methods. Text glow is usually not displayed with a shadow because shadow interferes with the glow effect, so I disabled the shadow and did not set any shadow settings.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

text.TextGlow(Color(191,255,255),Color(24,0,128,128),14);

text.EnableShadow(false);

text.DrawString(&graphics,&fontFamily,FontStyleRegular,

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

FontFamily fontFamily = new FontFamily("Arial Black");

OutlineText text = new OutlineText();

text.TextGlow(Color.FromArgb(191, 255, 255), Color.FromArgb(24, 0, 128, 128), 14);

text.EnableShadow(false);

text.DrawString(e.Graphics, fontFamily, FontStyle.Bold,

48, szbuf, new Point(10, 10), strformat);

These are the settings to display the text glow:

This is text glow with shadow if you are curious:

Fake 3D Text

You can achieve simulated 3D text by using a bigger and opaque shadow which has the same colour as the outline colour. Of course, if you look closely enough, you know it is not looking like 3D at all.

Real 3D Text (Orthogonal)

It's easy to do real 3D text with PngOutlineText class. The extruded part is achieved by rendering the same colored text repeatedly and diagonally. By rendering diagonally, I mean render the text by offsetting the starting draw point by 1 pixel in x and y direction. Finally, we will render the real text at its original point. The sample code below achieves this by using the same PngOutlineText object. It sets new TextOutline parameters for the final text in DrawActualText. You will notice that in DrawDiagonal and DrawActualText methods, I blit the PNG image in graphics object which is created out of a ARGB Bitmap object, so that the resultant 3D text will be 'saved' in the ARGB Bitmap object. Then in the OnPaint method, I just blit that ARGB Bitmap object without using PngOutlineText anymore. To draw outline text, PngOutlineText is the way to go; OutlineText is just too slow as it has to recalculate and redraw the text each time the client area is invalidated for repainting. By the way, the sample code below is modified from sample code which is pasted from the clipboard, which in turn is copied into the clipboard from the WYSIWYG "Copy C++ Code" button. Talk about eating your own dog food!

#include "../TextDesigner/PngOutlineText.h"

Gdiplus::Bitmap m_bitmap(420,100,PixelFormat32bppARGB);

BOOL CScratchPadDlg::OnInitDialog()

SetIcon(m_hIcon, TRUE); // Set big icon

CDialog::OnInitDialog();

SetIcon(m_hIcon, FALSE); // Set small icon

Graphics graphics(&m_bitmap);

PngOutlineText pngOutlineText;

DrawDiagonal(graphics, pngOutlineText, 6);

DrawActualText(graphics, pngOutlineText);

return TRUE;

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

// Fill background with white colour.

SolidBrush brushWhite(Color(255,255,255));

graphics.FillRectangle(&brushWhite, 0, 0, rect.Width(), rect.Height());

graphics.DrawImage(&m_bitmap, 10, 10, m_bitmap.GetWidth(), m_bitmap.GetHeight());

void CScratchPadDlg::DrawDiagonal(Gdiplus::Graphics& graphics,

PngOutlineText& pngOutlineText, int nDiagonal)

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

pngOutlineText.TextOutline(

Color(0,0,0),

Color(255,0,0,0),

pngOutlineText.EnableShadow(false);

Bitmap* pPngImage = new Gdiplus::Bitmap(m_bitmap.GetWidth(),

StringFormat strFormat;

m_bitmap.GetHeight(),PixelFormat32bppARGB);

pngOutlineText.SetPngImage(pPngImage);

pngOutlineText.DrawString(&graphics,&fontFamily,

FontStyleRegular, 48, L"Text Designer",

Gdiplus::Point(10,10), &strFormat);

for(int i=0; i<nDiagonal; ++i)

graphics.DrawImage(pPngImage, i, i, pPngImage->GetWidth(),

pPngImage->GetHeight());

void CScratchPadDlg::DrawActualText(Gdiplus::Graphics& graphics,

PngOutlineText& pngOutlineText)

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

pngOutlineText.TextOutline(

Color(178,0,255),

Color(255,0,0,0),

pngOutlineText.EnableShadow(false);

Bitmap* pPngImage = new Gdiplus::Bitmap(m_bitmap.GetWidth(),

StringFormat strFormat;

m_bitmap.GetHeight(),PixelFormat32bppARGB);

pngOutlineText.SetPngImage(pPngImage);

pngOutlineText.DrawString(&graphics,&fontFamily,

FontStyleRegular, 48, L"Text Designer",

Gdiplus::Point(10,10), &strFormat);

graphics.DrawImage(pPngImage, 0, 0, pPngImage->GetWidth(), pPngImage->GetHeight());

For the above C++ code sample, I did not supply a C# equivalent code sample, because it was impossible to do blitting, using the previous version of .NET API because the .NET API makes a native copy of every managed object passed in. For example, if you supply a Graphics object with an internal Bitmap object, the PngOutlineText does not use that Graphics object to draw, instead it uses a native copy of that Graphics object to draw. As a result, the internal Bitmap will not get rendered. Since then, I have added GetCopyOfInternalPng method to PngOutlineText class to enable to do blitting with a copy of rendered PNG, using GDI+.

I have also added a method, called Extrude to do 3D text easily but this method is still not as fast as the previous "PNG blitting multiple times" method because the ExtrudeStrategy class is generic and it does not know whether OutlineText or PngOutlineText class is using it, so it cannot do any optimizations. Note: To Extrude, you have to EnableShadow because Extrude is treated like a type of shadow. Please note to achieve the 3D text effect, the shadow color has to be fully opaque (meaning 255) and the 3D extrude effect looks best when the absolute values of x and y offset are equal (For example, x=4,y=4 or x-4, y=4). Below is the C++ and C# sample code from the WYSIWYG clipboard code copy feature.

using namespace TextDesign;

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

OutlineText m_OutlineText;

m_OutlineText.TextOutline(

Color(255,128,192),

Color(255,128,0,0),

m_OutlineText.EnableShadow(true);

//Rem to SetNullShadow() to release memory if a previous shadow has been set.

m_OutlineText.SetNullShadow();

m_OutlineText.Extrude(

Gdiplus::Color(255,128,0,0),

Gdiplus::Point(8,8));

this->GetClientRect(&rect);

Color m_clrBkgd(255, 255, 255);

m_OutlineText.SetShadowBkgd(m_clrBkgd,rect.Width(),rect.Height());

m_OutlineText.DrawString(&graphics,&fontFamily,

StringFormat strFormat;

FontStyleRegular, 48, L"Text Designer",

Gdiplus::Point(10, 10), &strFormat);

Here is the equivalent C# code to call Extrude achieve 3D extruded text.

private void OnPaint(object sender, PaintEventArgs e)

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

OutlineText outlineText = new OutlineText();

outlineText.TextOutline(

Color.FromArgb(255, 128, 192),

Color.FromArgb(255, 128, 0, 0),

outlineText.EnableShadow(true);

//Rem to SetNullShadow() to release memory if a previous shadow has been set.

outlineText.SetNullShadow();

outlineText.Extrude(

Color.FromArgb(255, 128, 0, 0),

new Point(8, 8));

Color m_clrBkgd = Color.FromArgb(255, 255, 255);

outlineText.SetShadowBkgd(m_clrBkgd, this.ClientSize.Width, this.ClientSize.Height);

FontFamily fontFamily = new FontFamily("Arial Black");

StringFormat strFormat = new StringFormat();

outlineText.DrawString(e.Graphics, fontFamily,

FontStyle.Regular, 48, "Text Designer",

new Point(10, 10), strFormat);

Here is the settings to achieve 3D extruded text. You must enable the Extrude Text checkbox: (See the red rectangle!)

Rotated Italic Text

We have to use GdiDrawString method to display the rotated italic text because GdiDrawString takes in a LOGFONT structure which allows us to specify rotational angle through the lfEscapement and lfOrientation. While DrawString method uses AddString method, of GraphicsPath, which takes in a font family object instead of a font object, we do not have the ability to specify the rotational angle.

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

memset(&logfont, 0, sizeof(logfont));

LOGFONTW logfont;

wcscpy_s(logfont.lfFaceName, L"Arial Black");

logfont.lfHeight = -MulDiv(48, dc.GetDeviceCaps(LOGPIXELSY), 72);

logfont.lfEscapement = 100;

logfont.lfOrientation = 100;

logfont.lfItalic = 1;

text.TextOutline(Color(64,193,255),Color(0,0,0),8);

text.EnableShadow(false);

text.SetShadowBkgd(Color(255,255,255),rect.Width(),rect.Height());

text.Shadow(Color(128,0,0,0), 8, Point(4,4));

text.GdiDrawString(&graphics, &logfont, pszbuf, Gdiplus::Point(10,100));

The C# code to display the rotated text is removed, as the new C# library has not implemented this yet as this will involve the pinvoke data types which I am afraid may have portablilty issues.

These are the settings to display the rotated text:

Diffused Shadow and Sample Code

I have added diffused shadow to the outline text library. Click the checkbox as indicated by the green rectangle to enable diffuse shadow. Note: You have to tweak the shadow alpha values(ranged from 12 to 32) and shadow thickness (ranged from 8 to 12) to achieve the diffused shadow effect. Diffused shadow is implemented using the text glow effect, so the shadow thickness indicates how many times the shadow color will be rendered. So as a rule of thumb, the higher the shadow thickness, the lower shadow alpha value. I have also implemented WYSIWYG sample code generation. Click the "Copy C++ Code" and "Copy C# Code" buttons, indicated by the red rectangle, to copy the code to clipboard and paste it to your code editor! You may still have to edit the code in your editor to make it suit your requirement, for example, changing a local object to member object of your class. In the event of the sample code crashes, try changing the bitmap sizes to be the same and also please report this crash to me and the steps to reproduce it. Note: The crash, if there is any, is due to the sample code being wrong, not because something is wrong with the Text Designer Outline Library.

PngOutlineText Class

I have written a PngOutlineText class which renders the text and shadow to a Bitmap object with an alpha channel (PixelFormat32bppARGB format), so that you need not re-generate the text whenever you need to render the text again because outline text generation typically takes a long time, especially for text with shadow. Using PngOutlineText, you must call the SetPngImage method to set the PixelFormat32bppARGB format image for the PngOutlineText to render to. After the first DrawString or GdiDrawString, you need just to blit this image to your graphics object, instead of generating the same outline text through DrawString or GdiDrawString again. I create PngOutlineText class for use in video rendering which is typically about 30fps or 60fps. If you use a big image background in the TestOutlineText application, you will find resizing the application and scrolling the image is not smooth. If you check "Enable PNG Rendering" checkbox (See the highlighted red rectangle below), resizing and scrolling becomes smooth because the TestOutlineText application detects if the settings have not been modified, it will just blit the transparent text image instead. You can use the SavePngImage method to save the image to PNG image. If you open the image in any image editor, like Paint.Net or Adobe Photoshop, you will see the checkered boxes which is the transparent part of the PNG image.

Version 2 Preview 6 has added GDI path to C# library. Below is the C++ and C# code using GDI (instead of GDI+) to do the gradient text. The sample code is put here because the auto C# code generation for GDI is not correct.

Hide Shrink Copy Code

void CScratchPadDlg::OnPaint()

{

//CDialog::OnPaint();

using namespace Gdiplus;

using namespace TextDesigner;

CPaintDC dc(this);

Graphics graphics(dc.GetSafeHdc());

graphics.SetSmoothingMode(SmoothingModeAntiAlias);

graphics.SetInterpolationMode(InterpolationModeHighQualityBicubic);

OutlineText m_OutlineText;

m_OutlineText.TextGradOutline(

Color(255,128,64),

Color(255,64,0,64),

Color(255,255,128,255),

10);

m_OutlineText.EnableShadow(true);

//Rem to SetNullShadow() to release memory if a previous shadow has been set.

m_OutlineText.SetNullShadow();

m_OutlineText.Shadow(

Gdiplus::Color(128,0,0,0), 8,

Gdiplus::Point(4,4));

FontFamily fontFamily(L"Arial Black");

StringFormat strFormat;

float fStartX = 0.0f;

float fStartY = 0.0f;

float fDestWidth = 0.0f;

float fDestHeight = 0.0f;

m_OutlineText.MeasureString(

&graphics,

&fontFamily,

FontStyleRegular,

48,

L"TEXT DESIGNER",

Gdiplus::Point(10, 10),

&strFormat,

&fStartX,

&fStartY,

&fDestWidth,

&fDestHeight);

CRect rect;

this->GetClientRect(&rect);

Color m_clrBkgd(255, 255, 255);

m_OutlineText.SetShadowBkgd(m_clrBkgd,fDestWidth,fDestHeight);

FontFamily fontFamily(L"Arial Black");

StringFormat strFormat;

LinearGradientBrush gradientBrush(Gdiplus::Rect(fStartX, fStartY, fDestWidth-(fStartX-10), fDestHeight-(fStartY-10)),

Color(255, 128, 64), Color(255, 0, 0), LinearGradientModeVertical );

m_OutlineText.TextGradOutline(

&gradientBrush,

Color(255,64,0,64),

Color(255,255,128,255),

10);

m_OutlineText.DrawString(&graphics,&fontFamily,

FontStyleRegular, 48, L"TEXT DESIGNER",

Gdiplus::Point(10, 10), &strFormat);

}

Here follows the C# code.

Hide Shrink Copy Code

private void OnPaint(object sender, PaintEventArgs e)

{

e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;

e.Graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;

//Drawing the back ground color

Color m_clrBkgd = Color.FromArgb(255, 255, 255);

SolidBrush brushBkgnd = new SolidBrush(m_clrBkgd);

e.Graphics.FillRectangle(brushBkgnd, 0, 0, this.ClientSize.Width, this.ClientSize.Width);

PngOutlineText m_PngOutlineText = new PngOutlineText();

m_PngOutlineText.SetPngImage(new Bitmap(ClientSize.Width, ClientSize.Height));

m_PngOutlineText.TextGradOutline(

Color.FromArgb(255, 128, 64),

Color.FromArgb(255, 64, 0, 64),

Color.FromArgb(255, 255, 128, 255),

10);

m_PngOutlineText.EnableReflection(false);

m_PngOutlineText.EnableShadow(true);

//Rem to SetNullShadow() to release memory if a previous shadow has been set.

m_PngOutlineText.SetNullShadow();

m_PngOutlineText.Shadow(

Color.FromArgb(128, 0, 0, 0), 8,

new Point(4, 4));

LOGFONT m_LogFont = new LOGFONT();

m_LogFont.lfFaceName = "Arial Black";

m_LogFont.lfHeight = -48;

m_LogFont.lfOrientation = 0;

m_LogFont.lfEscapement = 0;

m_LogFont.lfItalic = false;

float fStartX = 0.0f;

float fStartY = 0.0f;

float fDestWidth = 0.0f;

float fDestHeight = 0.0f;

m_PngOutlineText.GdiMeasureString(

e.Graphics,

m_LogFont,

"TEXT DESIGNER",

new Point(10, 10),

ref fStartX,

ref fStartY,

ref fDestWidth,

ref fDestHeight);

m_PngOutlineText.SetShadowBkgd(m_clrBkgd, (int)fDestWidth+10, (int)fDestHeight+10);

LinearGradientBrush gradientBrush = new LinearGradientBrush(new RectangleF(fStartX, fStartY, fDestWidth - (fStartX - 10), fDestHeight - (fStartY - 10)),

Color.FromArgb(255, 128, 64), Color.FromArgb(255, 0, 0), LinearGradientMode.Vertical);

m_PngOutlineText.TextGradOutline(

gradientBrush,

Color.FromArgb(255, 64, 0, 64),

Color.FromArgb(255, 255, 128, 255),

10);

m_PngOutlineText.GdiDrawString(

e.Graphics,

m_LogFont,

"TEXT DESIGNER",

new Point(10, 10));

e.Graphics.DrawImage(m_PngOutlineText.GetPngImage(), new Point(0, 0));

brushBkgnd.Dispose();

e.Graphics.Dispose();

}

MeasureString and GdiMeasureString

I have implemented MeasureString and GdiMeasureString method for PngOutlineText. Please do not use Graphics::MeasureString, as Graphics::MeasureString is for Graphics::DrawString method. After you use MeasureString and GdiMeasureString to get the minimum width and height required, you should add some space to width and height, like 5 pixels. MeasureString and GdiMeasureString parameters are similar to DrawString and GdiDrawString, respectively, except for the additional 2 parameters to get the width and height. This is how MeasureString family methods are used. First call MeasureString to get the width and height, then allocate a PixelFormat32bppARGB format Bitmap which is slightly larger. Make your shadow background the same size as this PixelFormat32bppARGB Bitmap. Any bitmap will do as a shadow background as this does not affect rendering for PngOutlineText, however for OutlineText, you need to crop out the part of background for the shadow background. After setting up the outline text attributes, DrawString or GdiDrawString at point (0,0) position, then Graphics::DrawImage the PixelFormat32bppARGB Bitmap at the position you want the text to appear.

The above method is fine for outline text without shadow or the shadow is at the bottom right, meaning positive x and y offset. If one or both of the offsets is negative, it would not work out so nicely. Imagine you draw the text at point (0,0), the shadow offset is at point (-4,-4), so part of the shadow may not be seen. So if the shadow offset is at point (-4,-4), you DrawString the text at point (4,4) and Graphics::DrawImage the final PixelFormat32bppARGB Bitmap at original position subtracted by point (4,4). So in this way, whether your shadow is offset to the top or bottom or left or right, the text would always appear at the same position. Below is the code to accomplish this. Please note that the code below does not appear in the sample code because I do not want to confuse the beginners on how to use the PngOutlineText class as PngOutlineText sample code is already the longest.

m_PngOutlineText.MeasureString(&graphics,&fontFamily,FontStyleBold,

float fWidth=0.0f;

float fHeight=0.0f;

72, m_szText, Gdiplus::Point(0,0), &strFormat,

&fWidth, &fHeight);

m_pPngImage = new Bitmap(fWidth+5.0f, fHeight+5.0f, PixelFormat32bppARGB);

if(!m_pPngImage)

return;

m_PngOutlineText.SetPngImage(m_pPngImage);

m_PngOutlineText.SetNullShadow();

m_PngOutlineText.SetShadowBkgd(

Gdiplus::Color(GetRValue(m_clrBkgd),GetGValue(m_clrBkgd),GetBValue(m_clrBkgd)),

m_pPngImage->GetWidth(), m_pPngImage->GetHeight());

if(!m_bEnableShadow)

m_PngOutlineText.DrawString(

&graphics,&fontFamily,fontStyle,m_nFontSize,

m_szText,Gdiplus::Point(0,0), &strFormat);

graphics.DrawImage(m_pPngImage, (float)m_nTextPosX, (float)m_nTextPosY,

(float)m_pPngImage->GetWidth(), (float)m_pPngImage->GetHeight());

else

nShadowOffsetX = -m_nShadowOffsetX;

int nShadowOffsetX = 0;

if(m_nShadowOffsetX<0)

int nShadowOffsetY = 0;

if(m_nShadowOffsetY<0)

nShadowOffsetY = -m_nShadowOffsetY;

m_PngOutlineText.DrawString(&graphics,&fontFamily,

fontStyle,m_nFontSize,m_szText,Gdiplus::Point

(nShadowOffsetX,nShadowOffsetY), &strFormat);

graphics.DrawImage(m_pPngImage, (float)

(m_nTextPosX-nShadowOffsetX), (float)(m_nTextPosY-nShadowOffsetY),

(float)m_pPngImage->GetWidth(), (float)m_pPngImage->GetHeight());