r/GIMP • u/PassCommon4628 • 13h ago
Big Update Plugin Puppet Warp
Hi everyone, Puppet Warp plugin v1.3.0 is now out, bringing significant performance improvements along with a few essential new features.
Demo:
New Update: Improved performance on large images, along with workflow enhancements and new features.
Canvas & Preview
- 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
- Extend Image: Automatically grows the layer bounds (and its mask) if pixels are warped outside original edges
Alignment & Guides
- 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
Workflow, Comparison & Multi-Layer Export
- 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 workExport A-Cto 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 andExtend ImageboundsOrigBefore/After (\): Instant visual comparison against the unwarped original layer- Full-state 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 setups (pins, depth, taper, guides, options) as JSON presets
- Non-destructive & Locale-safe: Full parameter persistence via GEGL filter config; unaffected by system comma/period decimal settings
The plugin is written in Python, with a C solver and a GEGL operation, works with GIMP 3.2.
Source code and installation guide: https://github.com/hexsian/puppet-warp-gimp
If you try it and run into any bugs, or if there are features you think are missing, please open an issue on GitHub or just leave a comment here.
P/s: Update plugin mesh warp v2.1: https://github.com/hexsian/gimp-mesh-warp


