Click here to Skip to main content
15,662,426 members
Articles / Programming Languages / C#
Posted 6 Mar 2008


40 bookmarked

Texture Transfer using Efros & Freeman's Image Quilting Algorithm

Rate me:
Please Sign up or sign in to vote.
4.68/5 (13 votes)
11 Mar 2008CPOL7 min read
A texture transfer program that implements Efros & Freeman's texture transfer algorithm


This article describes a texture transfer program I developed based on Efros & Freeman's SIGGRAPH 2001 paper:

  • Image Quilting for texture synthesis and transfer: pdf, ppt

Texture transfer is the process by which the texture of a source image is transferred to a target image. The result is that we get an image that looks like the target image but it is made out of the texture of the source image e.g. below are shown two images -- source, target and the result of transferring the texture of the source onto the target:

rice imageImage 3Image 4Image 5Image 6Image 7Image 8Image 9Image 10
sourcetargetfirst iterationsecond iterationthird iteration

The source is an image of rice and the target is the man's face. After texture transfer we get a face that looks as though it is made out of rice. How do we do this? The idea is to take patches of rice and weave them together seamlessly into the image of the face. Bright patches of rice will goto areas where the face is bright and dark patches will goto areas where the face is dark. To illustrate the concept, in the image below the boundaries of the individual patches have been colored in red. You can find each of these patches in the rice image if you look for them hard enough.

Image 11

The Texture Transfer Algorithm

The texture transfer algorithm has to synthesize an image from the pixels of the source. Locally the result should have the appearance of the source texture but when looked at globally the result should look like the target. The texture transfer proceeds by synthesizing an image in faster scan order in units of block. You can control the size of the block in the setting window and it is set to 27x27 pixels by default. Whenever a block in the result has to be synthesized the algorithm needs to find a suitable block in the source texture that satisfies two criteria:

  1. The block should match the target, meaning bright patches of rice should go to bright patches on the man's face.
  2. After making some cuts, the block should fit in seamlessly with its adjoining neighbors so that we don't see any visual discontinuities and don't even realize that the result is actually made up of many blocks put size by side like a jigsaw puzzle.

To this end for every patch in the source image the algorithm computes two difference measures d1, d2 that quantify how well criterion 1 and 2 above are satisfied and their weighted sum

  • d = (1-a)d1 + ad2

The algorithm chooses the patch that minimizes d. The function GetMatchingBlock in TextureTransferTool.cs does this computation. The next step after choosing a matching block is to cut it appropriately so that it fits in seamlessly with the adjoining neighbors. It is because of these cuts that the patches in figure have jagged boundaries. If no cuts were made the boundaries would be straight lines and we would get something that looked like following image:

Image 12

The algorithm synthesizes the result in several passes or iterations starting with a low value of a (a=0.1) and initial block size set to 27x27 pixels by default and decreasing block size by 1/3 rd in every iteration and increasing alpha until a=0.9 in the final iteration. The number of iterations to do is set to 3 by default. The following code snippet from function OnDoWork in TextureTransferTool.cs shows the main texture transfer code. The texture transfer runs in a separate BackgroundWorker thread so that it does not block the UI thread from processing keyboard and mouse events.

