View Full Version : Creating a white outline around text texture Open-ES 2.0

Hank Finley
10-27-2013, 05:16 PM
Hi, I have just learned how to render text on to the screen. This text is rendered on top of a map. For clarity, what I would like to do is make a white outline or glow (just a couple of pixels wide) around the rendered text.

The fonts come from a ttf file and get transformed into a bitmap texture atlas.

Below is a screen shot: (Bottom left is where the text is)

carsten neumann
10-28-2013, 01:59 AM
You could first draw the text with the bold form of the font in white and then draw the regular text on top of it. Valve's technique using distance fields to store the font glyphs (paper (http://www.valvesoftware.com/publications/2007/SIGGRAPH2007_AlphaTestedMagnification.pdf)) also allows adding an outline in a shader.

Hank Finley
10-28-2013, 07:33 AM
Thanks Carsten, I think if I can implement it in the shader I will, however implementing what Valve has done into it has got me a little baffled.

Below is my vertex and fragment shader.

public static String getFontVertexShader()
"precision highp float; \n"
+ "uniform mat4 u_MVPMatrix; \n" // An array representing the combined model/view/projection matrices for each sprite

+ "attribute vec4 a_Position; \n" // Per-vertex position information we will pass in.
+ "attribute vec2 a_TexCoordinate; \n" // Per-vertex texture coordinate information we will pass in
+ "varying vec2 v_TexCoordinate; \n" // This will be passed into the fragment shader.
+ "void main() \n" // The entry point for our vertex shader.
+ "{ \n"
+ " v_TexCoordinate = a_TexCoordinate; \n"
+ " gl_Position = u_MVPMatrix * a_Position; \n" // gl_Position is a special variable used to store the final position.
+ "} \n";

public static String getFontFragmentShader()
"precision highp float; \n" // Set the default precision to medium. We don't need as high of a precision in the fragment shader.
+ "uniform sampler2D u_Texture; \n" // The input texture.
+ "uniform vec4 u_Color; \n"
+ "varying vec2 v_TexCoordinate; \n" // Interpolated texture coordinate per fragment.

+ "void main() \n" // The entry point for our fragment shader.
+ "{ \n"
+ " gl_FragColor = (u_Color * texture2D(u_Texture, v_TexCoordinate).w); \n"
+ "} \n";

Would really appreciate help on this

carsten neumann
10-28-2013, 08:13 AM
Hmm, what exactly is your question?
As a simpler alternative and since (if I read it correctly) you are only using the alpha channel of your texture you could implement a simple edge detection in your fragment shader and use a different colour if you detect an edge texel. For the edge detection, in addition to sampling at the fragment's texture location sample neighbouring texels and determine if the values are "similar enough" - you should be able to find lots of material on this, since it is used for many post processing effects as well as a whole bunch of anti-aliasing techniques.

PS: source code is usually easier to read in a monospace font,
tags should take care of that.

Hank Finley
10-28-2013, 08:34 AM
Yes I am only using the alpha. Edge detection sounds promising I will check it out.
PSS: Next time round I will do that.

Hank Finley
10-28-2013, 06:01 PM
I have found this fragment shader at example (http://littlecheesecake.me/blog/13804700/opengles-shader):

precision mediump float;
uniform sampler2D u_Texture;
varying vec2 v_TexCoordinate;

void main()
vec3 irgb = texture2D(u_Texture, v_TexCoordinate).rgb;
float ResS = 720.;
float ResT = 720.;

vec2 stp0 = vec2(1./ResS, 0.);
vec2 st0p = vec2(0., 1./ResT);
vec2 stpp = vec2(1./ResS, 1./ResT);
vec2 stpm = vec2(1./ResS, -1./ResT);

const vec3 W = vec3(0.2125, 0.7154, 0.0721);

float i00 = dot(texture2D(u_Texture, v_TexCoordinate).rgb, W);
float im1m1 = dot(texture2D(u_Texture, v_TexCoordinate-stpp).rgb, W);
float ip1p1 = dot(texture2D(u_Texture, v_TexCoordinate+stpp).rgb, W);
float im1p1 = dot(texture2D(u_Texture, v_TexCoordinate-stpm).rgb, W);
float ip1m1 = dot(texture2D(u_Texture, v_TexCoordinate+stpm).rgb, W);
float im10 = dot(texture2D(u_Texture, v_TexCoordinate-stp0).rgb, W);
float ip10 = dot(texture2D(u_Texture, v_TexCoordinate+stp0).rgb, W);
float i0m1 = dot(texture2D(u_Texture, v_TexCoordinate-st0p).rgb, W);
float i0p1 = dot(texture2D(u_Texture, v_TexCoordinate+st0p).rgb, W);
float h = -1.*im1p1 - 2.*i0p1 - 1.*ip1p1 + 1.*im1m1 + 2.*i0m1 + 1.*ip1m1;
float v = -1.*im1m1 - 2.*im10 - 1.*im1p1 + 1.*ip1m1 + 2.*ip10 + 1.*ip1p1;
float mag = length(vec2(h, v));
vec3 target = vec3(mag, mag, mag);
gl_FragColor = vec4(mix(irgb, target, 1.0),1.);

I have altered this so ResS = 17, ResT = 24 for my own texture size.
After testing this however it just displays a black box, I guess this is caused by the fact that it is not using alpha?

My questions are:
What do I need to change to get it to work with alpha.
What is the process, do I do two draws first to draw the white edge I am after, then do a second draw for the actual text itself?

carsten neumann
10-29-2013, 05:54 AM
If I'm reading it correctly it converts each RGB sample to a luminance value (with the dot product with W). I suppose you could try getting rid of that and just use the alpha component of the texture. What also looks odd is the mix() call at the bottom, since the last parameter is a constant it does not really interpolate between irgb and target, but always uses the value of target.

Hank Finley
10-29-2013, 10:20 PM
I have modified things to be a little simpler, or so I thought.
I have tried creating a bitmap with the same fonts, except bold and white. This is going to provide me with a white outline(background) for my black text.

I save out the bitmap to a png file to check that it is correct, it is correct. Below is the screen shot from opening the png in fireworks)

