OCULA for NUKE Release Notes

If you can't find what you're looking for, email support@thefoundry.co.uk.

• Download Ocula 2.1v1 Release Notes
• Ocula 2.0v2
• Ocula 2.0v1
• Ocula 1.0v2
• Ocula 1.0v1

Ocula 2.0v2

This is a maintenance release of Ocula.

Release Date

30 April 2010

Requirements

1. Nuke 5.2v2 (or higher) on Windows XP SP2, XP64; Mac OS X 10.5 "Leopard" and 10.6 "Snow Leopard"; Linux CentOS 4.5 (32-bit and 64-bit).
2. Foundry FLEXlm Tools (FFT) (5.0v1 or later) for floating license support.

New Features

There are no new features in this release.

Improvements

There are no improvements to existing features in this release.

Fixed Bugs

1. BUG ID 8222 - Ocula didn't obey requests to force the use of interactive licenses in render mode, that is, when Nuke is run with "-xi".
2. BUG ID 9122 - Disparity channel was corrupt showing vertical striping.
3. BUG ID 9165 - Disparity maps could look different on Windows XP compared to other platforms.
4. BUG ID 9170 - Disparity channel was corrupt on the first frame.
5. BUG ID 9960 - Ocula licenses (ocula_nuke_i) were not returned until the Nuke session was closed.
6. BUG ID 10230 - O_Solver was very unstable.
7. BUG ID 10565 - There was an intermittently inconsistent result from O_Solver, related to viewer framing.

Known Bugs and Workarounds