for (int i = 0; i < numIterations; i++)
                bool isFirstIteration = i == 0;
                // from Alyosha's paper
                double alpha = 0.8 * i / (numIterations - 1) + 0.1;     
                nextX = 0; nextY = 0; nextBlockWidth = blockWidth; nextBlockHeight = 
                    blockHeight; nextOverlapX = 0; nextOverlapY = 0;
                bool completed = false;
                while (!completed && !CancellationPending)
                    Point q = new Point(nextX, nextY);  
                    // get matching block from src which will be pasted at location q in img
                    p = GetMatchingBlock(img, src, target, q, nextOverlapX, nextOverlapY,
                        nextBlockWidth, nextBlockHeight, alpha, isFirstIteration, probe,
                        out eh, out ev);                    
                    // the horizontal and vertical cuts will ensure that the patch
                    // from src will fit in seamlessly when it is pasted onto img
                    int[] Hcut = findHcut(eh);  // compute the horizontal cut
                    int[] Vcut = findVcut(ev);  // compute the vertical cut
                    // cut the block per the horizontal and vertical cuts and then
                    // paste it onto img
                    cutandpaste(src, p, img, q, Hcut, Vcut, nextBlockWidth,
                        nextBlockHeight, displayBoundaryCut);
                    // calculate how much of texture transfer is complete; 1->fully 
                    // completed
                    double fractionComplete = CalculateFractionComplete(i, numIterations, 
                        nextX, nextY, nextBlockWidth,
                        nextBlockHeight, imgWidth, imgHeight);
                    int percentComplete = (int)Math.Round(fractionComplete * 100);
                    // send progress report to UI thread
                    ReportProgress(percentComplete, new ProgressReport(fractionComplete, 
                    // (nextX, nextY): coordinates of top left corner in img where next 
                    // block is to be synthesized;
                    // (nextBlockWidth, nextBlockHeight): dimensions of block to be 
                    // synthesized
                    // (nextOverlapX, nextOverlapY): the amount by which block will will 
                    // overlap neighbors completed: is this iteration complete
                    Next(X, Y, blockWidth, blockHeight, imgWidth, imgHeight, overlapX, 
                        overlapY, out nextX, out nextY, out nextBlockWidth,
                        out nextBlockHeight, out nextOverlapX, out nextOverlapY,
                        out completed);                    
                    X = nextX; Y = nextY;                    
                if (CancellationPending)
                    e.Cancel = true;
                X = 0; Y = 0;
                blockWidth = (int)Math.Round(blockWidth * blockReductionFactor);
                blockHeight = (int)Math.Round(blockHeight * blockReductionFactor);
                probeWidth = srcWidth - blockWidth;
                probeHeight = srcHeight - blockHeight;
                probe.Reset(probeWidth, probeHeight);
                overlapX = (int)Math.Round(overlapX * blockReductionFactor);
                overlapY = (int)Math.Round(overlapY * blockReductionFactor);
                if (overlapX >= blockWidth || overlapY >= blockHeight || blockWidth == 
                    0 || blockHeight == 0)

Steps to Perform Texture Transfer

  • Step 1: Select source image. Note that only 24 bit RGB images are supported (most jpegs will fall in this category). Indexed images (most gifs fall in this category) are not supported.
  • Step 2: Select target image. Note that only 24 bit RGB images are supported (most jpegs will fall in this category). Indexed images (most gifs fall in this category) are not supported.
  • Step 3: (Optional) change settings if you have to. Clicking on the settings button will pop up a window that looks like this:

    Image 13

    Here is what the various parameters mean:

    • Number of iterations: the number of iterations to do
    • Block width: width of the block in the 1st iteration; units:pixels
    • Block height: height of the block in 1st iteration; units: pixels
    • Overlap in X: percentage of overlap along X dimension
    • Overlap in Y: percentage of overlap along Y dimension
    • Block reduction factor: percentage by which block size is reduced in each iteration. New block size = old block size * Block reduction factor
    • Fraction of source image to probe: Texture transfer is a time consuming process and can easily take a couple of hours for a large source and/or target. The code is not optimized for performance and is written for ease of use and understanding. By changing this setting it is possible to change the extent by which the source image is probed or searched to find matching texture blocks. When this parameter is set to 100% the entire source image is searched to find the matching block in function GetMatchingBlock. When the parameter is set to 10% only 10% of the source image is probed in a random fashion to search for a matching block. Thus the function GetMatchingBlock runs 10 times faster when this parameter is set to 10% vs. when it is set to 100%. Note that decreasing the amount to probe does not necessarily decrease the visual quality of the result but is guaranteed to speed up the texture transfer.
    • Display boundary cut: If this box is checked then the boundaries of the individual patches are colored in red
    • Difference metric: The program allows the user to select between two distance metrics when computing the difference between source and target:
      • Option 1: SSD (sum of squared differences) metric which computes the sum of squared R,G,B differences; see function Diff in rgb.cs
      • Option 2: Intensity difference squared which computes the square of the intensity difference; see function Diffi in rgb.cs
  • Step 4: if you like the result you can save the resulting image by clicking on the "Save Result As" button. Note that it is also possible to save the intermediate results when the texture transfer is in progress using this button.


In the following table I show some results I have obtained using the texture transfer program. These results are generated with amount to probe set to 10% and distance metric set to SSD. Note that the images have been resized to fit on the screen. Therefore if you download these images and run the program it is likely that you may not get the exact same results.

SourceTargetDifference=SSD; Amount to probe=10%
Image 14Image 15Image 16
Image 17Image 18Image 19
Image 20Image 21Image 22
Image 23Image 24Image 25
Image 26Image 27Image 28
Image 29Image 30Image 31
Image 32Image 33Image 34
Image 35Image 36Image 37
Image 38Image 39Image 40
Image 41Image 42Image 43

Wrap Up

This was a fun project for me as it introduced me to Computer Graphics and some neat features in C# 2.0 such as the BackgroundWorker class, dynamic layout and panels. I hope some of you find it useful in your work. Suggestions for improvement and bug reports are always welcome.

Updates & Revision history

3/7/08: I created this project using Visual C# Express Edition 2008 and have noticed if you attempt to open the solution using VS 2005 it gives an error message. If you encounter this just create a new project and add the source code contained in the zip file, compile and run. The only references you should need are System, System.Windows.Forms and System.Drawing.

3/11/08: Related links: Rob Burke's C# texture transfer code

7/26/10: I am attaching a zip file that has source code + Visual Studio Project for my texture transfer article. What I have done here is ported the application to use .NET 4.0 TPL (Task Parallel Library). My hope was that the application would run faster as it consumes all the CPUs of the machine. However, the new code's performance is only marginally better and in many cases even worse. Taking advantage of parallelism is no easy task, and full of gotcha's e.g. who knows maybe my new code is suffering from false sharing. But I would still like to upload this source code as a TPL tutorial, and maybe someone can make it faster.


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

Written By
Software Developer
United States United States
Creator of

Comments and Discussions

Questionquestion: is iteration used for refining the texture transfer result? Pin
HCYU29-Jan-09 6:23
HCYU29-Jan-09 6:23 
AnswerRe: question: is iteration used for refining the texture transfer result? Pin
SIDDHARTH_JAIN29-Jan-09 6:32
SIDDHARTH_JAIN29-Jan-09 6:32 
GeneralRe: question: is iteration used for refining the texture transfer result? Pin
HCYU29-Jan-09 8:10
HCYU29-Jan-09 8:10 
GeneralRe: question: is iteration used for refining the texture transfer result? Pin
Member 826253020-Apr-12 11:54
Member 826253020-Apr-12 11:54 
GeneralCool pictures Pin
rcollina25-Aug-08 23:58
rcollina25-Aug-08 23:58 
GeneralVery Slow Pin
Aamir Mustafa8-Mar-08 1:20
Aamir Mustafa8-Mar-08 1:20 
GeneralRe: Very Slow Pin
SIDDHARTH_JAIN8-Mar-08 4:46 
GeneralRe: Very Slow Pin
Shao Voon Wong16-Mar-08 23:55
mvaShao Voon Wong16-Mar-08 23:55 
GeneralRe: Very Slow Pin
SIDDHARTH_JAIN17-Mar-08 6:37
SIDDHARTH_JAIN17-Mar-08 6:37 
GeneralTidy the article formatting Pin
NormDroid6-Mar-08 21:08
professionalNormDroid6-Mar-08 21:08 
GeneralRe: Tidy the article formatting Pin
SIDDHARTH_JAIN7-Mar-08 7:44 
GeneralSource Code Not Available Pin
Aamir Mustafa6-Mar-08 19:51
Aamir Mustafa6-Mar-08 19:51 
GeneralRe: Source Code Not Available Pin
leppie6-Mar-08 20:35
leppie6-Mar-08 20:35 

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.