Somewhere in between the loading of the texture and the rendering it is sticking in grey on the edges. Below is a screenshot, I have only rendered the white background in the bottom left corner.

Below is my texture loader, shader and the third is the draw function which has the blend I'm using.

At the moment I just trying to get the white background rendering correctly.
How do I get rid of the grey?

public static int loadFontTexture(Bitmap bitmap)
final int[] textureHandle = new int[1];
GLES20.glGenTextures(1, textureHandle, 0);

if (textureHandle[0] != 0)
// Bind to the texture in OpenGL
GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, textureHandle[0]);

// Set filtering

// Load the bitmap into the bound texture.
GLUtils.texImage2D(GLES20.GL_TEXTURE_2D, 0, bitmap, 0);

if (textureHandle[0] == 0)
throw new RuntimeException("Error loading texture.");
return textureHandle[0];

public static String getFontFragmentShader()
"precision highp float; \n" // Set the default precision to medium. We don't need as high of a
// precision in the fragment shader.
+ "uniform sampler2D u_Texture; \n" // The input texture.
+ "varying vec2 v_TexCoordinate; \n" // Interpolated texture coordinate per fragment.

+ "void main() \n" // The entry point for our fragment shader.
+ "{ \n"
+ " gl_FragColor = (texture2D(u_Texture, v_TexCoordinate));\n" // Pass the color directly through the pipeline.
+ "} \n";

private void drawSystemFontTextures()

mFontMVPMatrixHandle = GLES20.glGetUniformLocation(mFontTextureProgramHan dle, "u_MVPMatrix");
mFontPositionHandle = GLES20.glGetAttribLocation(mFontTextureProgramHand le, "a_Position");
mFontTextureCoordinateHandle = GLES20.glGetAttribLocation(mFontTextureProgramHand le, "a_TexCoordinate");
mTextureUniformHandle = GLES20.glGetUniformLocation(mFontTextureProgramHan dle, "u_Texture");


// Set the active texture unit to texture unit 0.
// Bind the texture to this unit.
GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, glText.mFontTextureDataHandle);
// Tell the texture uniform sampler to use this texture in the shader by binding to texture unit 0.
GLES20.glUniform1i(mTextureUniformHandle, 2);

GLES20.glUniformMatrix4fv(mFontMVPMatrixHandle, 1, false, mMVPMatrix, 0);

// Pass in the position information
GLES20.glVertexAttribPointer(mFontPositionHandle, glText.POSITION_CNT_2D, GLES20.GL_FLOAT, false, glText.VERTEX_SIZE * mBytesPerFloat, glText.vertices);
GLES20.glEnableVertexAttribArray(mFontPositionHand le);

// bind texture position pointer
glText.vertices.position(glText.POSITION_CNT_2D); // Set Vertex Buffer to Texture Coords (NOTE: position based on whether color is also specified)
GLES20.glVertexAttribPointer(mFontTextureCoordinat eHandle, glText.TEXCOORD_CNT, GLES20.GL_FLOAT, false, glText.VERTEX_SIZE * mBytesPerFloat, glText.vertices);
GLES20.glEnableVertexAttribArray(mFontTextureCoord inateHandle);

// Draw the cube.
GLES20.glDrawElements(GLES20.GL_TRIANGLES, glText.indices.capacity(), GLES20.GL_UNSIGNED_SHORT, glText.indices);