Custom Bitmap Effects - HLSL
Monday, 14 June 2010
Article Index
Custom Bitmap Effects - HLSL
Constants and samplers
The default sampler
Embossed effect


An embossed effect

Now that we have most of the mechanics of creating a custom effect out of the way all that remains is to work out how to manipulate pixels to create good looking effects - this is a lifetime of fun.

To demonstrate how things work let's try an embossed effect.

This works by taking the difference between neighbouring pixels and converting the result to a grey scale image.

The shader is fairly simple:

sampler2D bitmap1:register(s0);

float4 main(float2 uv:TEXCOORD):COLOR

float4  result=tex2D(bitmap1,uv);
return result;

The sampler is supplied by register s0 and this can be explicitly set as a brush or the default rendered brush.

The main function starts off as usual and stores the color of the current pixel in result. Next it subtracts the color of the pixle 0.005 to the left of the current pixel. Notice the use of the .rgb selector or "swizzel" to perform a simple vector update. Only the difference between the RGB values is computed, the Alpha component is ignored. In the same way the next statement:


only adds 0.5 to each of the RGB values. This changes the mean of the color values from zero to 0.5.

Finally the color is removed by averaging the three color values.

If you now create an EmbossEffect class with a suitable dependency property:

public class EmbossEffect:ShaderEffect
public Brush Bitmap1
  get{ return
(Brush)GetValue(Bitmap1Property); }

  set{ SetValue(Bitmap1Property,value);}

 public static
  Bitmap1Property =
 public EmbossEffect()
  PixelShader pixelShader =
new PixelShader();

  Uri uri = new Uri(
Directory.GetCurrentDirectory() +

pixelShader.UriSource = uri;
this.PixelShader = pixelShader;

You can now apply the new effect:

Uri uri = new Uri(
Directory.GetCurrentDirectory() + 
@"\test.jpg", UriKind.Absolute);

BitmapImage bmi = new BitmapImage(uri);
ImageBrush pic=new ImageBrush(bmi);
EmbossEffect BE = new EmbossEffect();
button1.Effect = BE;

The result can be seen below:


The embossed effect

Summary of key points

  • The shader consists of a kernel function which is applied to every pixel in the area needed to render the control that the effect is applied to.
  • The kernel function works with variables that are assigned to registers that contain constants and samplers.
  • For each register that you want to set within your C# program to either a constant or a sampler you have to create a dependency property and associate it with the register.
  • Any sampler dependency property not explicitly set can be made to default to a bitmap that is the result of rendering the control that the bitmap is assigned to.
  • All co-ordinates are scaled to (0,0) top left and (1,1) bottom right
  • You can increase the area the effect works with using the Padding properties of the ShaderEffect class.

Where next?

All you really need to do now is to examine code written in HLSL to implement various effects and learn how to extend, modify and make your own up from scratch. Notice that you already know how to use multiple bitmaps within a shader, pass constants to control it and change the side of the rendered area.

To access the code for this project, once you have registered,  click on CodeBin.


WPF .NET Core - Inside Dependency Properties

One of the great mysteries of WPF is the strangely named "Dependency Properties". In this chapter we learn how dependency properties really work by creating a custom dependency property

Custom Bitmap Effects - Getting started

The simplest possible custom effects project is enough for you to see how it all works and to move on to building your own effects that do something useful. This is an introduction to using HLSL in WP [ ... ]

RenderTargetBitmap - Visual vector to bitmap

RenderTargetBitmap will convert any Visual to a bitmap but sometimes it isn't quite as straighforward as just calling Render().

Loading Bitmaps: DoEvents and the closure pattern

Sometimes loading a bitmap causes an asynchronous download and you have to wait for it to complete before using it - but how best to wait? The standard solution is to use an event but this breaks what [ ... ]

Bitmap Coding and Metatdata in WPF

Having looked at working with raw pixel data we turn our attention to formattted image files and how to code and decode both the pixel data and the meta data they contain.


Other Articles






Last Updated ( Tuesday, 27 July 2010 )