saptools v1.5
This location is for Registered Users Only.
Perhaps you need to login or register.
10.0, 9.0 or later
Linux, Mac, Windows
- Sap Tools -
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
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_PointsToCornerPin
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_TrackReformat
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_MaskedBlur
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
Comments
Is there a way to force Viewer to remember locked Viewer between sessions?
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
Cheers
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
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
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^^
didn't know "#" would stand for the 'alt'-key
RSS feed for comments to this post