SmartVector
The SmartVector node writes motion vectors to the .exr format, which are then used to drive the VectorDistort node as part of the Smart Vector toolset.
Warning: Due to VFX Platform library changes, vectors generated by the Nuke 11 SmartVector toolset do not match legacy versions. For example, vectors generated by Nuke 11.0v1 do not match those generated by Nuke 10.5v4.
See also VectorDistort.
Inputs and Controls
Connection Type |
Connection Name |
Function |
Input |
Src |
The sequence from which to generate motion vectors. |
Control (UI) |
Knob (Scripting) |
Default Value |
Function |
SmartVector Tab |
|||
Render Motion |
|||
range |
render_range |
input |
Sets the range of frames processed by SmartVector: • input - the default value, sets the frame range to the length of the sequence attached to the Src input. • global - sets the tracking frame range to the range set in the Project Settings > frame range controls. If no frame range is defined, the frame range of the first image you read in is used as the global frame range. • custom - sets a range of frames described by the from and to fields. |
from |
file.first_frame |
1 |
When range is set to custom, this control sets the first frame to process in the sequence. |
to |
file.last_frame |
100 |
When range is set to custom, this control sets the last frame to process in the sequence. |
vector detail |
vectorDetailReg |
0.3 |
Sets the vector quality. The default value of 0.3 is sufficient for sequences with low detail and movement, but you may want to increase the detail to improve the vector quality in some cases. Note: High detail vectors take longer to render, but can improve the results you get from the VectorDistort node. |
file |
file |
N/A |
Sets the file path to write vectors out to disk for use with VectorDistort. Note: SmartVector can only write .exr files to disk. If you specify another file format, an error displays in the Viewer. |
Render |
render |
N/A |
Click to render the frame range specified to the file path entered in the file control. |
Output to Write |
liveView |
disabled |
When enabled, SmartVector writes the vectors to file using a new Write node with suitable .exr settings to contain the vector data. This allows you to take advantage of Nuke's Frame Server to render the vectors in the background while you continue working. |
Export Write |
export_write |
N/A |
When Output to Write is enabled, click to automatically create a Write node with suitable .exr settings to contain the vector data. |
Python Tab (These controls are for Python callbacks and can be used to have Python functions automatically called when various events happen in Nuke.) |
|||
before render |
beforeRender |
none |
These functions run prior to starting rendering in execute(). If they throw an exception, the render aborts. |
before each frame |
beforeFrameRender |
none |
These functions run prior to starting rendering of each individual frame. If they throw an exception, the render aborts. |
after each frame |
afterFrameRender |
none |
These functions run after each frame is finished rendering. They are not called if the render aborts. If they throw an exception, the render aborts. |
after render |
afterRender |
none |
These functions run after rendering of all frames is finished. If they throw an error, the render aborts. |
render progress |
renderProgress |
none |
These functions run during rendering to determine progress or failure. |
Step-by-Step Guides