saptools v1.5


 
This location is for Registered Users Only.
Perhaps you need to login or register.
Contributor: Hannes Sap
A bunch of nodes I created during my journey through the industry
Requirements:
10.0, 9.0 or later
Linux, Mac, Windows
14 Oct 2016
591

- Sap Tools -

Saptools tutorial

v1.4 update

s_LockViewer:
I fixed the issue where it would lock all the inputs when reopening the file

s_PointsToCornerPin:
Several bugfixes, sometimes the progressbar wouldn't work properly or it wouldn't take the given framerange.
I also fixed the issue with exporting trackers in the Advanced tab.
Added features: such as relative cornerpins + matchmove and stabilise functions.

s_TrackReformat:
Added a new input that you can use so it takes your input as format instead of choosing from the list. There's a center knob as well to control the scaling better.
Bugfixes contain issues with non-animated data and more.

 

v1.3 update

Put everything as a group so everyone has free acces and exchange with others is easier.

 

v1.2 update

s_LockViewer:
Locked nodes are now stored when closing the script and automatically locked when opening the script. So you don't have to relock everything again and again.

s_PointsToCornerPin:
Added a framerange prompt when using the 'Generate' button.

s_TrackReformat:
Animated transform nodes can be reformated as well now.
Improved the copy'ing of the node so all the knob values are copied over. Not just the animated and reformated ones.

 

v1.1 update

s_PointsToCornerPin:
Fixed the error saying 'knob format not found'.

s_TrackReformat:
Added more resize scaling options to match the reformat node.
Moved the resize knob to the output format.
Takes in account difference in pixelaspect ratios.

Added the s_MaskedBlur node.

 

 

Install

Installing is very easy. Just unzip the zip file and put the folder in your .nuke/ folder. ( Typically that would be C:/Users/[your name]/.nuke/. )
If you already have a init.py and menu.py file, add this to the following file:

init.py :

import nuke

nuke.pluginAddPath('saptools')

menu.py :

import saptools

(re)launch Nuke and you should have everything proprely installed! (Have a look at your toolbar on the left, you should see a little juicebox and also a menu item called Sap Tools at the top of your screen).

 

s_LockViewer LockViewer Node 1

This is not actually a node, it's more kind of a feature. It gives you the possiblity of locking your viewer input to a certain node. Very handy if you have any reference or previously rendered versions you want to lock your viewer to.

How to use it:
- Select your node, press alt + the number you want to lock it to and voila! Your input is locked.
- Whenever you press that number, be it accidentally or on purpose, it will show you the node's output you locked it to.
- To unlock it simply press ctrl + alt + number.

*The viewers node changes colour and adds a description to show you which input is locked, to avoid confusion
** Any locked input is reset when you reopen the scene.

 

s_PointsToCornerPinPointsToCornerPin Node 1

Tracks any geometry ( solid or animated ) and converts the vertices trough a camera to a CornerPin or Trackers. Very handy to stabilise or match move your plate based on a tracked camera and geometry for rotoscoping or paint & prep work.

How to use it: - Connect your geometry and camera to the inputs of the node.
 - Switch to 3D in the viewer and go into vertices selecting mode.
- Select your 4 vertices and press 'Get' ( or 'Get Animated' when the geometry is animated).
- Press generate and the node will transform the vertices to 2D screenspace.
- Export your CornerPin (the PointsToCornerPin node will automatically rearrange the coordinates so the CornerPin goes from 1 to 4 counter clockwise to avoid twisting ).
- In the advanced tab you can specify 1 or 2 points to make 1 or 2 point Tracker

*In the input tab you can manually reset or redo one of the 4 points separately if necessary.
**The reference frame helps to rearrange the 2D coordinates to the CornerPin. If 0, it takes the first frame of your project's framerange.

 

s_TrackReformatTrackReformat Node 1

Reformats a 2D track from one format to another. If, for some reason, your plate got resized and all your Trackers and/or CornerPins are off, you can use this node to reformat them to the new format.

How to use it: - Plug in your Tracker or CornerPin.
- The node automatically links the input format to the project settings, uncheck the 'Use root format' knob to change it manually.
- Resize type is the same as the one you have in Nuke's Reformat node.
- Click the 'Reformat' button and you should have a complete new node name [old node's name]_reformat which has all his 2D tracks nicely transformed.

*Currently only works for Nuke7+ tracker nodes and cornerpins, suggestions are always welcome.

 

s_MaskedBlurMaskedblur node 1

Blurs your source based on the mask input. For example, when your masterblur has a radius of 20, the source will be blurred with a radius of 20 where the mask is fully opaque and with a radius of 10 when the mask is 50% transparent.

How to use it: - Plug in your source and mask input
- Increase the iterations. The more precise your result will be, although it will slow down the node.
- If you want to save time and use less iterations, you can use the post blur to blend the iterations together.
- Use the angle knob if you want a rotate the blur (If it's direction for example).
- Change the channel mask knob if you want to use a different channel of your mask.

 

If you have any questions or suggestions: feel free to contact me and I'll have a look at it! I'm planning to upload all of my python source-code as well, so you can all have a look at it. I just have to clean the code up first.

Currently planned:* Track retime ,retime your 2D tracks.
* Lots of Deep plugins, as I consider Deep is the future, I just have to chew trough Nuke's API to make sure they all work properly.

 

Special thanks to Sam Horgan, Steve Feltham, Matt Cameron, James HattSmith and David Zaretti

Please login in order to download these files.

Comments   

 
+5 # Naz Parker 2016-01-22 10:50
Great tools. Very helpful.
 
 
0 # Matt Cameron 2016-02-27 10:17
Awesome toolset. Thanks Hannes!
 
 
0 # Alexey Kuchinski 2016-03-02 10:01
Hi Hannes, thank you for the toolset

Is there a way to force Viewer to remember locked Viewer between sessions?
 
 
0 # Hannes Sap 2016-03-03 11:52
Hi Alexey,

There should be a way, I'll see what I can do, but it should be possible, I will try to include it in the next update!

Cheers
 
 
+1 # Hannes Sap 2016-03-31 21:51
Hi Alexey, the new version 1.2 has this feature now!

Cheers
 
 
0 # Alexey Kuchinski 2016-04-01 09:19
Thanks Hannes!
 
 
0 # Marvin Sprengel 2018-02-20 03:15
These tools are so nice! thanks so much for sharing them!
but i actually have a question, cause i coudn't do it myself:
could you lead me to where i can switch the shortcuts of the viewer lock in your script? because i lock the viewer very often by accident
 
 
0 # Hannes Sap 2018-02-20 10:03
Hey Marvin,

Glad you like it!
You can find the shortcuts for the lockviewer in 'saptools.py'
At the very end.

Have a look at this page:
https://learn.foundry.com/nuke/developers/63/pythondevguide/custom_ui.html
and go to the 'Assigning a hotkey' paragraph.

Hope this helps :)

Cheers
 
 
0 # Marvin Sprengel 2018-02-20 16:13
wow, thanks for the fast answer! I check it right away!
ps: using your points-to-corne rpin' gizmo right now and i just found out for myself that you can use it with a position-to-poi nts node(not animated). makes sense obviously, but it was eye opening for me^^
 
 
0 # Marvin Sprengel 2018-02-20 18:59
ahh now i get it!
didn't know "#" would stand for the 'alt'-key
 

You have no rights to post comments

We have 3230 guests and 91 members online