You are here

Warp Text

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0
Rate this item!
sg-warptext.scm23.89 KB

This script will warp text to fit inside a four-point "Bezier patch". The bezier patch is created with the Path Tool by first placing an anchor where the upper-left corner of the text should go, followed by three more anchors running clockwise around the perimeter.

Once your shape path is created, you can run the script (found under "Filters->Distorts->Warp Text...") on any text layer and eventually, after a good deal of huffing and puffing by the script, a new path will be created which is the outline of the text warped to fit within the path. Basically, you are left just as you would be after doing a "Text along Path" in the Text tool Options dialog -- you are left to your own devices as to stroking the path, selecting from it and filling, etc.

Broken Link

One caveat is that the path coming out of an anchor should proceed "towards" the adjacent anchor. In other words, the angle of a line from the anchor to its control handle and a line between the anchor and the next anchor must not exceed 90 degrees. The script will still function if this advise isn't heeded, but the results may be unpleasant.

Broken Link

The script's dialog offers the option to warp any path, not just text. And also permits specifying a Padding value and a Quality setting. The "Quality" setting can range from "1" (where letters are barely recognizable) to "250"; I don't notice much improvement above "100" and I set the default to "60" as a speed versus quality compromise (higher quality settings may be necessary for larger images).

The results achieved are not perfect, and the script is rather slow; but it can be useful for certain applications. Some discussion about the script and examples of it in use can be found at GIMPchat forums (special thanks to the members of that forum who helped me debug the script).

Code License: 
GIMP Version: 
Scripting Engine: 


Hi there,

I have used this plugin successfully many times but recently I have received this error part way through the process:

Plug-In 'Warp text' left image undo in inconsistent state, closing open undo groups.

Can you help?

Can you provide more detail about what is occurring? Perhaps share or describe the original setup and describe at what point in the execution the error appears. Also, background information such as operating system and GIMP version.

Hi All

I have tried to use warp text but the paths dropdown is empty, anyone know why?



Here is a "How To" Video:

You create a new doc, then select the text tool and create some text.
Then you create a new layer and use the PATHS tool to create a 4 point path starting from the upper left of where you want the text to be.
Close the path by selecting ctrl key while clicking the beginning top left node.
Now select your text layer and run the script.


I like how you explain how to use the script in the comment
and i like the script too

Very cool. Love the ability to shape text blocks into something not "blocky."

Thanks for the great script.

Very valueable script. No kidding. I did not even know about such opportunities of Script-Fu.

Thanks Saul; been looking for something like this to create figure outlines out of text like an Elephant figure for instance. I know the limit is 4 points; figure I can link multiple text distortions for what I want. :)

This has got to be destined to be included into future versions of GIMP.
Thanks saulgoode for this fine addition to the program!

Subscribe to Comments for "Warp Text"