It is currently Mon Nov 16, 2026 6:03 pm


All times are UTC - 5 hours [ DST ]



Post new topic Reply to topic  [ 17 posts ] 
Author Message
 Post subject: Puppet warp for Gimp 3.2
PostPosted: Sat Oct 17, 2026 4:21 am  (#1) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
Hi everyone

I've developed a new Python plugin for GIMP 3.0/3.2 called Puppet warp, after Gimp added powerful Non-Destructive Editing (NDE) features and N-Point Deformation Tool but it is buried in Edit > Preferences > Playground as an experimental feature , and many users report that it has not worked properly since around GIMP 2.10.14. Some people also mention it crashes when you try to commit the deformation. In practice, most GIMP users simply do not have a usable mesh deformation workflow.

So I built a Puppet Warp plugin that actually works as a proper tool.

How it works:

1. Warping

Click to add pins, drag to deform; Shift snaps a drag to an axis
Rotate and scale around any pin (orange ring: drag the dot to rotate, drag the body to scale; or Alt+wheel / Ctrl+wheel)
Per-pin taper — how far a pin's influence reaches before it fades to the rest of the mesh (Shift+wheel, or the T field)
Per-pin depth — when two warped regions overlap, higher depth draws in front ([ / ], or the D field). See Pin depth
Pin Edge keeps the outer mesh border at its rest position
Stiffness mesh derived from the layer's alpha: transparent areas stay soft, so a pin on empty background barely tugs the artwork

2. Canvas & preview

Extend image grows the layer when pins pull pixels outside its bounds; the layer mask (if any) grows with it
Live preview with three background modes: Below (first visible layer under), Composite (stack of all visible layers under), Off
Mesh overlay in four styles (Cells / Triangles / Both / Off) with a custom line color, so you can see the quad grid while you work
Pan, zoom, fit-to-view; the view widens automatically to show extended pixels

3. Workflow

Undo / redo inside the dialog (Ctrl+Z, Ctrl+Shift+Z / Ctrl+Y)
Multi-select pins (Shift+click, Ctrl+A), nudge with arrow keys (Shift = 10 px)
Save / load the whole setup (pins, depth, taper, grid, options) as a JSON preset
Non-destructive: every parameter is stored as JSON on the layer filter and travels with the .xcf. Reopen the tool to continue editing — including after an extend, where the padding is re-detected so pins never drift

I would be grateful if you could let me know if you encounter any issues.

I hope this speeds up your workflow in GIMP.


Attachments:
2026-10-17-142721_1920x1080_scrot.png
2026-10-17-142721_1920x1080_scrot.png [ 889.9 KiB | Viewed 1903 times ]
puppet-warp-linux-x86_64.zip [82.17 KiB]
Downloaded 56 times
Share on Facebook Share on Twitter Share on Orkut Share on Digg Share on MySpace Share on Delicious Share on Technorati
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sun Oct 18, 2026 4:27 am  (#2) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
Here’s the installer file for Windows. Give it a test and let us know if you find any bugs!


Attachments:
puppet-warp-window-x64.zip [74.38 KiB]
Downloaded 55 times
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Oct 19, 2026 5:09 am  (#3) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
I placed the dll file in the gegl-04/plugins folder and the python file in the puppet-warp folder in the gimp-3.2 plugins folder and restarted gimp.

I am able to run the GEGL plugin thru GEGL Operations under the tools menu. But it doesn't work. No dialog window to work with.


No other menu options show up. No item under filters, nor tools menus.

This is with Windows 10 64 bit.

EDIT: I should also mention that the python file does register when Gimp-3.2 loads. So it does find the plug-in but doesn't register any menu items.

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Oct 19, 2026 8:17 am  (#4) 
Offline
GimpChat Member

Joined: Mar 04, 2011
Posts: 2629
Rod wrote:
....big snip...
EDIT: I should also mention that the python file does register when Gimp-3.2 loads. So it does find the plug-in but doesn't register any menu items.


It should work, a bit about it here: https://www.gimp-forum.net/Thread-puppe ... 3#pid47903


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Thu Oct 22, 2026 4:36 am  (#5) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
The newest dll fix doesn't work either.
Possibly it doesn't work in windows 10?

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Thu Oct 22, 2026 6:15 am  (#6) 
Offline
GimpChat Member

Joined: Mar 04, 2011
Posts: 2629
Rod wrote:
The newest dll fix doesn't work either.
Possibly it doesn't work in windows 10?


Who knows ? Fired up my old laptop.

This a Win 10 VM / Gimp 3.2.2 (not got round to updating yet ;) )

Attachment:
win10.jpg
win10.jpg [ 118.14 KiB | Viewed 1696 times ]


Maybe check the file sizes
C:\Users\rich\AppData\Roaming\GIMP\3.2\plug-ins\puppet-warp\puppet-warp.py file size 150 KB (154,144 bytes)
C:\Users\rich\AppData\Local\gegl-0.4\plug-ins\puppet-warp.dll file size 72.1 KB (73,856 bytes)


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sat Oct 24, 2026 7:13 am  (#7) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
rich2005 wrote:
Rod wrote:
The newest dll fix doesn't work either.
Possibly it doesn't work in windows 10?


Who knows ? Fired up my old laptop.

This a Win 10 VM / Gimp 3.2.2 (not got round to updating yet ;) )

Attachment:
win10.jpg


Maybe check the file sizes
C:\Users\rich\AppData\Roaming\GIMP\3.2\plug-ins\puppet-warp\puppet-warp.py file size 150 KB (154,144 bytes)
C:\Users\rich\AppData\Local\gegl-0.4\plug-ins\puppet-warp.dll file size 72.1 KB (73,856 bytes)


Thanks for testing Rich. File sizes match up here as well. Dunno what the reason could be that it doesn't work.
I'll keep working at it and keep you updated. I downloaded the latest release and will re-install.

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sat Oct 24, 2026 7:40 am  (#8) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
I even tried removing all installed plug-ins in the plug-in user folder except puppet-warp.
Still no go. :hoh

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sat Oct 24, 2026 9:49 am  (#9) 
Offline
GimpChat Member

Joined: Mar 04, 2011
Posts: 2629
Rod wrote:
I even tried removing all installed plug-ins in the plug-in user folder except puppet-warp.
Still no go. :hoh


Probably a GEGL thing. It is the sort of plugin that Krita has and Gimp lacks.

A similar plugin without a GEGL dependency https://github.com/bunnywaffle/gimp-mesh-warp I wonder if it works in your Win 10 / Gimp 3

Download the zip. A bit strange, two identical plugins with different names mesh-warp.py or mesh_warp.py Choose one and make sure the folder name matches the plugin name. ie mesh-warp.py in a folder mesh-warp

looks like this:

Attachment:
meshwarp.jpg
meshwarp.jpg [ 71.72 KiB | Viewed 1587 times ]


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sat Oct 24, 2026 12:19 pm  (#10) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
rich2005 wrote:
Rod wrote:
I even tried removing all installed plug-ins in the plug-in user folder except puppet-warp.
Still no go. :hoh


Probably a GEGL thing. It is the sort of plugin that Krita has and Gimp lacks.

A similar plugin without a GEGL dependency https://github.com/bunnywaffle/gimp-mesh-warp I wonder if it works in your Win 10 / Gimp 3

Download the zip. A bit strange, two identical plugins with different names mesh-warp.py or mesh_warp.py Choose one and make sure the folder name matches the plugin name. ie mesh-warp.py in a folder mesh-warp

looks like this:

Attachment:
meshwarp.jpg


This gimp-mesh-warp plug-in does not work either. Must have something to do with the python file itself. Too bad.
I even removed the pluginrc file and restarted Gimp. Still no menu items. Kind of weird that it works for you in a virtual machine for windows 10 and not in mine. Also something kind of strange is my stablehorde AI python plug-in for Gimp-3 no longer works.

Thanks for all your help though Rich. :bigthup

Looks like something the author of the plugin needs to fix.
One thing i really do not get is that all the no show plugins get registered when Gimp-3.2.6 loads.
stablehorde AI
gimp-mesh-warp
puppet-warp

Is anyone else having this problem running Windows 10?

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Fri Oct 30, 2026 9:03 am  (#11) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
So I looked into it, and it turns out Microsoft tightened their Mark of the Web security, which is why downloaded files are getting blocked. Just check the Unblock box, unzip it, then toss the .dll file into C:\Users\XXXXXXXXX\AppData\Local\gegl-0.4\plug-ins\ and the python file into C:\Users\XXXXXXXXX\AppData\Roaming\GIMP\3.2\plug-ins\puppet-warp\.



Sorry for the late reply! I've been working on a major GIMP fork to turn this plugin and the mesh warp plugin into native tools that run right on the GIMP 3 canvas.


Attachments:
[Untitled].png
[Untitled].png [ 250.19 KiB | Viewed 1262 times ]
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Sun Nov 01, 2026 7:00 am  (#12) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
Hex wrote:
So I looked into it, and it turns out Microsoft tightened their Mark of the Web security, which is why downloaded files are getting blocked. Just check the Unblock box, unzip it, then toss the .dll file into C:\Users\XXXXXXXXX\AppData\Local\gegl-0.4\plug-ins\ and the python file into C:\Users\XXXXXXXXX\AppData\Roaming\GIMP\3.2\plug-ins\puppet-warp\.



Sorry for the late reply! I've been working on a major GIMP fork to turn this plugin and the mesh warp plugin into native tools that run right on the GIMP 3 canvas.


Actually i just decided today to re-install Gimp-3.2.6 and it now works! :)
I am pretty sure it had something to do with uninstalling the dev version of Gimp-3.3.1. It could have possibly removed my Python files as well.
I had noticed that foggify and py console were not loading as well so i just re-installed and that fixed it!

Thanks for your response though. :bigthup Great plug-ins. I really believe they are a great addition to Gimp. :hi5

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Nov 02, 2026 6:28 am  (#13) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
Uptade v1.2.0 puppet warp:

Fixes — Optimize Extend image for large photos
Added Windows and Linux installers to make setup easier.

If you find any bugs or have features you'd like to see, let us know here or open an issue on my github


Attachments:
puppet-warp-windos-x64.zip [76.52 KiB]
Downloaded 35 times
puppet-warp-linux-x86-64.zip [72.44 KiB]
Downloaded 25 times
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Nov 02, 2026 8:15 am  (#14) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
Windows bat installer works well.
When i load triangular cells i get diagonal lines? Is that supposed to be the pin grid?
And if not maybe save that preset as diagonal and add triangular grid.

Works really great though. :bigthup Thanks for the update.

_________________
Image


Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Nov 16, 2026 1:00 am  (#15) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
Update v1.3.0:
Fixes — Optimize Extend image for large photos.
1:1 C Viewport Compositor: Renders background, active warp, and foreground directly at screen viewport resolution using OpenMP + AVX2, bypassing heavy CPU scaling.
Mipmap Pyramid: Automatically generates 1/2, 1/4, 1/8 downscaled textures for huge layers, eliminating zoom-out lag and pixel shimmering.
Preview Opacity: Real-time 0–100% opacity slider to align artwork against underlying layers without affecting final export.
Layers Below & Layers Above: Independently toggle and composite context layers: Off (none), Nearest (single visible layer immediately adjacent), Composite (stack of all visible layers).
Mathematical Checkerboard: Generated in zero-allocation RAM space.
Mesh Overlay: Display as Cells, Triangles, Both, or Off with custom line color, backed by cached Cairo paths.
Snapping (Snap): Snaps pin movements to Guides, Alignment Grid, and smart axis alignments with other pins.
Guides: Automatically loads GIMP image guides (Cyan); allows creating, dragging, and deleting custom local guides (Magenta).
Alignment Grid: Configurable pixel-grid overlay (Step px) independent of the ARAP deformation mesh.
Snapshots (A, B, C): Quick one-click state slots to save, restore, overwrite, or clear setup variations.
A⇄B⇄C Compare & Cycle (→ / `): Non-destructively toggle or step sequentially through all saved variations (Live → A → B → C → Live) without losing unsaved work.
Export A-C to New Layers: Optionally export all saved snapshots (A, B, C) as separate, non-destructive layers above the active layer when applying (OK), each with its own editable Puppet Warp filter and Extend Image bounds.
Orig Before/After (): Instant visual comparison against the unwarped original layer.
If you find any bugs or have features you'd like to see, let us know here or open an issue on my github: https://github.com/hexsian/puppet-warp-gimp


Attachments:
puppet-warp-linux.zip [117.45 KiB]
Downloaded 5 times
puppet-warp-windows.zip [120.88 KiB]
Downloaded 6 times
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Nov 16, 2026 11:44 am  (#16) 
Offline
GimpChat Member
User avatar

Joined: Sep 26, 2026
Posts: 8
Small Update v1.3.1 here: https://github.com/hexsian/puppet-warp-gimp
5 Deformation Modes (Mode selector):

Normal — Balanced: Standard ARAP deformation balancing rigidity and flexibility (default)
Rigid — Preserve: Pure rigid local rotations with reinforced diagonal shear resistance and weighted multi-pass rotation smoothing across neighboring cells to keep straight structures intact
Distort — Flexible: Allows strong local scaling with relaxed diagonal shear stiffness for elastic stretching, squashing, and free-form distortion
Organic: Combines weighted rotation smoothing with nonlinear scale saturation for natural, curved, tissue/cloth-like bends without mesh tearing
Hybrid ARAP: Adaptive solver that blends rigid ARAP on low-stress regions with similarity (ASAP) on high-stretch regions, preventing triangle pinching and collapse under extreme pulls


Attachments:
puppet-warp-windows.zip [118.53 KiB]
Downloaded 4 times
puppet-warp-linux.zip [122.53 KiB]
Downloaded 3 times
Top
 Post subject: Re: Puppet warp for Gimp 3.2
PostPosted: Mon Nov 16, 2026 2:37 pm  (#17) 
Offline
Global Moderator
User avatar

Joined: May 16, 2010
Posts: 16272
New updates working great in Gimp-3.2.8 Windows 64. :bigthup

Great plugin. Thank you for the updated release.

_________________
Image


Top
Post new topic Reply to topic  [ 17 posts ] 

All times are UTC - 5 hours [ DST ]



* Login  



Powered by phpBB3 © phpBB Group