mayaMatchMoveSolver-v0.4.0.alpha5

DO NOT USE THIS IN PRODUCTION!!!
This version of mmSolver is for testing only!

This is a feature incomplete and buggy release of the upcoming v0.4.0 release of mmSolver.

The alpha 5 release improves the mmSolver image plane (mmImagePlane) by ensuring a new shape node to control the display of the textured image plane in wireframe and shaded modes.

To help the mmSolver image plane workflow a Camera Node Context has been added to the shelf (button "NdCtx") which will dynamically provide access to the active camera, image planes and lens distortion "layers" - including common options.

---

Load mmSolver in Maya 2022

To load mmSolver on Maya 2022 you must run the following MEL command:

mmsolver_load

This will load the mmSolver plug-in, and allow you to automatically load the mmSolver plug-in and will ensure it is loaded each time Maya is started.

If you wish to unload mmSolver so it will not be loaded at Maya start-up run the following MEL command:

mmsolver_unload

These new commands were added to work-around the new Maya 2022+ Security preferences and ensure mmSolver will be loaded when it's needed.

Additionally the Python module mmSolver.startup was added, and allows pipelines to manually load mmSolver with the Python commands:

import mmSolver.startup
mmSolver.startup.mmsolver_startup()

---

Features / Changes

The main changes in this release:

• (#106) Bug fixes and minor performance improvements.
  • Add more 3DEqualizer lens distortion models onto a node mmLensModel3de.
    • 3DE Classic
    • 3DE4 Radial Degree 4
    • 3DE4 Anamorphic Degree 4
    • Multiple lens models are dynamically set with mmLensModel3de node.
  • Disabled lenses are ignored by the solver.
  • Ignore lens models when lens distortion disabled on a camera.
  • Added 'Pass-through' lens model nodes (mmLensModelPassthrough)
• (#173) Add proper mmImagePlane shape node.
  • Add mmImagePlaneShape with better display
  • Add HUD to the image plane with resolution, pixel aspect ratio and image aspect ratio.
  • The NdCtx shelf button provides a dynamic menu to improve workflow and find nodes easily.
  • Add file browser to prompt user for image sequence.
  • Enable image sequence caching by default.
• An installation issue on Linux was (manually) fixed for this release in the provided Linux binaries.
  • Deleted ./lib/libcminpack.so.1.
  • Rename ./lib/libcminpack.so.1.3.6 to ./lib/libcminpack.so.1.

Developer (low-level) changes:

• Add mmLensModelBasic node was removed.
• Add mmReadImage to query image resolution.
• Moved some dynamic attributes on mmImagePlaneTransform to mmImagePlaneShape.
• Add mmSolver.api.Lens.get/set_enable() methods.
• Add methods to get/set connected nodes for mmSolver.api.Lens()

---

Known Problems

• Possible Linux install problems libcminpack.so.1: cannot open shared object file: No such file or directory
  • Rename file ./lib/libcminpack.so.1.3.6 to ./lib/libcminpack.so.1 in the installation directory.
• If MM Scene Graph detects an incompatible solve it will error, but will result in a broken Maya session (restart Maya to fix the issue).
  • This will be addressed in the next alpha release.
• The Solver acts strangely and doesn't solve correctly when the camera's "Film Fit" is set to anything other than "Horizontal".
• Compatibility with Maya scenes with mmSolver v0.3.x nodes may not work as expected - please report issues.
• The Viewport 2 "MM Renderer"
  • Aliasing problems and does not allow changing the "mode" of the viewport.
  • The mmImagePlaneShape does not work the same as Maya native image planes with the useBackground/hold out options in Viewport 2.0.
• Marker shape nodes change size when the marker depth or camera focal length is adjusted.

---

Please report any bugs or suggestions you find in this release here and clearly state the version of mmSolver you are testing.