Warping a CutBrush

[Svengali]

A little while ago I requested a Warping tool for the current CutBrush be added to TVPaint's next update.

A reply from ZigOtto suggested to me a way to script exactly the kind of warping tool I had requested. Through several cycles of design and refinement, I finally created exactly the warping-cutbrush tool I wanted, with the following features:

warp cutbrush - during warp.jpg (14.54 KiB) Viewed 3073 times

Some notes on using it.

1. Shortcut Key Assignment Recommended: The script is assigned to a button (called the warp brush button) which ideally, is then assigned to a shortcut key.
2. Always Press Button (or shortcut key) Twice: The warping process requires that you press the shortcut key twice. First, to drop the current cutbrush in preparation for the warp, and Second to pickup the cutbrush after the warping has been completed.
3. Drop at Center: If the Warp Brush button isn't assigned to a shortcut key, pressing the button OUTSIDE the frame causes the cutbrush to be dropped in the center of the frame, ready for warping. Pressing the Warp Brush button a second time picks up the newly deformed cutbrush.
4. Secret menu (Fig 2): When in warp/edit mode you can right click to bring up a menu of options: Reset positions will home the red control box and points back to the original green bounding box. The other orientation controls do what they say.
5. New Default Orientation: And a tip: simply clicking the warp brush button(or shortcut key) TWICE for a cutbrush that's being scaled or rotated, will make the rotated or scaled orientation become the new, default cutbrush's home position.
6. If it Breaks: If for some reason you end up with a "hot pink" layer that is labeled DeleteMe you may do exactly that: DELETE IT. Normally, this temporary layer (that is created just while warping the cutbrush) is automatically erased after the second time you press the Warp Brush button. But mistakes happen.

warp cutbrush - rightclick popup.jpg (21.11 KiB) Viewed 3073 times

I'm still hoping for an integrated Warp CutBrush tool in the next update!

NOTE: While this version of the Warping Tool works with TVPaint 9, a new version is available that works with TVPaint 10. See zip file further down this thread... Sven

[Elodie]

Thanks for sharing this.

[ZigOtto]

Cool !
... and the "secret" menu to Reset the corners position is a handy addition.
thanks Sven, as usual, your contributions are always valuable, properly scripted, and very well documented.

[Svengali]

Thank you for the kind words Zig and for testing the earlier versions of the script. Just to be clear, the "secret menu" isn't part of my script, it's part of the layer warping tool. I just happened to find it when I right clicked while working on the Warp CutBrush script. I could find no reference to it in the documentation and that's why I called it a "secret menu".


Sven

[ZigOtto]

ah, I've never right-clicked before when using this tool, so it's a discovery to me too !
this program is somehow "magical" : you think you know it perfectly in its deeper corners,
and you're always discovering some new "undocumented" things/commands, "secretly" hidden here and there ...

[Svengali]

New WarpCutBrush script, edited to work in TVP 10. (New change in the tv_Preserve command was the problem, I think).

Replace the previous button with that found in the TVPX zipped below. Script is now embedded as suggested.

Feedback any problems, thanks.

Sven

[idragosani]

Thanks, Sven, it works great now.

[D.T. Nethery]

New WarpCutBrush script, edited to work in TVP 10. (New change in the tv_Preserve command was the problem, I think).

Thank you ! The new one works fine in TVPaint 10 for Mac.

[NathanOtano]

Awesome, thanks!

EDIT : I had a bug, for me it automatically stamped the brush without the modifications at the end. I think it was going to far in my undo history so i removed TV_Undo line 55 and it worked fine since then.