Professional Documents
Culture Documents
0
Release Notes
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Build notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
New in Mocha Pro 2024 v11.0.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Camera Solve with Mocha and SynthEyes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Track and Roto Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Performance Improvements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Architecture Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Fixed issues since v10.0.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Recommended Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Minimal Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Software Requirements for Mocha Pro Standalone . . . . . . . . . . . . . . . . . . . . . . . . 122
Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Software Requirements for Mocha Pro Plug-Ins. . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Host Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Compatible Third-Party Software for exporting data. . . . . . . . . . . . . . . . . . . . . . . 123
Compatible Third-Party Software for exporting data with 360 VR Footage . . . . 127
Installation of Mocha Pro Standalone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
macOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Linux Centos 7-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Linux dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Installation of Mocha Pro Plug-In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
1
macOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Linux dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Introduction
These release notes accompany Mocha Pro 2024 v11.0.0.
This is a maintenance release with several defect fixes. Release notes cover
Mocha Pro, for both standalone and Plug-In versions of the product.
Documentation is available inside Mocha Pro 2024 v11.0.0 by pressing the F1 key.
Build notes
Please read the following notes carefully as they may affect efficient use of the
product.
OFX builds of the Mocha Pro Plug-In have been tested to work with
Autodesk Flame 2020+, The Foundry Nuke, Blackmagic Fusion
Studio, HitFilm Pro, Vegas Pro and Silhouette v6+.
Other hosts that utilize OFX may operate the Mocha Pro OFX Plug-
In correctly, but at this stage they are unofficially supported and
may experience problems.
While Mocha will work in Blackmagic Resolve 16+, rendering can be
slow.
2
New in Mocha Pro 2024 v11.0.0
Camera Solve with Mocha and SynthEyes
The 3D Camera Solve Module in Mocha has been completely overhauled to take
advantage of the SynthEyes core solver and now allows you to view and
manipulate the results.
• Use Mocha Tracking for 3D Solves: Optionally use Mocha Planar tracking and
PowerMesh to assist difficult solves
• Roto out problems: Use Mocha masking to eliminate problem areas that throw
off your Camera solves
• Camera and scene controls: Modify the solved results to fit your project
• USD Import: Import 3D models to visualise draft results overlaid on your scene
• More flexible 3D Export: Export USD and FBX to supported systems. Export
nulls to After Effects.
• Hold keyframes: Set linear or constant keyframes for more control over
stepped motion
3
from previous frames
Performance Improvements
• Insert Optimisation: Insert Module is now optimised to render up to 15x faster
• Switch Resolution from Plug-In dialog: Full resolution switching options when
opening Mocha in After Effects
Architecture Updates
• OpenEXR 3.1.11
• Alembic 1.8.6
• OCIO 2.2.1.1
4
Fixed issues since v10.0.5
Issue: MO-12544 Visible Splines from Lens calibration breaks spline
position on Windows
Platform: Windows
Product: All Products
Bug Description: Lens Calibration with splines could appear to break spline
positions on Windows.
5
Bug Description: When the Mocha project file is stored in a LucidLink
filespace, the saving was very slow.
Issue: MO-12296 Crash when rendering Insert with a Grid Warp and
then viewing the Insert Clip
Platform: All Platforms
Product: All Products
6
Bug Description: After rendering an Insert with a Grid Warp, Mocha could
crash if you viewed the Insert Clip
Issue: MO-12258 Long clip names are stretching the viewer control
toolbar clip dropdown
Platform: All Platforms
Product: All Products
Bug Description: Long clip names would stretch out the clip drop down,
pushing the view controls to the right.
7
Known Issues
Issue: MO-12551 PowerMesh can break when tracking first frame in
some projects
Platform: All Platforms
Product: All Products
Bug Description: When tracking some PowerMesh layers, the Mesh can
suddenly turn erratic after the first frame.
Workaround: Delete the layer, save and reload the project.
Issue: MO-12550 FBX and USD exports always start at zero when
exported via the After Effects plugin
Platform: Windows and macOS
Product: Adobe After Effects Plug-In
Bug Description: Due to frame offsets in After Effects, exporting USD and FBX
data will always have the keyframes starting at zero.
Workaround: Set the Comp frame offset in After Effects to zero, or shift
the keyframes of the exported USD/FBX in the target
application.
8
Bug Description: Reversing the time of a layer in Adobe After Effects will
cause an unknown error in Mocha.
Workaround: Precomp the reversed layer first before applying Mocha.
Issue: MO-12472 USD file info does not display under File Assets if
Camera Solve is done after its import
Platform: All Platforms
Product: All Products
Bug Description: USD files will not be visible in the viewer if you have not yet
done a solve.
Workaround: Import USD files after camera solving.
Issue: MO-12412 Can’t interact with Mocha UI when both trial and
data usage UI are visible on Mac
Platform: All Platforms
Product: All Products
Bug Description: Sometimes two dialogs can pop up and conflict with each
other on the very first use of the software.
Workaround: Force quit and restart Mocha.
9
Bug Description: The twirl up/down widgets for folders in the 3D objects panel
can become invisible after used.
Workaround: Restart Mocha.
Issue: MO-12309 Stabilize render clips are not resized when input
clip size changes
Platform: All Platforms
Product: All Products
10
Bug Description: If a stabilize render clip is created and saved within a project,
the clip size is maintained even if the input clip size changes,
causing either cropped renders or oversized padding.
Workaround: Delete the old rendered clip in the Clip module before
rendering a Stabilize.
Issue: MO-12277 Mocha Fusion Shape exports set in/out points for
all layers based on the last selected layer
Platform: All Platforms
Product: All Products
Bug Description: Layes with in/out ranges are exporting based on the last
selected layer range.
Workaround: Don’t set in/out points when exporting.
11
Product: All Products
Bug Description: Setting a layout that has panels on another screen will
sometimes load with the floating panel stuck to the right side
of the main screen.
Workaround: None.
Issue: MO-12190 Reorient Horizon Line will zag all over the screen
when viewing the Reorient render clip
Platform: All Platforms
Product: All Products
Bug Description: Reorient can show the horizon line zig-zagging across the
viewer if viewed while the Reorient render clip is showing,
but views correctly when viewing the source input clip.
Workaround: View horizon line in the source input clip view instead.
12
Product: All Products
Bug Description: Right-click closing a Bezier spline will leave the last point
created still selected, then retains that selection if you select
another point.
Workaround: None.
Issue: MO-12136 GPU slips where CPU doesn’t for some shots
Platform: All Platforms
Product: All Products
Bug Description: In some shots, the GPU tracking will slip where the CPU
doesn’t.
Workaround: Switch to CPU for harder tracking shots.
13
Product: All Products
Bug Description: Trimmed layer ranges will sometimes give a merged track a
change in position to one of the merged layer’s positions.
Workaround: Remove layer ranges from layers before merging.
Issue: MO-12091 Bezier shape export will crash Mocha if all points
are deactivated
Platform: All Platforms
Product: All Products
Bug Description: If all points are deactivated in a Bezier shape, some exports
will crash Mocha.
Workaround: Deactivate the layer instead of all points.
14
Bug Description: The wacom tablet will sometimes have difficulty recognising
custom shortcuts when using Mocha inside Silhouette.
Workaround: None.
Issue: MO-11938 Proxies that are not evenly divisible can cause
tracking problems
Platform: All Platforms
Product: All Products
Bug Description: Proxies that are not evenly divisble may cause the tracker to
slip.
Workaround: None.
15
Bug Description: Attempting to export a nuke shape when the project is 360
and the shape extends outside of the clip can cause Mocha
to crash.
Workaround: None.
16
Bug Description: Selecting a new option in the cleanplate dropdown doesn’t
mark the project as modified.
Workaround: Save manually after changing the cleanplate option.
17
Bug Description: After exporting a camera solve, a blank message box
appears.
Workaround: None. Clicking OK removes the message box.
18
Issue: MO-11728 Logs indicating wrong Windows version
Platform: Windows
Product: All Products
Bug Description: The windows Mocha log shows Windows 11 as version 10.
Workaround: None.
19
Product: All Products
Bug Description: Scaling from the bottom corners of the surface is inverted
compared to the top corners.
Workaround: None.
20
Bug Description: On some systems, you cannot launch Mocha due to an
OpenCL problem.
Workaround: We recommend backing up the registry before moving
forward. In the Windows registry, try changing the
REG_DWORD values from 0 to 1 for each platform listed
below:
HKLM\SOFTWARE\Khronos\OpenCL\Vendors
HKLM\SOFTWARE\Wow6432Node\Khronos\OpenCL\Vendors
21
Bug Description: Avid doesn’t bring Mocha UI to the foreground when
switching back.
Workaround: Find the Mocha process in the dock/taskbar and click on it.
Issue: MO-11519 Insert Point tool will not add a point unless the
cursor is several pixels away from the line in Bezier splines
Platform: All Platforms
Product: All Products
22
Bug Description: Inserting a point will not place the point if the cursor is
directly over the line.
Workaround: None.
Issue: MO-11477 Link to Track does not work for multiple layers in
the Essentials Panel
Platform: All Platforms
Product: All Products
Bug Description: "Link to track" does not link multiple selected items using the
Essentials Panel.
Workaround: Use "Link to Track" for multiple selected layers in Classic
layout only.
Issue: MO-11461 Some Alembic files from Mocha crash Maya when
imported
Platform: All Platforms
Product: All Products
23
Bug Description: Importing an alembic file from Mocha can crash Maya.
Workaround: None.
24
Bug Description: Adjusting points near areas of extreme distortion in 360 can
cause the points to move contrary to mouse movements.
Workaround: Adjust in Equirectangular mode.
25
Bug Description: Mocha can crash Resolveif not set to render with the display
GPU
Workaround: Open Mocha and set the GPU to "Display" in GPU
preferences.
26
Bug Description: If the QuickTime movie field only has a directory instead of a
full file path, Mocha will throw an error.
Workaround: Make sure you have a filename in the movie path, eg.
"C:\Video\mymoviefile.mov"
27
Bug Description: Attempting to load a 12K image into the Mocha OFX Plug-In
via Nuke causes a "bad argument error".
Workaround: None.
28
Product: Mocha Pro Standalone
Bug Description: Animation encoding in Mocha Pro standalone will export
tracking data that does not line up when pasted into After
Effects.
Workaround: Convert to an image sequence, such as TIF.
29
Product: Mocha Pro Standalone
Bug Description: Large dimension ProRes files fail to read in GStreamer.
Workaround: Convert the video so that its width is a multiple of 16 pixels.
30
Bug Description: The solving summary shrinks the Camera Solve button when
using "Auto".
Workaround: None.
31
Workaround: None.
Issue: MO-10827 Insert opacity and gain changes don’t trigger re-
render option
Platform: All Platforms
Product: All Products
Bug Description: Turning on 'Re-render on parameter change' doesn’t re-
render when changing some parameters in Insert.
Workaround: Render manually using the render button.
Issue: MO-10809 Mesh tracker Spline Warp does not work in 360
VR
Platform: All Platforms
Product: All Products
Bug Description: Mesh tracking will not correctly warp the spline in 360.
Workaround: Turn off spline warp.
32
Issue: MO-10797 Layer shape will shift if mesh is turned on after
the layer has been tracked
Platform: All Platforms
Product: All Products
Bug Description: Mesh Spline Warp influences the layer shape, so turning on
Mesh after tracking will shift the shape.
Workaround: None.
Issue: MO-10771 Magnetic Spline detail does not adjust point count
when shape has just been created
Platform: All Platforms
Product: All Products
Bug Description: On first creation, the detail parameter does not show any
change on a Magnetic spline.
Workaround: Deselect and reselect the spline.
33
Product: All Products
Bug Description: Interlaced project list twice the number of frames in the
remove parameters
Workaround: None.
34
Product: All Products
Bug Description: The transform tool hitboxes for rotation are too small when
there is a very high resolution screen.
Workaround: Zoom into the canvas further.
35
Bug Description: When trying to import a clip via the New Project window, the
UI will populate Separate Fields as Off instead of the clip’s
fields.
Workaround: Change interlaced settings manually.
36
Workaround: None. Changes to the Plug-In to support Media Composer
properly breaks older Mocha interlaced projects.
37
Issue: MO-10508 Shape becomes unselectable when undoing a
control point change after moving the playhead
Platform: All Platforms
Product: All Products
Bug Description: Undoing a control point move after moving the playhead can
make the point unselectable
Workaround: Deselect the layer then reselect.
38
Issue: MO-10454 Mocha viewport can glitch to show flipped
inverted video and interface elements
Platform: All Platforms
Product: All Products
Bug Description: Mocha can occasionally flip or glitch UI graphics on certain
hardware configurations.
Workaround: Resize the GUI and the window should reset.
39
Issue: MO-10423 Changing Motion parameters only keyframes
Search Parameters
Platform: All Platforms
Product: All Products
Bug Description: If you change the Motion parameters in the Track module,
the Search parameters are keyframed.
Workaround: None.
Issue: MO-10409 R3D Video shifts right and down by a pixel when
scrubbing through proxy scale in Mocha
Platform: All Platforms
Product: Mocha Pro Standalone
Bug Description: Proxy scale can shift R3D footage slightly
Workaround: Work in Full resolution.
40
Issue: MO-10359 Mocha can be "Unable to track" when input frame
doesn’t exist on some systems
Platform: All Platforms
Product: All Plug-Ins
Bug Description: Mocha can throw an error on some systems that it is unable
to track due to not having an input frame.
Workaround: None. Currently suspected to be related to memory
exhaustion.
Issue: MO-10347 Long delay when opening Mocha for first time in a
host session
Platform: All Platforms
Product: Mocha Plug-Ins
Bug Description: There can be a significant delay when opening Mocha Pro for
the first time in a session
Workaround: None. Subsequent openings are normal speed.
Issue: MO-10278 Adobe products can’t read DPX matte files written
from Mocha
Platform: All Platforms
Product: All Products
Bug Description: DPX files written from "Export Rendered Mattes" are in Grey
format, which Adobe products do not support.
Workaround: Export mattes as TIF files or equivalent RGB output.
41
Issue: MO-10255 Mocha Pro AVX can hang when opening in Avid
MC 2019.9 on some systems
Platform: macOS and Windows
Product: Mocha Pro AVX Plug-In
Bug Description: Mocha Pro AVX occasionally hangs when opening in Avid MC
2019.9 on some systems.
Workaround: None.
42
Issue: MO-10159 Long delay for find_widget and get_widgets() in
Mocha Python
Platform: All Platforms
Product: Mocha Pro Standalone
Bug Description: The functions find_widget and get_widgets in the Python API
can take several seconds to execute.
Workaround: None.
Issue: MO-10082 Changing the Detail fields does not affect number
of points unless magnetic shape tool is selected
Platform: All Platforms
Product: All Products
Bug Description: Layer Detail of a magnetic or freehand spline will only
change if the tool is selected
Workaround: Select the tool.
43
Issue: MO-10046 Mocha is extremely slow when playing backwards
Platform: All Platforms
Product: All Products
Bug Description: Playing backwards for some footage can be much slower
than playing forwards
Workaround: Play forwards or cache the clip.
44
Bug Description: Only one contour at a time inside a layer will be affected by
the detail field.
Workaround: Select each contour separately while adjusting detail.
Issue: MO-9982 Dope sheet can’t scroll all items when there are
many layers
Platform: All Platforms
Product: All Products
Bug Description: Projects with many layers cannot show all items in the
Dopesheet.
Workaround: None.
Issue: MO-9973 Can’t select all control points at once after creating
a bezier shape
Platform: All Platforms
Product: All Products
Bug Description: When attempting to select all the bezier points at once, one
of the points will be deselected which causes that one point
to not move when attempting to move the entire shape.
Workaround: Reselect all control points.
Issue: MO-9974 Holding down 'S' does not immediately change the
cursor icon to the edge snap icon
Platform: All Platforms
45
Product: All Products
Bug Description: Holding down the 'S' key to activate drag-snapping does not
immediately change the cursor
Workaround: Move the mouse and the cursor should change.
Issue: MO-9958 Nuke takes a very long time when rendering from
a second Mocha node fed from another Mocha node.
Platform: All Platforms
Product: Mocha Pro OFX Plug-In
Bug Description: A rendering Mocha Plug-In fed as a source into another
rendering Mocha Plug-In will be very slow to render in Nuke.
Workaround: None.
Issue: MO-9954 Insert rendering does not work for relinked matte
clips
Platform: All Platforms
Product: All Products
Bug Description: A relinked matte clip doesn’t show in the Insert foreground
mattes.
Workaround: Set the Matte Clip for the layer to "None", then back to the
matte clip. It will ask to reconvert to 8-bit.
Issue: MO-9927 Remove looks for missing clean plate frames even
when set to "None"
Platform: All Platforms
Product: All Products
46
Bug Description: Setting the clean plate clip drop down to "None" when there
is a clean plate clip available still references existing clean
plate.
Workaround: Remove the clean plate clip entirely.
47
Bug Description: Activating a nodelocked Mocha license in Premiere can
cause Premiere to hang.
Workaround: None.
Issue: MO-9817 Can’t pan and zoom while playing back on Mac
Platform: macOS
Product: All Products
Bug Description: The pan/zoom tools sometimes cannot be used when playing
back a shot
Workaround: Stop playback.
Issue: MO-9813 Surface Area situated around 1st point when using
Add X/B-Spline
Platform: All Platforms
Product: All Products
Bug Description: Drawing a new layer with the "Add" spline tools can cause
the surface to sit on the first drawn point
Workaround: Use the "Create" spline tools to create a new layer.
Issue: MO-9806 Layout menu goes missing when changed from Big
Picture to Roto
Platform: All Platforms
Product: All Products
Bug Description: Switching from Big Picture to the Roto Layout causes the
Layout dropdown to become hidden
Workaround: Pull the Layout tool bar size out to the right to reveal the
drop down.
48
Bug Description: Running scripts in the Python Script Editor doesn’t clear the
values when you write a new script in the same session.
Workaround: Restart Mocha or clear the values manually.
49
Issue: MO-9711 Mocha Welcome screen graphics looks jagged on
4k
Platform: All Platforms
Product: All Products
Bug Description: The High resolution version of the Welcome screen can look
jagged in 4K.
Workaround: None.
50
Issue: MO-9629 Magnetic Shape is not rebuilt when undoing a
change to the detail parameter unless the Magnetic Tool is
enabled
Platform: All Platforms
Product: All Products
Bug Description: Unless you have the Magnetic/FReehand tool selected, undo
does not undo a detail change
Workaround: Select tool before undoing.
51
Issue: MO-9562 AdjustTrack Layer points and Surface points have
duplicates in different position when 360 view mode is on
Platform: All Platforms
Product: All Products
Bug Description: AdjustTrack can show multiple overlay controls in 360 mode.
Workaround: None.
Issue: MO-9552 Mocha can crash the host if you run out of disk
space
Platform: All Platforms
Product: All Mocha Pro Plug-Ins
Bug Description: If the system runs out of disk space, the Mocha host will
crash.
Workaround: Check disk space levels for large shots and make sure there
is ample space.
52
Issue: MO-9426 GPU preferences on Mac are not remembered
when you uncheck both 'Use GPU Processing' and 'Allow
unsupported GPUs'
Platform: All Platforms
Product: All Products
Bug Description: GPU preferences on Mac are not remembered when you
uncheck both 'Use GPU Processing' and 'Allow unsupported
GPUs'
Workaround: Turn off just "Use GPU processing". "Allow unsupported
GPUs" will be disabled when you do this.
Issue: MO-9387 Avid crashes with Mocha installed using OSX 10.11
Platform: macOS
Product: Mocha Pro AVX Plug-In
Bug Description: Avid will crash using the mocha Plug-In on OSX 10.11
Workaround: Use macOS 10.12 or higher.
53
Issue: MO-9300 Save button isn’t completely rectangular
Platform: All Platforms
Product: All Products
Bug Description: The Save button is slightly cut off.
Workaround: None. Cosmetic only.
54
Workaround: Adjust the camera view in 360.
55
Bug Description: Rendering a 360 view of Equirectangular footage does not
match the current 360 view in the viewport.
Workaround: Adjust Lens parameters to get the correct view.
56
Workaround: 1. Execute any processing used in the OFX node:
When using a Mocha Pro node, saving and executing any
changes within the Plug-In appears to stop the crashes. So
using the node and editing the CornerPin before executing
the saved changes crashes Nuke.
Issue: MO-8889 Layers that have in-points are animating from the
first frame when exported as shapes in Premiere
Platform: All Platforms
Product: Mocha Pro Adobe Plug-In, Mocha VR Adobe Plug-In
Bug Description: Exporting Premiere shape data that has layer in-points
pastes with the layers moving immediately on the first frame
rather than from the defined frame.
Workaround: Don’t set the layer in point in Mocha
57
Platform: All Platforms
Product: Mocha Pro All, Mocha VR All
Bug Description: Mocha does not respect required Nuke naming conventions
in its exports
Workaround: Replace any invalid characters with letters, digits and
underscores.
58
Product: Mocha Pro OFX Plug-In, Mocha Pro Standalone, Mocha VR
OFX Plug-In, Mocha VR Standalone
Bug Description: Errors can show when installing on Centos 7.
Workaround: Check dependencies and try reinstalling.
59
Product: Mocha Pro OFX Plug-In, Mocha VR OFX Plug-In
Bug Description: In Vegas Pro, you can adjust the frame rate in the middle of
editing, and this can alter the tracking data in the GUI.
Workaround: None.
60
Bug Description: Apply Matte will applu the tracked matte, not a stabilized
matte, when rendering Stabilize to the Mocha Plug-In host.
Workaround: None.
61
Product: All Products
Bug Description: Render controls don’t always disable when a layer has been
deactivated on a frame.
Workaround: None
Issue: MO-8598 GPU tracking with very large search area fail in all
versions of Mocha Pro (and VR with Lens set to anything
non-equirectangular)
Platform: All Platforms
Product: Mocha Pro All, Mocha VR All
Bug Description: If you set a very large search area in the track module
parameters, Mocha may not track when using GPU.
Workaround: Turn off GPU tracking
62
Issue: MO-8581 Tweaking numeric values under Horizon Align will
move the Horizon Orient onscreen widget and vice versa in
Mocha VR
Platform: All Platforms
Product: Mocha VR All
Bug Description: The Horizon Orient onscreen widget moves with the tweaks
to the Horizon Align parameters
Workaround: None. Cosmetic only.
63
Bug Description: Adjusting the transform tools in the Insert module will not
wrap the Insert surface overlay around the seam in VR
module
Workaround: Use 360 mode to control the surface instead
64
Product: Mocha VR All
Bug Description: A Layer’s Spline should move in accordance to the adjusting
of a reference point, but does not when crossing over a
seam.
Workaround: None
65
Issue: MO-8530 "# Frames" parameter does not disable when
"Smoothing" is disabled in the Reorient Module of Mocha VR
Platform: All Platforms
Product: Mocha VR All
Bug Description: If you turn off the "Smoothing" checkbox in Reorient the sub
parameters do not disable.
Workaround: None
Issue: MO-8529 Horizon Orient’s Tilt, Pan, Roll do not disable when
unchecking Horizon Orient in the Reorient Module in Mocha
VR
Platform: All Platforms
Product: Mocha VR All
Bug Description: If you turn off the "Horizon Orient" checkbox in Reorient the
sub parameters do not disable.
Workaround: None.
66
Issue: MO-8499 Mocha VR AE - if comp resolution is set to third,
Mocha won’t switch into equirectangular mode
Platform: All Platforms
Product: Mocha VR Adobe Plug-In
Bug Description: Since the "Third" proxy resolution often results in dimensions
that are not 2:1, it will not view correctly in the Mocha VR GUI
Workaround: Use Half or Quarter proxy instead.
67
Platform: Windows
Product: Mocha Pro AVX Plug-In, Mocha VR AVX Plug-In
Bug Description: If you are attempting to do a background render with the
Mocha Pro Plug-In on MC 8.6.3 or earlier, the render fails.
Workaround: Render in 8.6.4 or do a standard render.
68
Workaround: None. Quantel Rio is not presently supported.
Issue: MO-8305 Frame range changes for *.mov files are not visible
in Mocha OFX Plug-In
Platform: All Platforms
Product: Mocha Pro OFX Plug-In, Mocha VR OFX Plug-In
Bug Description: A limitation inside Nuke means changes to frame ranges for a
clip file in a read node still brings in the full range to Mocha.
69
Workaround: Use a sequence or apply a FrameRange node upstream of
the Mocha instance.
70
Product: All Products
Bug Description: Pasted layer shape data to Fusion has blank or incorrect
layer name if Mocha layer contains non-Latin characters
Workaround: Rename layer with Latin-1 characters.
71
Workaround: Apply directly to the clip.
Issue: MO-8179 Point insertion tool reverts back to pick tool after
zooming or moving
Platform: All Platforms
Product: All Products
Bug Description: If you zoom or pan using toggles, the point insertion tools
returns to the Pick tool.
Workaround: None.
Issue: MO-8172 Link to track data not copied over multiple effect
instances
Platform: All Platforms
Product: All Plug-Ins
Bug Description: Copying an effect does not copy over layer property "Link to
track" in the Mocha project.
Workaround: Relink the layers.
72
Issue: MO-8147 No warning if clip is timestretch/timeremapped
changed from initial track in Plug-In
Platform: All Platforms
Product: All Plug-Ins
Bug Description: If the user changes a video track, the Plug-In should warn
the user they need to retrack.
Workaround: None.
Issue: MO-8093 Zoom windows show whole clip image for the
cropped clip
Platform: All Platforms
Product: All Products
Bug Description: You can see the whole clip image in Zoom windows even if
they are cropped.
Workaround: None.
Issue: MO-8089 GPU tracking isn’t stopped when the object is out
of the image
Platform: All Platforms
Product: All Products
Bug Description: GPU keeps on tracking if the layer goes out of the image.
Workaround: Stop manually.
73
Platform: All Platforms
Product: All Products
Bug Description: Using a tablet can sometimes effect manual adjustment of
the surface
Workaround: Use a mouse instead.
74
Platform: All Platforms
Product: All Products
Bug Description: A high-depth clip showing in the viewer stops support for
some images when exporting to Export Rendered Shapes
Workaround: Switch clips in the viewer.
75
Platform: All platforms
Product: All Products
Bug Description: The lasso and marquee selection tools should be in the Tools
section of the Key shortcuts dialog.
Workaround: None
76
Platform: All Platforms
Product: All Products
Bug Description: If you rename the layer while viewing a matte clip, the view
changes back to "Selected layer"
Workaround: Reselect the matte clip from the clip view options
77
Product: All Products
Bug Description: If you track frames then add manual track keyframes with a
tablet pen, the other frames offset.
Workaround: If you use a mouse it behaves normally.
Issue: MO-7881 No insert preview on any other clip other than the
original clip
Platform: All Platforms
Product: All Products
Bug Description: When a layer has an insert clip, you are unable to view it
unless you are viewing the original tracking input clip on the
canvas.
Workaround: Switch to tracking input clip in the viewer.
78
Product: All Products
Bug Description: When switching between different views using CMD+1,
CMD+2, CMD+3 buttons, the currently viewed area changes.
Workaround: None
79
Product: All Products
Bug Description: Using the '{' and '}' keys to step over points will delete the
layer if you try to delete the single point.
Workaround: Select the point without stepping first.
80
Product: Mocha Pro Standalone, Mocha VR Standalone
Bug Description: Tracking data is recalculated incorrectly when changing the
PAR via Python.
Workaround: None
Issue: MO-7688 Render cache files are not removed after closing a
project without retain cache renders
Platform: All Platforms
Product: All Products
Bug Description: Unchecking "Retain Cached Renders" when closing a project
does not clear the cache.
Workaround: Use the cache clearing tools in the file menu or delete
manually.
81
Bug Description: Layers inside groups have sporadic ability to change radio
buttons and check boxes
Workaround: Pull layers out of group
82
Workaround: None
83
Workaround: None
84
Workaround: Use a shorter name.
85
Issue: MO-7429 Cannot detect and move spline points if they are
located near spline line of another spline in the same layer
Platform: All Platforms
Product: All Products
Bug Description: Points that are close to other splines are hard to select and
move.
Workaround: Zoom in further to make selection easier.
86
Workaround: Reset the AdjustTrack solution and try again.
87
Workaround: Use standard unicode characters and avoid some symbols
like / or %.
Issue: MO-7348 There are two "Matte for a layer" clips for the
same layer after reselecting None as a Matte clip for it
Platform: All Platforms
Product: All Products
Bug Description: Selecting "None" in the Matte clip dropdown for a layer adds
a new layer matte clip if you add another contour.
Workaround: None
Issue: MO-7343 Error when trying to paste spline data in the Dope
Sheet
Platform: All Platforms
Product: All Products
Bug Description: If you have spline data on the clipboard and try to paste to
the dopesheet, there is an error.
Workaround: Copy keyframes first.
88
Issue: MO-7326 Removing "activate/deactivate" layer keyframe
doesn’t update layer state on the canvas
Platform: All Platforms
Product: All Products
Bug Description: The canvas doesn’t refresh after removing activate or
deactivate keyframes from a layer.
Workaround: Move mouse cursor to the canvas or switch between frames
89
Issue: MO-7275 Frame Offset returns to default Fixed Frame after
entering negative value and moving focus between clip
frame range fields
Platform: All Platforms
Product: All Products
Bug Description: Inserting a negative frame offset in the New Project dialog
can set the wrong offset.
Workaround: Change the offset after the project is created.
Issue: MO-7264 Frame offset field does not switch between frames
and timecode
Platform: All Platforms
Product: All Products
Bug Description: Turning on "Timecode" for the frame offset view in the Clip
tab does not update the frame offset field to timecode.
Workaround: None
90
Issue: MO-7256 Cleanplate clips are created with source sequence
filename extension rather than TIF/DPX
Platform: All Platforms
Product: All Products
Bug Description: Clean plates should be written as the default Results format
(TIF or DPX), not the source format.
Workaround: None
91
Issue: MO-7250 There is ability to nudge shapes during tracking
process
Platform: All Platforms
Product: All Products
Bug Description: Shape nudging shortcuts are not disabled while tracking.
Workaround: None
Issue: MO-7228 Wrong exported tracking data for Fusion format for
interlaced projects
Platform: All Platforms
Product: All Products
Bug Description: Exports to Blackmagic Fusion based on interlaced footage
have the wrong height and y scale.
Workaround: None
Issue: MO-7211 Edge is shown for open splines that were made
from closed splines
Platform: All Platforms
Product: All Products
Bug Description: If you created an edge for a closed spline, then open it the
edge for the close spine still shows.
Workaround: Reset edge with before opening spline.
92
Platform: All Platforms
Product: All Products
Bug Description: You can use the "Next control point" controls to cycle
through locked or invisible layers.
Workaround: None
Issue: MO-7179 Video gamma for Log colorspace remains from the
previous project
Platform: All Platforms
Product: All Products
Bug Description: Video gamma does not reset for log color space when
starting a new project.
Workaround: Restart Mocha before beginning a new project.
93
Platform: All Platforms
Product: All Products
Bug Description: Multiple changes to different layers then undoing them can
cause problems with some layers.
Workaround: None
94
Platform: All Platforms
Product: All Products
Bug Description: A low accuracy warning can show after the Save dialog when
exporting camera solve data.
Workaround: None
95
Issue: MO-7135 Mocha cannot load some video files that could be
loaded by earlier versions.
Platform: macOS and Windows: all
Product: All Products
Bug Description: Some codecs that were supported in earlier versions of
Mocha are now showing as unsupported.
Workaround: Convert the footage to a different format.
Issue: MO-7116 Extra step in undo/redo history after using Set and
+/- edge width actions
Platform: All Platforms
Product: All Products
Bug Description: An additional undo step is created when performing edge
width operations.
96
Workaround: None
Issue: MO-7098 GUI isn’t updated correctly for a layer that was
created with Python
Platform: All Platforms
Product: Mocha Pro Standalone, Mocha VR Standalone
Bug Description: Creating or modifying a layer in Python while in the Mocha
GUI will not immediately update the view or layer controls.
97
Workaround: Perform another action such as layer selection in the GUI or
switch out and back to the application.
98
Bug Description: In stereo shots, "Apply keyframe changes to all views" can
sometimes not work across views with Überkey.
Workaround: None
Issue: MO-7068 Layer in/out point fields are too narrow when
working with timecodes
Platform: All Platforms
Product: All Products
Bug Description: Layer in/out point fields are too narrow when working with
timecodes so they become hard to see.
Workaround: Stretch the left panel out further.
99
Bug Description: Attempting to stabilize with an open spline layer will throw an
error.
Workaround: Use a close spline layer.
100
Bug Description: The prefix for export rendered shapes chooses the top layer
rather than the selected layer.
Workaround: Change the prefix manually.
101
Bug Description: Switching between Relative and Absolute paths doesn’t save
the Absolute path.
Workaround: None
102
Product: Mocha Pro Standalone, Mocha VR Standalone
Bug Description: If you set a right clip to a smaller frame range than the left in
Python, an error occurs rather than repeating the frame.
Workaround: None
103
Bug Description: If you change the hero view of a layer and try to change its
stereo offset parameters nothing happens.
Workaround: None
Issue: MO-6661 Some MOV clips load without the last frame
Platform: macOS and Windows: all
Product: All Products
Bug Description: If you load some QuickTime files they will import missing the
last frame
Workaround: Convert the QuickTime to an image sequence and import
that instead.
Issue: MO-6601 Extra points are moved on the right view in moving
some point if "Apply keyframes changes to all views" is
switched on
Platform: All Platforms
Product: All Products
Bug Description: Extra points are moved on the right view in moving some
point if "Apply keyframes changes to all views" is switched
on
Workaround: None
Issue: MO-6543 The last selected kind of footage isn’t saved in the
Export Rendered Shapes/Clip dialogs in Mocha
Platform: macOS and Windows: all
Product: All Products
104
Bug Description: The last selected kind of footage isn’t saved in the Export
Rendered Shapes/Clip dialogs
Workaround: None
Issue: MO-6540 Render Mattes settings are not saved in the Export
Rendered Shapes dialog in Mocha
Platform: All Platforms
Product: All Products
Bug Description: Render Mattes settings are not saved in the Export Rendered
Shapes dialog in Mocha
Workaround: None
105
Workaround: Delete the rendered clips from the clip tab
106
Workaround: None
Issue: MO-5995 Canvas errors jump when zooming into the canvas
Platform: All Platforms
Product: All Products
Bug Description: Zooming in when there is an error message on the canvas
will cause it to jump.
Workaround: None
107
Workaround: None
108
Workaround: None
109
Issue: MO-5828 File name in the "Save shape data as…" dialog is
empty if a selected layer has the same name as any folder in
the last selected directory
Platform: All Platforms
Product: All Products
Bug Description: If your layer name matches the folder you save your data to,
then the filename field will be empty when you go to save
shape data.
Workaround: Rename the folder or layer, or just type a new name.
Issue: MO-5750 Pan and Zoom keys don’t work when tracking
Platform: All Platforms
Product: All Products
Bug Description: When tracking you can’t pan or zoom in the view.
Workaround: None
110
Issue: MO-5728 Wrong height for interlaced .mov footage
Platform: Windows and macOS
Product: All Products
Bug Description: The clip height is listed wrong in the Clip page for interlaced
QuickTime footage.
Workaround: None
Issue: MO-5722 Wrong data in the first frame in After Effects after
importing camera data from an interlaced project.
Platform: All Platforms
Product: All Products
Bug Description: Nulls based on the surface corners don’t have the same
place in AE as they do in Mocha at the first frame when using
interlaced footage.
Workaround: Use progressive footage.
111
Issue: MO-5720 An extra error message is shown if unable to
create a project file
Platform: All Platforms
Product: All Products
Bug Description: There are two messages shown instead of one when a
project file cannot be created.
Workaround: None
112
Issue: MO-5624 Sometimes the Welcome Screen doesn’t contain
information about a license error
Platform: All Platforms
Product: All Products
Bug Description: Sometimes reopening Mocha when it has a broken license
will not show the license error, only the LE mode message.
Workaround: None
Issue: MO-5452 Creating a clean plate with a file that has a number
on the end will append the number directly
Platform: All Platforms
Product: All Products
Bug Description: Creating a clean plate with a file that has a number on the
end does not separate the number of the clean plate frame
from the number in the file.
Workaround: Rename footage so it does not contain numbers other than
sequence numbers.
113
Bug Description: The bounding box isn’t shown for multiple selected layers if
the first one clicked is out of range
Workaround: None
114
Bug Description: If you rename a layout it does not change the name in the
menu.
Workaround: Restart Mocha. The names will be updated.
115
Bug Description: Sometimes using AdjustTrack on a surface will not adjust the
spline as well.
Workaround: None
116
Bug Description: If you select 2 layers and try to use the point insertion tool
you get the error: "Error: Could not find parent contour of the
point."
Workaround: Add points to one layer at a time
Issue: MO-190 "Pick Edge" tool selects and moves both Inner and
Outer Spline Points
Platform: All Platforms
Product: All Products
Bug Description: "Pick Edge" tool selects and moves both Inner and Outer
Spline points if you first move the outer point.
Workaround: Reselect.
117
Issue: MO-180 Stereoscopic options are enabled when
equirectangular lens is enabled
Platform: All Platforms
Product: Mocha VR
Bug Description: Stereoscopic options should be disabled when
Equirectangular lens is enabled in Mocha VR Standalone.
Workaround: None. Stereo for Equirectangular footage is not yet
supported in Mocha VR.
118
Bug Description: The "Reset" button in the Source Tab of the Insert Module
will not reset cropped inserts correctly in Mocha VR and Pro
Workaround: None.
Issue: MO-166 Avid can hang when using the "Render Effect"
command with the Remove Module in Mocha VR AVX Plug-In
Platform: All Platforms
Product: Mocha VR AVX Plug-In
Bug Description: Media Composer can sometimes hang after clicking "Render
Effect" when rendering the Remove clip with the Mocha VR
AVX Plug-In.
Workaround: None.
119
Bug Description: the output tab is redundant in Reorient for the Plug-In
version of Mocha VR.
Workaround: None.
120
Workaround: Export the Mocha project from the Mocha GUI in the After
Effects effect and merge it into the Mocha project in the
Premiere version of the effect.
Issue: MO-7 Black frames in Mocha Pro UI when applying over BCC
and Sapphire effects in the Effect Editor in AVX
Platform: All Platforms
Product: Mocha Pro AVX Plug-In, Mocha VR AVX Plug-In
Bug Description: When Mocha AVX Plug-In is applied on top of a BCC or
Sapphire effect, one can only see black frames in the Viewer
window of the Mocha Pro UI.
Workaround: None.
Hardware Requirements
Recommended Hardware
• Processor: 3rd-generation Intel Core i7 or equivalent, Apple M1 arm64.
• Memory: 16+ GB
121
Minimal Requirements
• Processor: x86-64 or Apple M1 arm64.
• Memory: At least 4 GB
• Graphics Card: For GPU tracking, must support OpenCL 1.2, for CPU tracking,
OpenGL 2.1
• Linux: Red Hat Enterprise Linux 7-8, CentOS 7-8, or a compatible distribution
on x86_64.
• Mocha Plug-In for Adobe: Adobe After Effects & Premiere CC 2014-2024.
122
• Mocha Plug-In for OFX: Autodesk Flame 2020 to Flame 2024. The Foundry
Nuke 8-15. Fusion Studio 8-18.6. HitFilm Pro 2017 or higher. Silhouette 2020 or
higher. Vegas Pro 14-19.
Operating System
• Mac: macOS 10.15-14.4 on Intel or Apple silicon.
• Linux: Red Hat Enterprise Linux 7-9, CentOS 7-9, or a compatible Linux
distribution on x86_64.
2024 v11.0.0 can export tracking and shape data to a selection of third-party
visual effects software. These are the versions we have tested:
123
Application Version Track Shape Camera Comments
Adobe After 'CS3+' X X X Exporting
Effects Corner Pin
data to non-
English
versions of
After Effects
requires
CS4+. Shape
export
requires
Mocha shape
for After
Effects Plug-
In.
Adobe CC X
Premiere Pro '2014+'
Apple Final 6.0.5- X X Shape export
Cut Pro 7.0.3 requires
Mocha shape
for Final Cut
Plug-In.
Apple Final 4.0.1 X X Shape export
Cut Express requires
Mocha shape
for Final Cut
Plug-In.
Apple Shake 4.1 X X
Apple Motion '3.0.2+' X Shape export
can be done
via Final Cut
Assimilate '7.0+' X
SCRATCH
124
Application Version Track Shape Camera Comments
Autodesk 9.5+ X X Also known to
Flame work with
newer
releases
Autodesk 7.0+ X X Also known to
Smoke work with
newer
releases
Autodesk 3.0 X X
Combustion
Autodesk 2012 X
Maya
Avid DS 7.6 X Also known to
work with
v8.0 and
newer
Boris FX BCC X Tracking
Plug-Ins export
requires Boris
BCC Plug-In
that supports
importing of
tracking data.
Blackmagic 5.0-18.6 X X X
Fusion
Blender 3.0-4.0 X X
125
Application Version Track Shape Camera Comments
FXhome '2.0+' X X X Shape export
HitFilm is available
for HitFilm 3
Pro and
above. Track
export is
available for
HitFilm 4 Pro
and above.
VEGAS 19.0+ X X Note the
shape data is
not fully
supported.
Shapes come
in as bezier
masks, but
only up to 5
at a time.
Maxon '13.0+' X Exports to the
Cinema 4D MochaBlend
Plug-In also
support
tracking and
shape data to
C4D
Quantel eQ, 4.2 X Requires
iQ, etc. Mocha Track
for Quantel
Plug-In,
available free
from
borisfx.com
Silhouette 5.0+ X
126
Application Version Track Shape Camera Comments
The Foundry '6.0+' X X 6.3v7+ Data Export
Nuke panel only
compatible
with Nuke 13-
15.
SGO Mistika 10.2+ X
These are the versions we have tested as official supported for exporting data:
127
Application Version Track Shape Camera Comments
Autodesk 9.5+ X
Flame
Autodesk 7.0+ X
Smoke
Autodesk 3.0
Combustion
Autodesk 2012
Maya
Avid DS 7.6
Boris FX BCC
Plug-Ins
Blackmagic 5.0X
Fusion
FXhome '2.0+'
HitFilm
Maxon '13.0+'
Cinema 4D
Quantel eQ, 4.2
iQ, etc.
Silhouette 5.0+ X (in X VR Shape
2020. exports are
0.1) supported via
ssf
The Foundry '6.0+' X
Nuke
Community-supplied importers are known to work but are not supported by Boris
FX.
128
Windows
1. Once the installation file, Mochapro2024-xxxx.exe, has been downloaded onto
the system, double click the file to begin installation
macOS
1. Once the installation file, Mochapro2024-xxxx.dmg, has been downloaded
onto the system double click the application this will open a new window
2. Drag the 2024 v11.0.0 application bundle to the folder where Mocha will be
installed. The conventional place to install applications is in the ‘Applications’
folder on Macintosh HD.
Linux
1. Once the installation file, Mochapro2024-xxxx.x86_64.rpm, has been
downloaded, change into the directory you saved it into. Note that the ‘x’ in the
file name is substituted by the current build number.
2. Install the package with the command: sudo rpm –Uvh Mochapro2024-
xxxx.rpm or see the man page for your favorite package manager.
3. Installing via rpm may prompt you to install additional dependencies, such as
compat-glibc or xrandr. If these are required, download and install them using
the appropriate method for your distribution, for example ‘yum’ or ‘up2date’.
2. Install the package with the command: sudo rpm -Uvh --nodeps
Mochapro2024....rpm or see the man page for your favorite package manager.
129
Linux dependencies
libxkbcommon-x11
This is a requirement for Mocha to launch on Linux successfully. This is not always
installed on the system, so may need to be installed manually, for example using
the command: sudo yum install libxkbcommon-x11
mesa-libGLU
macOS
1. Once the installation file, (e.g 'MochaPro[Plug-InType]-mac-xxxx.dmg'), has
been downloaded onto the system double click the DMG and his will open a
new window
2. Double-click the MochaPro Plug-In .pkg inside and follow the on-screen
instructions
Linux
1. Once the installation file, (e.g 'MochaPro[Plug-InType]-rhel-xxxx.rpm'), has
been downloaded onto the system, double click the RPM
2. Install the package with the command sudo yum install MochaProOFX-*.rpm or
see the man page for your favorite package manager.
130
Linux dependencies
libxkbcommon-x11
This is a requirement for Mocha to launch on Linux successfully. This is not always
installed on the system, so may need to be installed manually, for example using
the command: sudo yum install libxkbcommon-x11
mesa-libGLU
131