1. BUG ID 2349 - Add a standard plug-in path for Nuke plug-ins. Later releases of Nuke will pick up the Ocula plug-ins automatically. In the meantime, you will need to set your NUKE_PATH environment variable to (replace x.x with the version of Nuke you're using, for example 5.2 or 6.0):
   • On Windows: C:\Program Files\Common Files\Nuke\5.x\plugins\Ocula\2.0
   • On Mac OS X: /Library/Application Support/Nuke/5.x/plugins/Ocula/2.0
   • On Linux: /usr/local/Nuke/5.x/plugins/Ocula/2.0
2. BUG ID 9188 - O_ColourMatcher: In block-based matching mode, colour fringing can occur where there are high-contrast regions in the input images.

Ocula 2.0v1

This is a major new release of Ocula with many new features, improvements and bug fixes.

Release Date

8 October 2009

Requirements

1. Nuke 5.1v3 (or higher) on Windows XP SP2, XP64; Mac OS X 10.5 "Leopard" (32-bit and x86 only); Linux CentOS 4.5 (32-bit and 64-bit).
2. Foundry FLEXlm Tools (FFT) (5.0v1 or later) for floating license support.

New Features

There are three new plug-ins in Ocula 2:

1. O_Solver - Some of the functionality from O_DisparityGenerator has been seperated out into this plug-in, to allow a more flexible workflow. O_Solver determines the geometrical relationship between a stereo pair of views by detecting feature matches. If you have more than one sequence that were filmed with the same camera rig, it is only necessary to do this calculation on one of them; the same O_Solver can then be reused for the other sequences. It also offers the following advantages over the old DisparityGenerator:
   • An Ignore input so you can tell it which regions to ignore when detecting features.
   • The ability to calculate the camera relationship over a temporal window, for greater robustness.
   • The ability to calculate the camera relationship at intervals and interpolate smoothly between them for better temporal stability.
   • A Camera input, allowing you to use pre-tracked cameras.
   • Interactive editing of feature matches in the viewport.
   • The features and camera relationship are stored as metadata, so they can be saved and reused further downstream.
2. O_DepthToDisparity - a new plug-in to generate a disparity field from a stereo pair of depth maps plus a camera set-up. This is intended for use with CG scenes.
3. O_DisparityToDepth - a new plug-in to generate depth maps from a disparity field, given the stereo camera set-up.

Improvements

1. O_DisparityGenerator
   • New, improved disparity generation algorithm.
   • A Solver input to allow the camera solve from another sequence shot with the same rig to be reused.
   • A foreground (Fg) input to delineate foreground regions from background. This helps to ensure that disparities are constrained to remain within each delineated region.
2. O_InteraxialShifter
   • A foreground (Fg) input to delineate foreground regions from background. This helps to ensure that disparities are constrained to remain within each delineated region.
3. O_NewView
   • A foreground (Fg) input to delineate foreground regions from background. This helps to ensure that disparities are constrained to remain within each delineated region.
4. O_VerticalAligner
   • A Solver input to allow feature matches to be reused.
   • Support for transform concatenation for multiple O_VerticalAligner nodes (except when Alignment Method is set to Vertical Skew).
   • Four new alignment methods: Scale, Simple Shift, Scale Rotate, and Camera Rotation.
5. O_ColourMatcher (formerly O_ColourMatch)
   • A Mask input to allow you to specify a region of interest for the colour transform.
   • A new, block-based matching mode for dealing with local colour differences.
   • Note that O_InterocularShifter has been renamed to O_InteraxialShifter to remove ambiguity.
6. Ocula 2.0 has been redesigned to allow a more flexible workflow.
7. The disparity generation algorithm has been rewritten for greater accuracy and speed.

Bug Fixes in Ocula

1. BUG ID 7387 - O_ColourMatch: super black material (negative) was wrapped / clipped back from 1.0. This has been fixed.

Known Bugs and Workarounds

1. BUG ID 2349 - In Nuke 5.1 and Nuke 5.2 the Ocula plug-ins are not detected automatically. This will be fixed in Nuke 6. In the meantime, you will need to set your NUKE_PATH environment variable to 5.1 or 5.2 according to the version of Nuke you're using.
   • On Windows: C:\Program Files\Common Files\Nuke\5.x\plugins\Ocula\2.0
   • On Mac OS X: /Library/Application Support/Nuke/5.x/plugins/Ocula/2.0
   • On Linux: /usr/local/Nuke/5.x/plugins/Ocula/2.0
2. BUG ID 8222 (Ocula) and BUG ID 8229 (Nuke) - Ocula doesn't obey requests to force the use of interactive licenses in render mode, i.e., when Nuke is run with "-xi". Instead, it will always request a render license in this mode. This is because Ocula 2.0 uses the Nuke NDK and there is currently no way for NDK plug-ins to tell the difference between this and the normal render mode. When a mechanism is provided in a later Nuke release, we will update the Ocula licensing to fix the problem.

---

Ocula 1.0v2

This is a maintenance release of Ocula.

Release Date

9 January 2009

Requirements

1. Nuke 5.1 on Mac OS X or linux.
2. Foundry FLEXlm Tools (FFT) (5.0v1 or later) for floating license support.

New Features

There are no new features in this release.

Improvements

There are no improvements to existing features.

Bug Fixes in Ocula

Fixed instability in plug-ins caused by OS incompatibility with FLEXlm 10.8 licensing module. Upgraded FLEXlm to 10.8.6 for improved Mac OS X 10.5 (leopard) compatibility, and to 10.8.7 for improved 64-bit Linux compatibility.

Known Bugs and Workarounds

1. BUG ID 5482 - Progress bar does not indicate what is being processed further up a tree when "Correlate using disparity" or "Correlate with Ocula" options are used. This will be fixed in a subsequent Nuke release.
2. BUG ID 5904 - There is no progress bar when "Correlate with Ocula" option is used. This will be fixed in a subsequent Nuke release.
3. BUG ID 5979 - Running out of memory with complicated stereo scripts on 32-bit Windows. This will be fixed in a subsequent Nuke release.
4. BUG ID 6075- Slow processing when "Correlate with Ocula" option is used if source image is an EXR. This will be fixed in a subsequent Nuke release.
5. BUG ID 6428 - ReConverge node: "Use Ocula if available" option causes a crash when reloading a script. This will be fixed in Nuke 5.1v3.

---

Ocula 1.0v1

This is the first release of Ocula for Nuke.

Release Date

31 October 2008

Requirements

1. Nuke 5.1v2
2. Foundry FLEXlm Tools (FFT) (5.0v1 or later) for floating license support.

New Features

In this release, there are five plug-ins and a collection of tools (O_Correlate) that add extra functionality to existing Nuke features.

1. O_ColourMatch
2. O_DisparityGenerator
3. O_InterocularShifter
4. O_NewView
5. O_VerticalAligner

Improvements

This section will describe improvements to existing features in later versions.

Bug Fixes in Ocula

This section will describe fixed bugs in later versions.

Known Bugs and Workarounds in Nuke 5.1v2

1. BUG ID 5482 - Progress bar does not indicate what is being processed further up a tree when "Correlate using disparity" or "Correlate with Ocula" options are used. This will be fixed in a subsequent Nuke release.
2. BUG ID 5904 - There is no progress bar when "Correlate with Ocula" option is used. This will be fixed in a subsequent Nuke release.
3. BUG ID 5979 - Running out of memory with complicated stereo scripts on 32-bit Windows. This will be fixed in a subsequent Nuke release.
4. BUG ID 6075- Slow processing when "Correlate with Ocula" option is used if source image is an EXR. This will be fixed in a subsequent Nuke release.
5. BUG ID 6428 - ReConverge node: "Use Ocula if available" option causes a crash when reloading a script. This will be fixed in Nuke 5.1v3.